結果轉發器

public class ResultForwarder
extends Object implements ITestInvocationListener

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

已知的直接子類 FilteredResultForwarder 、 JarHostTest.HostTestListener 、 LogSaverResultForwarder 、 LogcatCrashResultForwarder 、 PythonBinaryHostTest.PythonForwarder 、 ResultAndLogForwarder 、 RetryResultForward 過濾結果轉發器 ResultForwarder的變體，僅允許報告TestDescription的白名單。 JarHostTest.HostTestListener 包裝偵聽器，將 testRunStarted() 和 testRunEnded() 之外的所有事件轉送到嵌入式偵聽器。 LogSaver結果轉發器 用於使用全域檔案保護程式保存日誌的ResultForwarder 。 LogcatCrashResultForwarder 特殊偵聽器：當發生故障（偵測進程崩潰）時，它將嘗試從 logcat 中提取崩潰並將其新增至與測試關聯的失敗訊息。 PythonBinaryHostTest.PythonForwarder 結果轉發器用二進位名稱取代運行名稱。 結果和日誌轉發器 結果和日誌事件的轉發器。 重試結果轉發器 ResultForwarder的擴展，始終推送到給定的嘗試次數。 ShardMainResultForwarder 合併分片測試呼叫結果的ResultForwarder 。 測試逾時執行器 允許檢查給定測試案例的執行時間的偵聽器，如果超過給定的逾時則失敗。

已知的間接子類 GranularRetriableTestWrapper.StartEndCollector 、 RetryLogSaverResultForwarder GranularRetriableTestWrapper.StartEndCollector 用於捕獲丟失的運行開始和結束的類助手。 RetryLogSaverResultForwarder 轉發器也處理傳遞我們目前的嘗試。

---

將呼叫結果轉送到其他偵聽器清單的ITestInvocationListener 。

概括

公共構造函數
ResultForwarder ( listeners) ResultForwarder ( listeners) 建立一個ResultForwarder 。
ResultForwarder ( ITestInvocationListener... listeners) ResultForwarder的備用變數 arg 建構子。

受保護的構造函數
ResultForwarder () 建立具有延遲偵聽器設定的ResultForwarder 。

公共方法
TestSummary	getSummary () 允許 IncationListener 傳回摘要。
void	invocationEnded (long elapsedTime) 報告呼叫已終止，無論是成功還是由於某些錯誤情況。
void	invocationFailed ( FailureDescription failure) 由於某些錯誤情況而報告不完整的呼叫。
void	invocationFailed (Throwable cause) 由於某些錯誤情況而報告不完整的呼叫。
void	invocationStarted ( IInvocationContext context) 報告測試調用的開始。
void	testAssumptionFailure ( TestDescription test, String trace) 當原子測試標記其假定條件為 false 時調用
void	testAssumptionFailure ( TestDescription test, FailureDescription failure) 當原子測試標記其假定條件為 false 時調用
void	testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))的替代方案，我們可以直接指定結束時間。
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) 當測試不會運行時調用，通常是因為測試方法用 org.junit.Ignore 註解。
void	testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) 提供來自測試調用的關聯日誌或調試資料。
void	testModuleEnded () 報告模組運作結束。
void	testModuleStarted ( IInvocationContext moduleContext) 報告模組運作的開始。
void	testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) 報告測試運行結束。
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	testRunStopped (long elapsedTime) 由於用戶請求，報告測試運行在完成之前停止。
void	testStarted ( TestDescription test, long startTime) testStarted(com.android.tradefed.result.TestDescription)的替代方案，其中我們還指定測試開始時間，並結合ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))進行準確測量。
void	testStarted ( TestDescription test) 報告單一測試用例的開始。

受保護的方法
	getListeners () 獲取聽眾清單。
void	setListeners ( ITestInvocationListener... listeners) 建置後設定監聽器。
void	setListeners ( listeners) setListeners ( listeners) 建置後設定監聽器。

公共構造函數

結果轉發器

public ResultForwarder ( listeners)

建立一個ResultForwarder 。

參數
listeners	：將結果轉送到的真正的ITestInvocationListener

結果轉發器

public ResultForwarder (ITestInvocationListener... listeners)

ResultForwarder的備用變數 arg 建構子。

參數
listeners	ITestInvocationListener ：將結果轉送到的真正的ITestInvocationListener

受保護的構造函數

結果轉發器

protected ResultForwarder ()

建立具有延遲偵聽器設定的ResultForwarder 。僅供子類使用。

公共方法

取得摘要

public TestSummary getSummary ()

允許 IncationListener 傳回摘要。

退貨
TestSummary	總結運行的TestSummary ，或 null

呼叫結束

public void invocationEnded (long elapsedTime)

報告呼叫已終止，無論是成功還是由於某些錯誤情況。

將由 TradeFederation 框架自動呼叫。

參數
elapsedTime	long ：呼叫所花費的時間（以毫秒為單位）

呼叫失敗

public void invocationFailed (FailureDescription failure)

由於某些錯誤情況而報告不完整的呼叫。

將由 TradeFederation 框架自動呼叫。

參數
failure	FailureDescription ：描述失敗原因的FailureDescription

呼叫失敗

public void invocationFailed (Throwable cause)

由於某些錯誤情況而報告不完整的呼叫。

將由 TradeFederation 框架自動呼叫。

參數
cause	Throwable ：失敗的Throwable原因

調用開始

public void invocationStarted (IInvocationContext context)

報告測試調用的開始。

將由 TradeFederation 框架自動呼叫。記者需要重寫此方法以支援多設備報告。

參數
context	IInvocationContext ：有關呼叫的信息

測試假設失敗

public void testAssumptionFailure (TestDescription test, 
                String trace)

當原子測試標記其假定條件為 false 時調用

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

測試假設失敗

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 testEnded (TestDescription test, 
                 testMetrics)

報告單一測試案例的執行結束。

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

參數
test	TestDescription ：標識測試
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)

提供來自測試調用的關聯日誌或調試資料。

必須在ERROR(/ITestInvocationListener#invocationFailed(Throwable))或ERROR(/ITestInvocationListener#invocationEnded(long))之前呼叫

TradeFederation 框架將自動呼叫此方法，提供主機日誌和裝置 logcat（如果適用）。

參數
dataName	String ：資料的String描述性名稱。例如“device_logcat”。注意 每次呼叫時 dataName 可能不是唯一的。即實現者必須能夠處理具有相同 dataName 的多個呼叫
dataType	LogDataType ：資料的LogDataType
dataStream	InputStreamSource ：資料的InputStreamSource 。實作者應該呼叫 createInputStream 來開始讀取數據，並確保完成後關閉產生的 InputStream。呼叫者應確保資料來源保持存在且可訪問，直到 testLog 方法完成。

測試模組結束

public void testModuleEnded ()

報告模組運作結束。

測試模組啟動

public void testModuleStarted (IInvocationContext moduleContext)

報告模組運作的開始。此回調與testModuleEnded()關聯，並且在序列中是可選的。它僅在使用模組的運行期間使用：基於套件的運行器。

參數
moduleContext	IInvocationContext ：模組的IInvocationContext 。

測試運行結束

public void testRunEnded (long elapsedTime, 
                 runMetrics)

報告測試運行結束。 FIXME：我們不能有兩個不同類型的 Map<> 接口，所以我們必須在這裡使用 HashMap。

參數
elapsedTime	long ：設備報告的經過時間，以毫秒為單位
runMetrics	：使用Metric測試運行結束時報告的鍵值對。

測試運行失敗

public void testRunFailed (FailureDescription failure)

報告測試運行由於FailureDescription描述的故障而未能完成。

參數
failure	FailureDescription ：描述故障及其上下文的FailureDescription 。

測試運行失敗

public void testRunFailed (String errorMessage)

報告測試運行因致命錯誤而未能完成。

參數
errorMessage	String ：描述運行失敗原因的String 。

測試運行開始

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

報告測試運行的開始。

參數
runName	String : 測試運行名稱
testCount	int : 測試運行中的測試總數
attemptNumber	int ：訂單編號，標識相同 runName 多次執行的不同嘗試。 attemptsNumber 是從 0 開始索引的，並且每次新的運行發生時都應該遞增。例如，一個測試被粒度重試 3 次，它應該在同一 runName 下總共運行 4 次，並且 attemptsNumber 從 0 到 3。

測試運行開始

public void testRunStarted (String runName, 
                int testCount)

報告測試運行的開始。

參數
runName	String : 測試運行名稱
testCount	int : 測試運行中的測試總數

測試運行開始

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

報告測試運行的開始。

參數
runName	String : 測試運行名稱
testCount	int : 測試運行中的測試總數
attemptNumber	int ：訂單編號，標識相同 runName 多次執行的不同嘗試。 attemptsNumber 是從 0 開始索引的，並且每次新的運行發生時都應該遞增。例如，一個測試被粒度重試 3 次，它應該在同一 runName 下總共運行 4 次，並且 attemptsNumber 從 0 到 3。
startTime	long ：運行開始的時間，透過System.currentTimeMillis()測量

測試運行停止

public void testRunStopped (long elapsedTime)

由於用戶請求，報告測試運行在完成之前停止。

TODO：目前未使用，考慮刪除

參數
elapsedTime	long ：設備報告的經過時間，以毫秒為單位

測試開始

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

測試開始

public void testStarted (TestDescription test)

報告單一測試用例的開始。較舊的接口，應盡可能使用testStarted(com.android.tradefed.result.TestDescription) 。

參數
test	TestDescription ：標識測試

受保護的方法

取得監聽器

protected  getListeners ()

獲取聽眾清單。僅供子類使用。

退貨
	ITestInvocationListener的列表。

設定監聽器

protected void setListeners (ITestInvocationListener... listeners)

建置後設定監聽器。僅供子類使用。

參數
listeners	ITestInvocationListener ：將結果轉送到的真正的ITestInvocationListener

設定監聽器

protected void setListeners ( listeners)

建置後設定監聽器。僅供子類使用。

參數
listeners	：將結果轉送到的真正的ITestInvocationListener