此页面由 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`将结果转发到