TestResultListener

public abstract class TestResultListener
extends Object implements ITestLifeCycleReceiver

java.lang.Object
   ↳ com.android.tradefed.result.TestResultListener


針對只關心個別測試的實作者,簡化 ITestLifecycleListener 也就是預測結果

該類別會將各種生命週期事件篩選至 testResult 方法。

這「不是」執行緒安全,特別是 ITestLifecycleListener 事件 。

摘要

公用建構函式

TestResultListener()

公用方法

final void testAssumptionFailure(TestDescription test, String trace)

在不可部分完成的測試旗標假設條件為 false 時呼叫

final void testEnded(TestDescription test, testMetrics)

回報個別測試案例的執行結束時間。

final void testEnded(TestDescription test, long endTime, testMetrics)

ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) 的替代方式,可以指定結束時間

final void testFailed(TestDescription test, String trace)

回報個別測試案例的失敗情形。

final void testIgnored(TestDescription test)

在測試不執行時呼叫的呼叫,通常是因為測試方法加上了 org.junit.Ignore

abstract void testResult(TestDescription test, TestResult result)
void testRunEnded(long elapsedTimeMillis, runMetrics)

測試執行結束報表。

void testSkipped(TestDescription test, SkipReason reason)

測試被略過,且因非預期原因而未執行時呼叫。

final void testStarted(TestDescription test, long startTime)

testStarted(com.android.tradefed.result.TestDescription) 的替代方式,我們會一併指定測試的時間 再加上 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)),才能取得準確的測量結果

final void testStarted(TestDescription test)

回報個別測試案例的開頭。

公用建構函式

TestResultListener

public TestResultListener ()

公用方法

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

在不可部分完成的測試旗標假設條件為 false 時呼叫

參數
test TestDescription:識別測試

trace String:失敗的堆疊追蹤

測試結束

public final void testEnded (TestDescription test, 
                 testMetrics)

回報個別測試案例的執行結束時間。

如果未叫用 testFailed(TestDescription, FailureDescription),這項測試就會通過。同時傳回任何鍵/值 指標,這些是在測試案例執行期間產生的指標。

參數
test TestDescription:識別測試

testMetrics :發送的指標的 ERROR(/Map)

測試結束

public final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) 的替代方式,可以指定結束時間 搭配 testStarted(com.android.tradefed.result.TestDescription, long) 即可取得準確的測量結果。

參數
test TestDescription:識別測試

endTime long:測試結束的時間,透過 System.currentTimeMillis() 進行評估

testMetrics :發送的指標的 ERROR(/Map)

測試失敗

public final void testFailed (TestDescription test, 
                String trace)

回報個別測試案例的失敗情形。

這個值會在 testStarted 和 testEnded 之間呼叫。

參數
test TestDescription:識別測試

trace String:失敗的堆疊追蹤

已忽略測試

public final void testIgnored (TestDescription test)

在測試不執行時呼叫的呼叫,通常是因為測試方法加上了 org.junit.Ignore

參數
test TestDescription:識別測試

testResult

public abstract void testResult (TestDescription test, 
                TestResult result)

參數
test TestDescription

result TestResult

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

測試執行結束報表。FIXME:我們不能有兩張地圖<>產生不同類型的介面 我們一定要在這裡使用 HashMap

參數
elapsedTimeMillis long:裝置回報的經過時間 (以毫秒為單位)

runMetrics :使用 Metric 的測試執行結束時回報的鍵/值組合。

測試略過

public void testSkipped (TestDescription test, 
                SkipReason reason)

測試被略過,且因非預期原因而未執行時呼叫。 系統會嘗試重新嘗試這些測試,以便執行正確的作業。

參數
test TestDescription:識別測試

reason SkipReasonSkipReason

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

testStarted(com.android.tradefed.result.TestDescription) 的替代方式,我們會一併指定測試的時間 再加上 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)),才能取得準確的測量結果

參數
test TestDescription:識別測試

startTime long:測試開始的時間,透過 System.currentTimeMillis() 進行測量

testStarted

public final void testStarted (TestDescription test)

回報個別測試案例的開頭。舊版介面,應盡可能使用 testStarted(com.android.tradefed.result.TestDescription)

參數
test TestDescription:識別測試