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

ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.invoker.ShardMainResultForwarder

合併資料分割測試叫用結果的 ResultForwarder。只有所有資料分割叫用完成後，系統都會回報向監聽器叫用完成的情形。

這個類別並非執行緒安全。用戶端如預期，傳送測試結果，以避免被錯誤呼叫叫用回呼。

摘要

公用建構函式
`ShardMainResultForwarder( listeners, int expectedShards)` 建立 `ShardMainResultForwarder`。

公用方法
	`getListeners()` 取得事件監聽器清單。
`void`	`invocationEnded(long elapsedTime)` 回報叫用已終止 (無論成功或因某些錯誤而終止) 值。
`void`	`invocationEnded(long elapsedTime, IInvocationContext context)` 提供更詳細的回呼，以區分已完成的資料分割。
`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`	`testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream)` 只轉送 testLog，不要先儲存記錄。
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` 儲存測試記錄時呼叫。

公用建構函式

ShardMainResultForwarder

public ShardMainResultForwarder ( listeners, 
                int expectedShards)

建立 ShardMainResultForwarder。

參數
`listeners`	：將結果轉寄至所有時機的 `ITestInvocationListener` 清單資料分割已完成
`expectedShards`	`int`：資料分割數量

公用方法

getListener

public  getListeners ()

取得事件監聽器清單。僅適用於子類別。

傳回
	`ITestInvocationListener` 清單。

已叫用

public void invocationEnded (long elapsedTime)

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

將由 TradeFederation 架構自動呼叫。

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

已叫用

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

提供更詳細的回呼，以區分已完成的資料分割。

參數
`elapsedTime`	`long`
`context`	`IInvocationContext`

叫用失敗

public void invocationFailed (FailureDescription failure)

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

將由 TradeFederation 架構自動呼叫。

參數
`failure`	`FailureDescription`：說明失敗原因的 `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`之前記錄且應與測試案例

測試記錄轉送

public void testLogForward (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

只轉送 testLog，不要先儲存記錄。

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

testLog 已儲存

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

儲存測試記錄時呼叫。

應用來取代 ITestInvocationListener#testLog(String, LogDataType, InputStreamSource)。

參數
`dataName`	`String`：資料的 `String` 描述性名稱。例如：「device_logcat」。注意事項 dataName 可在每次叫用中重複。實作者必須能處理以相同的 dataName 呼叫多次呼叫
`dataType`	`LogDataType`：資料的 `LogDataType`
`dataStream`	`InputStreamSource`：資料的 `InputStreamSource`。實作者應呼叫 createInputStream 開始讀取資料，並確保結果關閉完成後的 InputStream。
`logFile`	`LogFile`：包含已儲存檔案中繼資料的 `LogFile`。