本頁面由 Cloud Translation API 翻譯而成。

結果匯總器

public class ResultAggregator
extends CollectingTestListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.retry.ResultAggregator

特殊轉寄站，根據要求過的重試策略，在需要時匯總結果。

摘要

公用建構函式
`ResultAggregator( listeners, RetryStrategy strategy)`

公用方法
`void`	`cleanEventsFiles()`
`final void`	`forwardAggregatedInvocationLogs()` 將所有叫用層級記錄轉送至不支援精細度設定的結果回報者也就是預測結果
`void`	`invocationEnded(long elapsedTime)` 回報叫用已終止 (無論成功或因某些錯誤而終止) 值。
`void`	`invocationFailed(FailureDescription failure)`
`void`	`invocationFailed(Throwable cause)` 回報因某些錯誤條件而不完整的叫用。
`void`	`invocationSkipped(SkipReason reason)` 將叫用回報為略過
`void`	`invocationStarted(IInvocationContext context)` 回報測試叫用開始的時間。
`void`	`logAssociation(String dataName, LogFile logFile)` 在某些情況下，記錄必須與測試案例產生緊密關聯，不過也可以等到因此，`testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` 直達資訊無法回呼。
`void`	`setLogSaver(ILogSaver logSaver)`
`void`	`setUpdatedReporting(boolean updatedReporting)` 設定新報表。
`void`	`testAssumptionFailure(TestDescription test, String trace)` 在不可部分完成的測試旗標假設條件為 false 時呼叫
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` 在不可部分完成的測試旗標假設條件為 false 時呼叫
`void`	`testEnded(TestDescription test, long endTime, testMetrics)` `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` 的替代方式，可以指定結束時間
`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`	`testModuleEnded()` 回報模組的執行完畢。
`void`	`testModuleStarted(IInvocationContext moduleContext)` 回報執行模組的開始。
`void`	`testRunEnded(long elapsedTime, runMetrics)` 測試執行結束報表。
`void`	`testRunFailed(FailureDescription failure)` 由於「`FailureDescription`」指出失敗，因此無法完成報表測試。
`void`	`testRunFailed(String errorMessage)` 發生嚴重錯誤，因此無法完成報表測試。
`void`	`testRunStarted(String name, int testCount, int attemptNumber, long startTime)` 回報測試執行作業的開始。
`void`	`testSkipped(TestDescription test, SkipReason reason)` 測試被略過，且因非預期原因而未執行時呼叫。
`void`	`testStarted(TestDescription test, long startTime)` `testStarted(com.android.tradefed.result.TestDescription)` 的替代方式，我們會一併指定測試的時間再加上 `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))`，才能取得準確的測量結果

保護方法
`File[]`	`getEventsLogs()`

公用建構函式

結果匯總器

public ResultAggregator ( listeners, 
                RetryStrategy strategy)

參數
`listeners`
`strategy`	`RetryStrategy`

公用方法

CleanEventsFiles

public void cleanEventsFiles ()

ForwardAggregatedInvocationLogs

public final void forwardAggregatedInvocationLogs ()

將所有叫用層級記錄轉送至不支援精細度設定的結果回報者也就是預測結果

已叫用

public void invocationEnded (long elapsedTime)

回報叫用已終止 (無論成功或因某些錯誤而終止) 值。

將由 TradeFederation 架構自動呼叫。

參數
`elapsedTime`	`long`：叫用的經過時間 (以毫秒為單位)

叫用失敗

public void invocationFailed (FailureDescription failure)

參數
`failure`	`FailureDescription`

叫用失敗

public void invocationFailed (Throwable cause)

回報因某些錯誤條件而不完整的叫用。

將由 TradeFederation 架構自動呼叫。

參數
`cause`	`Throwable`：失敗的 `Throwable` 原因

已略過叫用

public void invocationSkipped (SkipReason reason)

將叫用回報為略過

參數
`reason`	`SkipReason`

叫用

public void invocationStarted (IInvocationContext context)

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

將由 TradeFederation 架構自動呼叫。回報者需要覆寫此方法就能支援多部裝置回報。

參數
`context`	`IInvocationContext`：叫用的相關資訊

記錄檔關聯

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`之前記錄且應與測試案例

setLogSaver

public void setLogSaver (ILogSaver logSaver)

參數
`logSaver`	`ILogSaver`

setUpdatedReporting

public void setUpdatedReporting (boolean updatedReporting)

設定新報表。

參數
`updatedReporting`	`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`，說明失敗及其背景資訊。

測試結束

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 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`

testLog 已儲存

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

參數
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

testModuleEnded

public void testModuleEnded ()

回報模組的執行完畢。

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

回報執行模組的開始。這個回呼與 testModuleEnded() 相關聯，在序列中是選用選項。只會在使用模組：套件型執行器

參數
`moduleContext`	`IInvocationContext`：模組的 `IInvocationContext`。

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

參數
`elapsedTime`	`long`：裝置回報的經過時間 (以毫秒為單位)
`runMetrics`	：使用 `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 name, 
                int testCount, 
                int attemptNumber, 
                long startTime)

回報測試執行作業的開始。

參數
`name`	`String`：測試執行作業名稱
`testCount`	`int`：測試執行作業中的測試總數
`attemptNumber`	`int`：訂單號碼，可識別同一個 runName 的不同嘗試次數執行多次tryNumber 為 0 的索引，且每次傳回新的工作也會開始執行例如：執行精細的重試 3 次測試，總共應執行 4 次測試同一個 runName，且 tryNumber 介於 0 到 3 之間。
`startTime`	`long`：執行作業開始的時間，透過 `System.currentTimeMillis()` 測量

測試略過

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

testStarted

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()` 進行測量

保護方法

getEventsLogs

protected File[] getEventsLogs ()

傳回
`File[]`