名称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