ResultForwarder
public
class
ResultForwarder
extends Object
implements
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.ResultForwarder |
用于将调用结果转发给其他监听器列表的 ITestInvocationListener
。
摘要
公共构造函数 | |
---|---|
ResultForwarder(ITestInvocationListener... listeners)
|
|
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)
在原子测试标记它假设条件为 false 时调用 |
void
|
testEnded(TestDescription test, long endTime,
|
void
|
testEnded(TestDescription test,
报告单个测试用例的执行结束。 |
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,
报告测试运行结束。 |
void
|
testRunFailed(FailureDescription failure)
由于 |
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)
|
void
|
testStarted(TestDescription test)
报告单个测试用例的开始。 |
受保护的方法 | |
---|---|
|
getListeners()
获取监听器列表。 |
void
|
setListeners(ITestInvocationListener... listeners)
在构建后设置监听器。 |
void
|
setListeners(
在构建后设置监听器。 |
公共构造函数
ResultForwarder
public ResultForwarder (ITestInvocationListener... listeners)
ResultForwarder
的备用变量参数构造函数。
参数 | |
---|---|
listeners |
ITestInvocationListener :要将结果转发到的实际 ITestInvocationListener |
ResultForwarder
public ResultForwarder (listeners)
创建 ResultForwarder
。
参数 | |
---|---|
listeners |
:要向其转发结果的实际 ITestInvocationListener |
受保护的构造函数
公共方法
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 原因 |
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) |
testFailed
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()
相关联,在序列中是可选的。它仅在使用
module:基于套件的运行程序。
参数 | |
---|---|
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 的不同尝试
运行多次的命令tryNumber 从 0 开始编号,并且应该每次递增。
都会发生新的运行例如测试会精细地重试 3 次,总共应该有 4 次
以相同的 runName 运行,而 tryNumber 范围为 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 :用于标识测试 |
受保护的方法
setListeners
protected void setListeners (ITestInvocationListener... listeners)
在构建后设置监听器。仅供子类使用。
参数 | |
---|---|
listeners |
ITestInvocationListener :要将结果转发到的实际 ITestInvocationListener |
setListeners
protected void setListeners (listeners)
在构建后设置监听器。仅供子类使用。
参数 | |
---|---|
listeners |
:要向其转发结果的实际 ITestInvocationListener |