收集測試監聽器

public class CollectingTestListener
extends Object implements ITestInvocationListener, ILogSaverListener

對象
com.android.tradefed.result.CollectingTestListener


一個ITestInvocationListener將收集所有的測試結果。

雖然在此對象使用的數據結構是線程安全的, ITestInvocationListener回調必須以正確的順序被調用。

概括

公共構造函數

CollectingTestListener ()

公共方法

IBuildInfo getBuildInfo ()

此方法已棄用。依靠IBuildInfogetInvocationContext()

TestRunResult getCurrentRunResults ()

獲取當前測試運行的結果。

int getExpectedTests ()

返回預期測試計數的數量。

IInvocationContext getInvocationContext ()

返回已通過報導調用上下文invocationStarted(com.android.tradefed.invoker.IInvocationContext)

getMergedTestRunResults ()

返回不同嘗試中所有運行的合併結果集合。

IInvocationContext getModuleContextForRunResult (String testRunName)

返回IInvocationContext與結果相關的模塊。

MultiMap<String, LogFile> getModuleLogFiles ()

返回包含與模塊關聯的所有記錄文件的地圖副本

MultiMap<String, LogFile> getNonAssociatedLogFiles ()

返回包含與測試運行或模塊無關的所有記錄文件的映射副本。

int getNumAllFailedTestRuns ()

返回處於失敗狀態的測試運行總數

int getNumAllFailedTests ()

返回處於失敗狀態的測試總數(僅失敗,假設失敗不計入)。

int getNumTestsInState (TestResult.TestStatus status)

返回此運行在給定狀態下的測試數量。

int getNumTotalTests ()

返回所有運行的完整測試總數。

IBuildInfo getPrimaryBuildInfo ()

返回已通過報告的主要構建信息invocationStarted(com.android.tradefed.invoker.IInvocationContext)

getRunResults ()

此方法已棄用。使用getMergedTestRunResults()

TestRunResult getTestRunAtAttempt (String testRunName, int attempt)

返回TestRunResult的一次嘗試。

int getTestRunAttemptCount (String testRunName)

返回給定測試運行名稱的嘗試次數。

getTestRunAttempts (String testRunName)

獲取的所有嘗試TestRunResult給定的測試運行。

getTestRunForAttempts (int attempt)

獲取給定嘗試的所有結果。

getTestRunNames ()

返回所有測試運行的所有名稱。

boolean hasFailedTests ()

返回調用是否有任何失敗或假設失敗的測試。

boolean hasTestRunResultsForName (String testRunName)

返回給定的測試運行名稱是否有任何結果。

void invocationEnded (long elapsedTime)

void invocationFailed (Throwable cause)

void invocationStarted (IInvocationContext context)

void logAssociation (String dataName, LogFile logFile)

void setBuildInfo (IBuildInfo buildInfo)

此方法已棄用。不再需要測試。

void setMergeStrategy (MergeStrategy strategy)

設置MergeStrategy合併結果時使用。

void testAssumptionFailure (TestDescription test, String trace)
void testAssumptionFailure (TestDescription test, FailureDescription failure)
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)
void testModuleEnded ()
void testModuleStarted (IInvocationContext moduleContext)
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)

void testRunStarted (String name, int numTests, int attemptNumber, long startTime)

void testRunStopped (long elapsedTime)

void testStarted (TestDescription test, long startTime)

void testStarted (TestDescription test)

受保護的方法

final void clearModuleLogFiles ()

允許清理模塊文件,因此我們避免攜帶它們太久。

final void clearResultsForName (String testRunName)

允許清除給定運行名稱的結果。

void setIsAggregrateMetrics (boolean aggregate)

切換“聚合指標”選項

公共構造函數

收集測試監聽器

public CollectingTestListener ()

公共方法

獲取構建信息

public IBuildInfo getBuildInfo ()

此方法已棄用。
依靠IBuildInfogetInvocationContext()

返回構建信息。

退貨
IBuildInfo

獲取當前運行結果

public TestRunResult getCurrentRunResults ()

獲取當前測試運行的結果。

請注意,結果可能不完整。它建議測試的值TestRunResult.isRunComplete()處理結果之前和/或(@link TestRunResult#isRunFailure()}為適當。

退貨
TestRunResultTestRunResult最後一次測試期間收集的數據代表

獲取預期測試

public int getExpectedTests ()

返回預期測試計數的數量。可以從不同getNumTotalTests()如果一些測試未運行。

退貨
int

獲取調用上下文

public IInvocationContext getInvocationContext ()

返回已通過報導調用上下文invocationStarted(com.android.tradefed.invoker.IInvocationContext)

退貨
IInvocationContext

獲取合併測試運行結果

public  getMergedTestRunResults ()

返回不同嘗試中所有運行的合併結果集合。

如果有多個結果,則合併每次測試運行,最新的測試結果覆蓋之前運行的測試結果。測試運行按嘗試次數排序。

對於相同的嘗試指標將基於偏好設定合併aggregate-metrics 。最終指標將是最後一次嘗試的指標。

退貨

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

返回IInvocationContext與結果相關的模塊。

參數
testRunName String :由{給出的名稱testRunStarted(String, int)

退貨
IInvocationContextIInvocationContext給定測試運行名稱模塊的null ,如果有該名稱沒有結果。

獲取模塊日誌文件

public MultiMap<String, LogFile> getModuleLogFiles ()

返回包含與模塊關聯的所有記錄文件的地圖副本

退貨
MultiMap<String, LogFile>

獲取非關聯日誌文件

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

返回包含與測試運行或模塊無關的所有記錄文件的映射副本。

退貨
MultiMap<String, LogFile>

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

返回處於失敗狀態的測試運行總數

退貨
int

getNumAllFailedTests

public int getNumAllFailedTests ()

返回處於失敗狀態的測試總數(僅失敗,假設失敗不計入)。

退貨
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus status)

返回此運行在給定狀態下的測試數量。

參數
status TestResult.TestStatus

退貨
int

getNumTotalTests

public int getNumTotalTests ()

返回所有運行的完整測試總數。

退貨
int

獲取主要構建信息

public IBuildInfo getPrimaryBuildInfo ()

返回已通過報告的主要構建信息invocationStarted(com.android.tradefed.invoker.IInvocationContext)主構建是由運行配置的第一個構建提供程序返回的構建。如果沒有上下文(沒有構建到測試用例),則返回 null。

退貨
IBuildInfo

獲取運行結果

public  getRunResults ()

此方法已棄用。
使用getMergedTestRunResults()

返回所有測試運行的結果。

退貨

獲取測試運行嘗試

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

返回TestRunResult的一次嘗試。

參數
testRunName String :由{給出的名稱testRunStarted(String, int)

attempt int :企圖ID。

退貨
TestRunResultTestRunResult對於給定的名稱和嘗試ID或null ,如果它不存在。

獲取測試運行嘗試計數

public int getTestRunAttemptCount (String testRunName)

返回給定測試運行名稱的嘗試次數。

參數
testRunName String :由{給出的名稱testRunStarted(String, int)

退貨
int

獲取測試運行嘗試

public  getTestRunAttempts (String testRunName)

獲取的所有嘗試TestRunResult給定的測試運行。

參數
testRunName String :由{給出的名稱testRunStarted(String, int)

退貨
所有TestRunResult對於給定的試運行,下令嘗試。

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

獲取給定嘗試的所有結果。

參數
attempt int :我們想要的結果的企圖。

退貨
所有TestRunResult對於一個給定的嘗試。

獲取測試運行名稱

public  getTestRunNames ()

返回所有測試運行的所有名稱。

這些測試運行可能以不同的嘗試運行了多次。

退貨

測試失敗

public boolean hasFailedTests ()

返回調用是否有任何失敗或假設失敗的測試。

退貨
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

返回給定的測試運行名稱是否有任何結果。

參數
testRunName String :由{給出的名稱testRunStarted(String, int)

退貨
boolean

調用結束

public void invocationEnded (long elapsedTime)

參數
elapsedTime long

調用失敗

public void invocationFailed (Throwable cause)

參數
cause Throwable

調用開始

public void invocationStarted (IInvocationContext context)

參數
context IInvocationContext

日誌關聯

public void logAssociation (String dataName, 
                LogFile logFile)

參數
dataName String

logFile LogFile

設置構建信息

public void setBuildInfo (IBuildInfo buildInfo)

此方法已棄用。
不再需要測試。

設置構建信息。應該只用於測試。

參數
buildInfo IBuildInfo

設置合併策略

public void setMergeStrategy (MergeStrategy strategy)

設置MergeStrategy合併結果時使用。

參數
strategy MergeStrategy

測試假設失敗

public void testAssumptionFailure (TestDescription test, 
                String trace)

參數
test TestDescription

trace String

測試假設失敗

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

參數
test TestDescription

failure FailureDescription

測試結束

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

參數
test TestDescription

endTime long

testMetrics

測試結束

public void testEnded (TestDescription test, 
                 testMetrics)

參數
test TestDescription

testMetrics

測試失敗

public void testFailed (TestDescription test, 
                FailureDescription failure)

參數
test TestDescription

failure FailureDescription

測試失敗

public void testFailed (TestDescription test, 
                String trace)

參數
test TestDescription

trace String

測試忽略

public void testIgnored (TestDescription test)

參數
test TestDescription

測試模塊結束

public void testModuleEnded ()

測試模塊啟動

public void testModuleStarted (IInvocationContext moduleContext)

參數
moduleContext IInvocationContext

測試運行結束

public void testRunEnded (long elapsedTime, 
                 runMetrics)

參數
elapsedTime long

runMetrics

測試運行失敗

public void testRunFailed (FailureDescription failure)

參數
failure FailureDescription

測試運行失敗

public void testRunFailed (String errorMessage)

參數
errorMessage String

測試運行開始

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

參數
name String

numTests int

attemptNumber int

測試運行開始

public void testRunStarted (String name, 
                int numTests)

參數
name String

numTests int

測試運行開始

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

參數
name String

numTests int

attemptNumber int

startTime long

測試運行停止

public void testRunStopped (long elapsedTime)

參數
elapsedTime long

測試開始

public void testStarted (TestDescription test, 
                long startTime)

參數
test TestDescription

startTime long

測試開始

public void testStarted (TestDescription test)

參數
test TestDescription

受保護的方法

清除模塊日誌文件

protected final void clearModuleLogFiles ()

允許清理模塊文件,因此我們避免攜帶它們太久。

清除結果名稱

protected final void clearResultsForName (String testRunName)

允許清除給定運行名稱的結果。只應在某些情況下使用,例如結果聚合器。

參數
testRunName String

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

切換“聚合指標”選項

參數
aggregate boolean