ResultReporter

public class ResultReporter
extends Object implements IConfigurationReceiver, ILogSaverListener, ISupportGranularResults, ITestSummaryListener

java.lang.Object
   ↳ com.google.android.tradefed.result.teststorage.ResultReporter

摘要

巢狀類別

class ResultReporter.ListBuilder<T>

 

常數

String DEFAULT_BUILDPROVIDER

String EXPERIMENTAL

String SYSTEM_CHECKER

String TRADEFED

公用建構函式

ResultReporter()

公用方法

void enableFilterProperty(boolean enableFilterProperty)
IConfiguration getConfiguration()
TestSummary getSummary()

允許 InvocationListener 傳回摘要。

void invocationEnded(long elapsedTime)

回報是否因某種錯誤狀況而終止呼叫 (無論是否成功)。
void invocationFailed(FailureDescription failure)

Reports an incomplete invocation due to some error condition.

void invocationFailed(Throwable cause)

Reports an incomplete invocation due to some error condition.

void invocationSkipped(SkipReason reason)

回報已略過的叫用

void invocationStarted(IInvocationContext context)

Reports the start of the test invocation.

void logAssociation(String dataName, LogFile log)

在某些情況下，記錄必須與測試案例密切相關，但無法在直接 testLogSaved(String,LogDataType,InputStreamSource,LogFile) 回呼中執行這項操作。

void putEarlySummary(List<TestSummary> summaries)

傳遞非空值的 TestSummary List，這些 TestSummary 可能已從任何 ITestInvocationListener 傳回，並在設定中例項化。

void reportLogToResultDB(List<LogAssociation> logAssociations, ResultDBReporter rdbReporter)
void setConfiguration(IConfiguration configuration)

注入使用的 IConfiguration。

void setLogSaver(ILogSaver logSaver)

設定 ILogSaver，允許實作者儲存檔案。

boolean supportGranularResults()

如果檢舉者支援精細結果，則傳回 True，否則傳回 False。

void testAssumptionFailure(TestDescription test, String trace)

當原子測試標記假設為 false 的條件時，系統會呼叫這個函式

void testAssumptionFailure(TestDescription test, FailureDescription failure)

當原子測試標記假設為 false 的條件時，系統會呼叫這個函式

void testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)

testEnded(TestDescription,Map) 的替代方案，可直接指定結束時間。

void testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> metrics)

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

void testFailed(TestDescription test, FailureDescription failure)

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

void testFailed(TestDescription test, String trace)

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

void testIgnored(TestDescription test)

當測試不會執行時呼叫，通常是因為測試方法以 org.junit.Ignore 註解標註。

void testModuleEnded()

回報模組執行作業的結束時間。

void testModuleStarted(IInvocationContext moduleContext)

回報模組的執行開始時間。

void testRunEnded(long elapsedTimeMillis, HashMap<String, MetricMeasurement.Metric> runMetrics)

Reports end of test run.

void testRunFailed(FailureDescription failure)

由於 FailureDescription 所述的錯誤，報表測試執行作業無法完成。

void testRunFailed(String errorMessage)

發生嚴重錯誤，因此無法完成報表測試執行。

void testRunStarted(String runName, int testCount, int attemptNumber)

回報測試執行的開始。

void testRunStarted(String runName, int testCount)

回報測試執行的開始。

void testRunStarted(String runName, int testCount, int attemptNumber, long startTime)

回報測試執行的開始。

void testSkipped(TestDescription test, SkipReason reason)

Called when a test is skipped and did not execute for a reason that is not usually expected.

void testStarted(TestDescription test, long startTime)

testStarted(TestDescription) 的替代方案，我們也會指定測試開始時間，並搭配 testEnded(TestDescription,long,Map) 進行準確的評估。

void testStarted(TestDescription test)

回報個別測試案例的開始時間。

受保護的方法

ITestStorageClient createTestStorageClient(IInvocationContext context)
String getVersion()

常數

DEFAULT_BUILDPROVIDER

public static final String DEFAULT_BUILDPROVIDER

常數值： "androidbuild"

實驗版

public static final String EXPERIMENTAL

常數值： "experimental"

SYSTEM_CHECKER

public static final String SYSTEM_CHECKER

常數值： "system_checker"

Tradefed

public static final String TRADEFED

常數值： "tradefed"

公用建構函式

ResultReporter

public ResultReporter ()

公用方法

enableFilterProperty

public void enableFilterProperty (boolean enableFilterProperty)

參數
enableFilterProperty boolean

getConfiguration

public IConfiguration getConfiguration ()

傳回
IConfiguration

getSummary

public TestSummary getSummary ()

允許 InvocationListener 傳回摘要。

傳回
TestSummary 總結執行作業的 TestSummary，或空值

invocationEnded

public void invocationEnded (long elapsedTime)

回報是否因某種錯誤情況而終止呼叫 (無論是否成功)。

TradeFederation 架構會自動呼叫。

參數
elapsedTime long：以毫秒為單位的呼叫經過時間

invocationFailed

public void invocationFailed (FailureDescription failure)

由於發生某些錯誤情況，因此回報不完整的叫用。

TradeFederation 架構會自動呼叫。

參數
failure FailureDescription：說明失敗原因的 FailureDescription

invocationFailed

public void invocationFailed (Throwable cause)

由於發生某些錯誤情況，因此回報不完整的叫用。

TradeFederation 架構會自動呼叫。

參數
cause Throwable：Throwable 失敗的原因

invocationSkipped

public void invocationSkipped (SkipReason reason)

將叫用回報為已略過

參數
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

回報測試呼叫的開始時間。

TradeFederation 架構會自動呼叫這個方法。檢舉者需要覆寫這個方法，才能支援多部裝置回報。

參數
context IInvocationContext：叫用相關資訊

logAssociation

public void logAssociation (String dataName, 
                LogFile log)

在某些情況下，記錄必須與測試案例密切相關，但無法在直接 testLogSaved(String,LogDataType,InputStreamSource,LogFile) 回呼中執行此操作。因此，這個回呼可明確提供強關聯。

參數
dataName String：資料名稱
log LogFile：先前記錄的 LogFile，應與測試案例建立關聯。

putEarlySummary

public void putEarlySummary (List<TestSummary> summaries)

傳遞非空值的 List TestSummary，這些 TestSummary 可能已從任何 ITestInvocationListener 傳回，並已例項化為設定的一部分。系統會在 invocationStarted(IInvocationContext) 後生成初步摘要，並在呼叫結束時透過 putSummary(List) 完成摘要。

這個方法會在 invocationStarted(IInvocationContext) 之前呼叫，並包含先前設定的接聽程式中的所有摘要。

參數
summaries List：來自 ITestInvocationListener 的非空值 TestSummary List，屬於目前設定的一部分。

reportLogToResultDB

public void reportLogToResultDB (List<LogAssociation> logAssociations, 
                ResultDBReporter rdbReporter)

參數
logAssociations List

rdbReporter ResultDBReporter

擲回
IOException

setConfiguration

public void setConfiguration (IConfiguration configuration)

注入使用的 IConfiguration。

參數
configuration IConfiguration

setLogSaver

public void setLogSaver (ILogSaver logSaver)

設定 ILogSaver，允許實作者儲存檔案。

參數
logSaver ILogSaver：ILogSaver

supportGranularResults

public boolean supportGranularResults ()

如果檢舉者支援精細結果，則傳回 True，否則傳回 False。

傳回
boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

當原子測試標記假設為 false 的條件時呼叫

參數
test TestDescription：識別測試
trace String：失敗的堆疊追蹤

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

當原子測試標記假設為 false 的條件時呼叫

參數
test TestDescription：識別測試
failure FailureDescription：說明失敗情形和相關情境的 FailureDescription。

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

testEnded(TestDescription,Map) 的替代方案，可直接指定結束時間。搭配 testStarted(TestDescription,long) 使用，可準確測量。

參數
test TestDescription：識別測試
endTime long：測試結束時間，透過 System.currentTimeMillis() 測量
testMetrics HashMap：發出的指標 Map

testEnded

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> metrics)

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

如果未叫用 testFailed(TestDescription, FailureDescription)，這項測試就會通過。也會傳回測試案例執行期間可能發出的任何鍵/值指標。

參數
test TestDescription：識別測試
metrics HashMap：發出的指標 Map

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

會在 testStarted 和 testEnded 之間呼叫。

參數
test TestDescription：識別測試
failure FailureDescription：說明失敗情形和相關情境的 FailureDescription。

testFailed

public void testFailed (TestDescription test, 
                String trace)

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

會在 testStarted 和 testEnded 之間呼叫。

參數
test TestDescription：識別測試
trace String：失敗的堆疊追蹤

testIgnored

public void testIgnored (TestDescription test)

當測試不會執行時呼叫，通常是因為測試方法以 org.junit.Ignore 註解標註。

參數
test TestDescription：識別測試

testModuleEnded

public void testModuleEnded ()

回報模組執行作業的結束時間。

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

回報模組的執行開始時間。這個回呼與 testModuleEnded() 相關聯，且在序列中為選用項目。只有在使用模組的執行期間，才會使用這個標記：以套件為基礎的執行器。

參數
moduleContext IInvocationContext：模組的 IInvocationContext。

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

測試執行結束時會回報。FIXME：我們無法使用不同型別的兩個 Map<> 介面，因此必須在此使用 HashMap。

參數
elapsedTimeMillis long：裝置回報的經過時間 (以毫秒為單位)
runMetrics HashMap：在測試執行結束時，使用 Metric 報告的鍵/值組合。

testRunFailed

public void testRunFailed (FailureDescription failure)

由於 FailureDescription 所述的錯誤，報表測試執行作業無法完成。

參數
failure FailureDescription：說明失敗情形和相關情境的 FailureDescription。

testRunFailed

public void testRunFailed (String errorMessage)

發生嚴重錯誤，因此無法完成報表測試執行作業。

參數
errorMessage String：String，說明執行失敗的原因。

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

回報測試執行的開始時間。

參數
runName String：測試執行名稱
testCount int：測試執行作業中的測試總數
attemptNumber int：訂單號碼，用於識別多次執行的相同 runName 的不同嘗試。attemptNumber 是以 0 為索引，每次執行新作業時都應遞增。舉例來說，如果測試精細重試 3 次，則在相同 runName 下應有 4 次執行作業，且 attemptNumber 為 0 到 3。

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

回報測試執行的開始時間。

參數
runName String：測試執行名稱
testCount int：測試執行作業中的測試總數

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

回報測試執行的開始時間。

參數
runName String：測試執行名稱
testCount int：測試執行作業中的測試總數
attemptNumber int：訂單號碼，用於識別多次執行的相同 runName 的不同嘗試。attemptNumber 是以 0 為索引，每次執行新作業時都應遞增。舉例來說，如果測試精細重試 3 次，則在相同 runName 下應有 4 次執行，且 attemptNumber 為 0 到 3。
startTime long：跑步開始時間，透過 System.currentTimeMillis() 測量

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Called when a test is skipped and did not execute for a reason that is not usually expected. 系統會嘗試重試這些測試，以確保正常執行。

參數
test TestDescription：識別測試
reason SkipReason：SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

testStarted(TestDescription) 的替代方案，我們也會指定測試開始時間，並搭配 testEnded(TestDescription,long,Map) 進行準確的評估。

參數
test TestDescription：識別測試
startTime long：測試開始時間，透過 System.currentTimeMillis() 測量

testStarted

public void testStarted (TestDescription test)

回報個別測試案例的開始時間。舊版介面，建議盡可能使用 testStarted(TestDescription)。

參數
test TestDescription：識別測試

受保護的方法

createTestStorageClient

protected ITestStorageClient createTestStorageClient (IInvocationContext context)

參數
context IInvocationContext

傳回
ITestStorageClient

擲回
GeneralSecurityException
IOException

getVersion

protected String getVersion ()

傳回
String