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

結果轉發器

public class ResultForwarder
extends Object implements ITestInvocationListener

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

已知的直接子類

FilteredResultForwarder , JarHostTest.HostTestListener , LogSaverResultForwarder , LogcatCrashResultForwarder , PythonBinaryHostTest.PythonForwarder , ResultAndLogForwarder , RetryResultForwarder , ShardMainResultForwarder , TestTimeoutEnforcer

過濾結果轉發器	`ResultForwarder`的變體，僅允許報告`TestDescription`的允許列表。
JarHostTest.HostTestListener	將除 testRunStarted() 和 testRunEnded() 之外的所有事件轉發到嵌入式偵聽器的包裝偵聽器。
LogSaverResultForwarder	用於使用全局文件保護程序保存日誌的`ResultForwarder` 。
LogcatCrashResultForwarder	特殊監聽器：在失敗（儀器進程崩潰）時，它將嘗試從 logcat 中提取崩潰並將其添加到與測試相關的失敗消息中。
PythonBinaryHostTest.PythonForwarder	結果轉發器將運行名稱替換為二進制名稱。
ResultAndLogForwarder	結果和日誌事件的轉發器。
重試結果轉發器	`ResultForwarder`的擴展，始終推送到給定的嘗試次數。
ShardMainResultForwarder	一個`ResultForwarder` ，它結合了分片測試調用的結果。
測試超時執行器	偵聽器允許檢查給定測試用例的執行時間，如果超過給定超時則失敗。

已知的間接子類

GranularRetriableTestWrapper.StartEndCollector , RetryLogSaverResultForwarder

GranularRetriableTestWrapper.StartEndCollector	類助手來捕捉丟失的運行開始和結束。
RetryLogSaverResultForwarder	還處理傳遞我們當前嘗試的轉發器。

將調用結果轉發到其他偵聽器列表的ITestInvocationListener 。

概括

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

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

公共方法
`TestSummary`	`getSummary ()` 允許 InvocationListener 返回摘要。
`void`	`invocationEnded (long elapsedTime)` 報告調用已終止，無論是成功還是由於某些錯誤條件。
`void`	`invocationFailed ( FailureDescription failure)` 由於某些錯誤情況，報告不完整的調用。
`void`	`invocationFailed (Throwable cause)` 由於某些錯誤情況，報告不完整的調用。
`void`	`invocationStarted ( IInvocationContext context)` 報告測試調用的開始。
`void`	`testAssumptionFailure ( TestDescription test, String trace)` 當原子測試標記它假定條件為假時調用
`void`	`testAssumptionFailure ( TestDescription test, FailureDescription failure)` 當原子測試標記它假定條件為假時調用
`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 ( listeners)` `setListeners ( listeners)` 構建後設置監聽器。
`void`	`setListeners ( ITestInvocationListener... listeners)` 構建後設置監聽器。

公共構造函數

結果轉發器

public ResultForwarder ( listeners)

創建一個ResultForwarder 。

參數
`listeners`	: 真正的`ITestInvocationListener`將結果轉發到

結果轉發器

public ResultForwarder (ITestInvocationListener... listeners)

ResultForwarder的備用變量 arg 構造函數。

參數
`listeners`	`ITestInvocationListener` : 真正的`ITestInvocationListener`將結果轉發到

受保護的構造函數

結果轉發器

protected ResultForwarder ()

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

公共方法

獲取摘要

public TestSummary getSummary ()

允許 InvocationListener 返回摘要。

退貨
`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)

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

參數
`test`	`TestDescription` : 標識測試
`trace`	`String` ：失敗的堆棧跟踪

測試假設失敗

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

參數
`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 每次調用可能不是唯一的。即實現者必須能夠處理具有相同數據名稱的多個調用
`dataType`	`LogDataType` : 數據的`LogDataType`
`dataStream`	`InputStreamSource` ：數據的`InputStreamSource` 。實現者應調用 createInputStream 開始讀取數據，並確保在完成後關閉生成的 InputStream。調用者應確保數據源保持存在並可訪問，直到 testLog 方法完成。

測試模塊結束

public void testModuleEnded ()

報告模塊運行的結束。

testModuleStarted

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 多次運行的不同嘗試。 attemptNumber 是 0-indexed 並且應該在每次新的運行發生時遞增。例如，一個測試是粒度重試 3 次，它應該在相同的 runName 下總共運行 4 次，並且嘗試編號是從 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 多次運行的不同嘗試。 attemptNumber 是 0-indexed 並且應該在每次新的運行發生時遞增。例如，一個測試是粒度重試 3 次，它應該在相同的 runName 下總共運行 4 次，並且嘗試編號是從 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 ( listeners)

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

參數
`listeners`	: 真正的`ITestInvocationListener`將結果轉發到

設置監聽器

protected void setListeners (ITestInvocationListener... listeners)

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

參數
`listeners`	`ITestInvocationListener` : 真正的`ITestInvocationListener`將結果轉發到