此页面由 Cloud Translation API 翻译。

名称MangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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

在报告结果时翻译测试方法、类和包名称的代理侦听器。

概括

公共构造函数
`NameMangleListener ( ITestInvocationListener listener)`

公共方法
`TestSummary`	`getSummary ()` 允许 InvocationListener 返回摘要。
`void`	`invocationEnded (long elapsedTime)` 报告调用已终止，无论是成功终止还是由于某些错误情况。
`void`	`invocationFailed (Throwable cause)` 报告由于某些错误情况导致的不完整调用。
`void`	`invocationStarted ( IInvocationContext context)` 报告测试调用的开始。
`void`	`testAssumptionFailure ( TestDescription test, String trace)` 当原子测试标记它假定条件为假时调用
`void`	`testEnded ( TestDescription test, testMetrics)` `testEnded ( TestDescription test, testMetrics)` 报告单个测试用例的执行结束。
`void`	`testFailed ( TestDescription test, String trace)` 报告单个测试用例的失败。
`void`	`testIgnored ( TestDescription test)` 当测试不会运行时调用，通常是因为测试方法用 org.junit.Ignore 注释。
`void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)` 提供来自测试调用的关联日志或调试数据。
`void`	`testRunEnded (long elapsedTime, runMetrics)` `testRunEnded (long elapsedTime, runMetrics)` 报告测试运行结束。
`void`	`testRunFailed (String errorMessage)` 报告测试运行由于致命错误而未能完成。
`void`	`testRunStarted (String runName, int testCount)` 报告测试运行的开始。
`void`	`testRunStopped (long elapsedTime)` 由于用户请求，报告测试运行在完成之前停止。
`void`	`testStarted ( TestDescription test)` 报告单个测试用例的开始。

受保护的方法
`TestDescription`	`mangleTestId ( TestDescription test)` 此方法在传递给`TestDescription` `testStarted(com.android.tradefed.result.TestDescription)` 、 `testFailed(com.android.tradefed.result.TestDescription, String)`和`ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))`回调。
`String`	`mangleTestRunName (String name)` 此方法在传递给`testRunStarted(String, int)`回调的所有测试运行名称上运行。

公共构造函数

名称MangleListener

public NameMangleListener (ITestInvocationListener listener)

参数
`listener`	`ITestInvocationListener`

公共方法

获取摘要

public TestSummary getSummary ()

允许 InvocationListener 返回摘要。

退货
`TestSummary`	总结运行的`TestSummary` ，或 null

调用结束

public void invocationEnded (long elapsedTime)

报告调用已终止，无论是成功终止还是由于某些错误情况。

将由 TradeFederation 框架自动调用。

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

调用失败

public void invocationFailed (Throwable cause)

报告由于某些错误情况导致的不完整调用。

将由 TradeFederation 框架自动调用。

参数
`cause`	`Throwable` : 失败的`ERROR(/Throwable)`原因

调用开始

public void invocationStarted (IInvocationContext context)

报告测试调用的开始。

将由 TradeFederation 框架自动调用。记者需要覆盖此方法以支持多设备报告。

参数
`context`	`IInvocationContext` ：有关调用的信息

测试假设失败

public void testAssumptionFailure (TestDescription test, 
                String trace)

当原子测试标记它假定条件为假时调用

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

测试结束

public void testEnded (TestDescription test, 
                 testMetrics)

报告单个测试用例的执行结束。

如果未调用testFailed(TestDescription, FailureDescription) ，则此测试通过。还返回在测试用例执行期间可能发出的任何键/值指标。

参数
`test`	`TestDescription` ：标识测试
`testMetrics`	: 发出的指标的`ERROR(/Map)`

测试失败

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` ：数据的`ERROR(/String)`描述性名称。例如“device_logcat”。注意 dataName 每次调用可能不是唯一的。即实现者必须能够处理具有相同数据名的多个调用
`dataType`	`LogDataType` ：数据的`LogDataType`
`dataStream`	`InputStreamSource` ：数据的`InputStreamSource` 。实施者应调用 createInputStream 开始读取数据，并确保在完成后关闭生成的 InputStream。调用者应确保数据源保持存在且可访问，直到 testLog 方法完成。

测试运行结束

public void testRunEnded (long elapsedTime, 
                 runMetrics)

报告测试运行结束。 FIXME: 我们不能有两个不同类型的 Map<> 接口，所以我们必须在这里使用 HashMap。

参数
`elapsedTime`	`long` ：设备报告经过的时间，以毫秒为单位
`runMetrics`	：在测试运行结束时使用`Metric`报告的键值对。

测试运行失败

public void testRunFailed (String errorMessage)

报告测试运行由于致命错误而未能完成。

参数
`errorMessage`	`String` : `ERROR(/String)`描述运行失败的原因。

测试运行开始

public void testRunStarted (String runName, 
                int testCount)

报告测试运行的开始。

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

测试运行已停止

public void testRunStopped (long elapsedTime)

由于用户请求，报告测试运行在完成之前停止。

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

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

测试开始

public void testStarted (TestDescription test)

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

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

受保护的方法

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

此方法在传递给TestDescription testStarted(com.android.tradefed.result.TestDescription) 、 testFailed(com.android.tradefed.result.TestDescription, String)和ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))回调。该方法应返回一个可能不同的TestDescription ，该 TestDescription 将传递给在构造期间指定的下游ITestInvocationListener 。

实施时应注意不要修改原始的TestDescription 。

默认实现通过未修改的方式传递传入标识符。

参数
`test`	`TestDescription`

退货
`TestDescription`

mangleTestRunName

protected String mangleTestRunName (String name)

此方法在传递给testRunStarted(String, int)回调的所有测试运行名称上运行。该方法应返回一个可能不同的测试运行名称，该名称将传递给在构造期间指定的下游ITestInvocationListener 。

实施时应注意不要修改原始运行名称。

默认实现通过未修改的方式传递传入的测试运行名称。

参数
`name`	`String`

退货
`String`