模組監聽器
public class ModuleListener
extends CollectingTestListener
java.lang.Object | ||
↳ | com.android.tradefed.result.CollectingTestListener | |
↳ | com.android.tradefed.testtype.suite.ModuleListener |
偵聽器附加到每個模組的每個IRemoteTest
以收集結果清單。
概括
公共構造函數 | |
---|---|
ModuleListener ( ITestInvocationListener listener, IInvocationContext moduleContext) 構造函數。 |
公共方法 | |
---|---|
boolean | hasLastAttemptFailed () 傳回偵聽器上次重試會話是否失敗。 |
void | logAssociation (String dataName, LogFile logFile) 在某些情況下,日誌必須與測試案例強關聯,但有機會這樣做就直接 |
void | setAttemptIsolation ( CurrentInvocation.IsolationGrade isolation) 設定是否應將嘗試報告為孤立的。 |
void | setCollectTestsOnly (boolean collectTestsOnly) 設定我們是否只收集測試。 |
void | setMarkTestsSkipped (boolean skip) 是否將所有測試案例標記為跳過。 |
void | setTestMappingSources ( testMappingSources) setTestMappingSources ( testMappingSources) 設定將插入到指標中的測試映射來源。 |
void | testAssumptionFailure ( TestDescription test, String trace) 當原子測試標記其假定條件為 false 時調用 |
void | testAssumptionFailure ( TestDescription test, FailureDescription failure) 當原子測試標記其假定條件為 false 時調用 |
void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) 報告單一測試案例的執行結束。 |
void | testFailed ( TestDescription test, FailureDescription failure) 報告單一測試用例的失敗。 |
void | testFailed ( TestDescription test, String trace) 報告單一測試用例的失敗。 |
void | testIgnored ( TestDescription test) 當測試不會運行時調用,通常是因為測試方法用 org.junit.Ignore 註解。 |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) |
void | testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) 報告測試運行結束。 |
void | testRunFailed ( FailureDescription failure) 報告測試運行由於 |
void | testRunFailed (String errorMessage) 報告測試運行因致命錯誤而未能完成。 |
void | testRunStarted (String name, int numTests, int attemptNumber) 報告測試運行的開始。 |
void | testRunStarted (String name, int numTests, int attemptNumber, long startTime) 報告測試運行的開始。 |
void | testStarted ( TestDescription test, long startTime) |
公共構造函數
模組監聽器
public ModuleListener (ITestInvocationListener listener, IInvocationContext moduleContext)
構造函數。
參數 | |
---|---|
listener | ITestInvocationListener |
moduleContext | IInvocationContext |
公共方法
上次嘗試失敗
public boolean hasLastAttemptFailed ()
傳回偵聽器上次重試會話是否失敗。
退貨 | |
---|---|
boolean |
日誌關聯
public void logAssociation (String dataName, LogFile logFile)
在某些情況下,日誌必須與測試案例強關聯,但有機會這樣做就直接testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
回呼是不可能的。因此,此回調允許明確提供強關聯。
參數 | |
---|---|
dataName | String : 資料的名稱 |
logFile | LogFile :先前記錄的LogFile ,應與測試案例關聯。 |
設定嘗試隔離
public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)
設定是否應將嘗試報告為孤立的。
參數 | |
---|---|
isolation | CurrentInvocation.IsolationGrade |
僅設定收集測試
public void setCollectTestsOnly (boolean collectTestsOnly)
設定我們是否只收集測試。
參數 | |
---|---|
collectTestsOnly | boolean |
設定跳過的標記測試
public void setMarkTestsSkipped (boolean skip)
是否將所有測試案例標記為跳過。
參數 | |
---|---|
skip | boolean |
設定測試映射來源
public void setTestMappingSources (testMappingSources)
設定將插入到指標中的測試映射來源。
參數 | |
---|---|
testMappingSources |
測試假設失敗
public void testAssumptionFailure (TestDescription test, String trace)
當原子測試標記其假定條件為 false 時調用
參數 | |
---|---|
test | TestDescription :標識測試 |
trace | String : 失敗的堆疊追蹤 |
測試假設失敗
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
當原子測試標記其假定條件為 false 時調用
參數 | |
---|---|
test | TestDescription :標識測試 |
failure | FailureDescription :描述故障及其上下文的FailureDescription 。 |
測試結束
public 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 void testEnded (TestDescription test,testMetrics)
報告單一測試案例的執行結束。
如果未呼叫testFailed(TestDescription, FailureDescription)
,則此測試通過。也會傳回測試案例執行期間可能發出的任何鍵/值指標。
參數 | |
---|---|
test | TestDescription :標識測試 |
testMetrics | ERROR(/Map) |
測試失敗
public void testFailed (TestDescription test, FailureDescription failure)
報告單一測試用例的失敗。
將在 testStarted 和 testEnded 之間呼叫。
參數 | |
---|---|
test | TestDescription :標識測試 |
failure | FailureDescription :描述故障及其上下文的FailureDescription 。 |
測試失敗
public void testFailed (TestDescription test, String trace)
報告單一測試用例的失敗。
將在 testStarted 和 testEnded 之間呼叫。
參數 | |
---|---|
test | TestDescription :標識測試 |
trace | String : 失敗的堆疊追蹤 |
測試被忽略
public void testIgnored (TestDescription test)
當測試不會運行時調用,通常是因為測試方法用 org.junit.Ignore 註解。
參數 | |
---|---|
test | TestDescription :標識測試 |
測試日誌
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
參數 | |
---|---|
dataName | String |
dataType | LogDataType |
dataStream | InputStreamSource |
測試日誌已儲存
public void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
參數 | |
---|---|
dataName | String |
dataType | LogDataType |
dataStream | InputStreamSource |
logFile | LogFile |
測試運行結束
public void testRunEnded (long elapsedTime,runMetrics)
報告測試運行結束。 FIXME:我們不能有兩個不同類型的 Map<> 接口,所以我們必須在這裡使用 HashMap。
參數 | |
---|---|
elapsedTime | long :設備報告的經過時間,以毫秒為單位 |
runMetrics | Metric 測試運行結束時報告的鍵值對。 |
測試運行失敗
public void testRunFailed (FailureDescription failure)
報告測試運行由於FailureDescription
描述的故障而未能完成。
參數 | |
---|---|
failure | FailureDescription :描述故障及其上下文的FailureDescription 。 |
測試運行失敗
public void testRunFailed (String errorMessage)
報告測試運行因致命錯誤而未能完成。
參數 | |
---|---|
errorMessage | String :描述運行失敗原因的String 。 |
測試運行開始
public void testRunStarted (String name, int numTests, int attemptNumber)
報告測試運行的開始。
參數 | |
---|---|
name | String : 測試運行名稱 |
numTests | int : 測試運行中的測試總數 |
attemptNumber | int :訂單編號,標識相同 runName 多次執行的不同嘗試。 attemptsNumber 是從 0 開始索引的,並且每次新的運行發生時都應該遞增。例如,一個測試被粒度重試 3 次,它應該在同一 runName 下總共運行 4 次,並且 attemptsNumber 從 0 到 3。 |
測試運行開始
public void testRunStarted (String name, int numTests, int attemptNumber, long startTime)
報告測試運行的開始。
參數 | |
---|---|
name | String : 測試運行名稱 |
numTests | int : 測試運行中的測試總數 |
attemptNumber | int :訂單編號,標識相同 runName 多次執行的不同嘗試。 attemptsNumber 是從 0 開始索引的,並且每次新的運行發生時都應該遞增。例如,一個測試被粒度重試 3 次,它應該在同一 runName 下總共運行 4 次,並且 attemptsNumber 從 0 到 3。 |
startTime | long :運行開始的時間,透過System.currentTimeMillis() 測量 |
測試開始
public 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() 測量 |