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：分割資料的數量

公用方法

getListeners

public  getListeners ()

取得事件監聽器清單。僅供子類別使用。

傳回
	ITestInvocationListener 清單。

invocationEnded

public void invocationEnded (long elapsedTime)

回報叫用已終止，無論是成功或因某些錯誤條件而終止。

會由 TradeFederation 架構自動呼叫。

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

invocationEnded

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

更詳細的回呼，可區分哪個區塊已完成。

參數
elapsedTime	long
context	IInvocationContext

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 logFile)

在某些情況下，記錄必須與測試案例建立強烈關聯，但無法直接在 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) 回呼上執行此操作。因此，這個回呼可明確提供強連結。

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

testLogForward

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

只轉送 testLog，而非先儲存記錄。

參數
dataName	String
dataType	LogDataType
dataStream	InputStreamSource

testLogSaved

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。