此页面由 Cloud Translation API 翻译。

ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

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

已知的直接子类

FilteredResultForwarder、JarHostTest.HostTestListener、LogSaverResultForwarder、LogcatCrashResultForwarder、PythonHostTest.PythonForwarder、ResultAndLogForwarder、RetryResultForwarder、ShardMainResultForwarder、

FilteredResultForwarder	`ResultForwarder` 的变体，仅允许报告 `TestDescription` 的许可名单。
JarHostTest.HostTestListener	用于将除 testRunStarted() 和 testRunEnded() 之外的所有事件转发给嵌入式监听器的封装容器监听器。
LogSaverResultForwarder	用于使用全局文件保存程序保存日志的 `ResultForwarder`。
LogcatCrashResultForwarder	特殊监听器：失败（插桩进程崩溃）时，它会尝试从 logcat 中提取崩溃，并将其添加到与测试关联的失败消息。
PythonBinaryHostTest.PythonForwarder	结果转发器，用于将运行名称替换为二进制名称。
ResultAndLogForwarder	用于转发结果和日志事件的转发器。
RetryResultForwarder	`ResultForwarder` 的扩展，始终推送到给定尝试编号。
ShardMainResultForwarder	用于组合分片测试调用的结果的 `ResultForwarder`。
TestTimeoutEnforcer	此类监听器可用于检查给定测试用例的执行时间，并在该测试用例超时时运行失败。

已知的间接子类

GranularRetriableTestWrapper.StartEndCollector、RetryLogSaverResultForwarder

GranularRetriableTestWrapper.StartEndCollector	用于捕获缺失的运行开始和结束的类辅助程序。
RetryLogSaverResultForwarder	转发器，也负责传递我们所处的当前尝试。

用于将调用结果转发给其他监听器列表的 ITestInvocationListener。

摘要

公共构造函数
`ResultForwarder(ITestInvocationListener... listeners)` `ResultForwarder` 的备用变量实参构造函数。
`ResultForwarder( listeners)` 创建 `ResultForwarder`。

受保护的构造函数
`ResultForwarder()` 创建具有延迟监听器设置的 `ResultForwarder`。

公共方法
`TestSummary`	`getSummary()` 允许 InvocationListener 返回摘要。
`void`	`invocationEnded(long elapsedTime)` 报告调用已终止，无论是成功终止还是因某种错误条件而终止。
`void`	`invocationFailed(FailureDescription failure)` 报告由于某种错误情况而未完成的调用。
`void`	`invocationFailed(Throwable cause)` 由于某些错误条件，报告调用不完整。
`void`	`invocationSkipped(SkipReason reason)` 将调用报告为跳过
`void`	`invocationStarted(IInvocationContext context)` 报告测试调用的开始。
`void`	`testAssumptionFailure(TestDescription test, String trace)` 当原子测试标记为假的假设条件时调用
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` 当原子测试标记为假的假设条件时调用
`void`	`testEnded(TestDescription test, long endTime, testMetrics)` `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` 的替代方法，在该方法中，我们可以直接指定结束时间。
`void`	`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)` 报告测试运行结束。
`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`	`testSkipped(TestDescription test, SkipReason reason)` 当测试因通常不预期的某种原因而被跳过且未执行时调用。
`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)` 在构建后设置监听器。

公共构造函数

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

ResultForwarder 的备用变量实参构造函数。

参数
`listeners`	`ITestInvocationListener`：要将结果转发到的实际 `ITestInvocationListener`

ResultForwarder

public ResultForwarder ( listeners)

创建 ResultForwarder。

参数
`listeners`	：要将结果转发到的实际 `ITestInvocationListener`

受保护的构造函数

ResultForwarder

protected ResultForwarder ()

创建具有延迟监听器设置的 ResultForwarder。仅供子类使用。

公共方法

getSummary

public TestSummary getSummary ()

允许 InvocationListener 返回摘要。

返回
`TestSummary`	用于总结运行情况的 `TestSummary`，或 null

invocationEnded

public void invocationEnded (long elapsedTime)

报告调用已终止，无论是成功终止还是因某种错误条件而终止。

将由 TradeFederation 框架自动调用。

参数
`elapsedTime`	`long`：调用的经过时间（以毫秒为单位）

invocationFailed

public void invocationFailed (FailureDescription failure)

由于某些错误条件，报告调用不完整。

将由 TradeFederation 框架自动调用。

参数
`failure`	`FailureDescription`：用于说明失败原因的 `FailureDescription`

invocationFailed

public void invocationFailed (Throwable cause)

由于某些错误条件，报告调用不完整。

将由 TradeFederation 框架自动调用。

参数
`cause`	`Throwable`：失败的 `Throwable` 原因

已跳过调用

public void invocationSkipped (SkipReason reason)

将调用报告为跳过

参数
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

报告测试调用的开始。

将由 TradeFederation 框架自动调用。报告程序需要替换此方法，才能支持多设备报告。

参数
`context`	`IInvocationContext`：调用相关信息

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

当原子测试标记为假的假设条件时调用

参数
`test`	`TestDescription`：标识测试
`trace`	`String`：失败的堆栈轨迹

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

当原子测试标记为假的假设条件时调用

参数
`test`	`TestDescription`：用于标识测试
`failure`	`FailureDescription`：描述失败及其上下文的 `FailureDescription`。

testEnded

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

testEnded

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`：失败的堆栈轨迹

testIgnored

public void testIgnored (TestDescription test)

在不会运行测试时调用，通常是因为测试方法带有 org.junit.Ignore 注释。

参数
`test`	`TestDescription`：标识测试

testLog

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 方法完成之前，数据的来源始终存在且可访问。

testModuleEnded

public void testModuleEnded ()

报告模块运行结束。

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

报告模块运行的开始时间。此回调与 testModuleEnded() 相关联，在序列中是可选的。它仅在使用模块（基于套件的运行程序）的运行期间使用。

参数
`moduleContext`	`IInvocationContext`：模块的 `IInvocationContext`。

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

报告测试运行结束。

参数
`elapsedTime`	`long`：设备报告的经过时间（以毫秒为单位）
`runMetrics`	：测试运行结束时报告的键值对

testRunFailed

public void testRunFailed (FailureDescription failure)

由于 FailureDescription 所述的失败，报告测试运行未能完成。

参数
`failure`	`FailureDescription`：描述失败及其上下文的 `FailureDescription`。

testRunFailed

public void testRunFailed (String errorMessage)

由于出现严重错误，报告测试运行未能完成。

参数
`errorMessage`	`String`：`String`，用于说明运行失败的原因。

testRunStarted

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

报告测试运行开始。

参数
`runName`	`String`：测试运行作业名称
`testCount`	`int`：测试运行中的测试总数
`attemptNumber`	`int`：顺序号，用于标识多次运行同一 runName 的不同尝试。attemptNumber 从 0 开始编号，每次有新的运行时都应递增。例如，如果某个测试进行了 3 次精细重试，则它在同一 runName 下总共应有 4 次运行，并且 attemptNumber 应介于 0 到 3 之间。

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

报告测试运行开始。

参数
`runName`	`String`：测试运行作业名称
`testCount`	`int`：测试运行中的测试总数

testRunStarted

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

报告测试运行开始。

参数
`runName`	`String`：测试运行作业名称
`testCount`	`int`：测试运行中的测试总数
`attemptNumber`	`int`：订单号，用于标识多次运行的同一 runName 的不同尝试。attemptNumber 从 0 开始编号，每次有新的运行时都应递增。例如，如果某个测试进行了 3 次精细重试，则它在同一 runName 下总共应有 4 次运行，并且 attemptNumber 应介于 0 到 3 之间。
`startTime`	`long`：运行开始时间，通过 `System.currentTimeMillis()` 衡量

testRunStopped

public void testRunStopped (long elapsedTime)

报告测试运行在完成前因用户请求而停止。

TODO：目前未使用，考虑移除

参数
`elapsedTime`	`long`：设备报告的经过时间（以毫秒为单位）

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

在因通常不符合预期的原因跳过测试且未执行测试时调用。系统会尝试重试这些测试，以便正确执行。

参数
`test`	`TestDescription`：用于标识测试
`reason`	`SkipReason`：`SkipReason`

testStarted

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()` 测量

testStarted

public void testStarted (TestDescription test)

报告单个测试用例的开始。旧版接口，应尽可能使用 testStarted(com.android.tradefed.result.TestDescription)。

参数
`test`	`TestDescription`：用于标识测试

受保护的方法

getListeners

protected  getListeners ()

获取监听器列表。仅供子类使用。

返回
	`ITestInvocationListener` 的列表。

setListeners

protected void setListeners (ITestInvocationListener... listeners)

在构建后设置监听器。仅供子类使用。

参数
`listeners`	`ITestInvocationListener`：要将结果转发到的实际 `ITestInvocationListener`

setListeners

protected void setListeners ( listeners)

在构建后设置监听器。仅供子类使用。

参数
`listeners`	：要将结果转发到的实际 `ITestInvocationListener`