收集测试监听器

public class CollectingTestListener
extends Object implements ITestInvocationListener, ILogSaverListener

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

已知的直接子类

EmailResultReporter ， JsonHttpTestResultReporter ， MetricsXMLResultReporter ， ModuleListener ， ResultAggregator ， ShardListener ， SuiteResultReporter ， XmlResultReporter

EmailResultReporter	一个简单的结果报告程序基类，用于发送测试结果的电子邮件。
JsonHttpTestResultReporter	结果报告器，对测试指标结果进行编码，并将设备信息分支为JSON，然后将POST分支为HTTP服务端点
指标XMLResultReporter	MetricsXMLResultReporter在测试的invocationEnded阶段，将测试指标和运行指标写入XML文件夹中由metrics-folder参数指定的文件夹中。
模块监听器	侦听器附加到每个模块的每个`IRemoteTest`以便收集结果列表。
结果聚合器	特殊转发器，根据需要使用的重试策略在需要时汇总结果。
碎片监听器	一个`ITestInvocationListener` ，它从一个调用碎片（也就是一个可以在多个资源上并行运行的调用拆分）收集结果，并将其转发给另一个侦听器。
SuiteResultReporter	收集整个套件调用的测试结果并输出最终结果。
XmlResultReporter	将JUnit结果以与Ant的XMLJUnitResultFormatter一致的格式写入XML文件。

已知的间接子类

DeviceUnavailEmailResultReporter ， FailureEmailResultReporter ， FormattedGeneratorReporter ， InvocationFailureEmailResultReporter ， TestFailureEmailResultReporter ， XmlFormattedGeneratorReporter

DeviceUnavailEmailResultReporter	当由于设备不可用异常而导致调用失败时将发送电子邮件的`EmailResultReporter` 。
FailureEmailResultReporter	如果发生测试失败或调用失败，则发送`EmailResultReporter`通知的`EmailResultReporter` 。
FormattedGeneratorReporter	记者，可以生成特定格式的报告。
InvocationFailureEmailResultReporter	一个`EmailResultReporter` ，它还可以将通知限制为仅调用失败。
TestFailureEmailResultReporter	一个`EmailResultReporter` ，它还可以将通知限制为仅测试失败。
XmlFormattedGeneratorReporter	`FormattedGeneratorReporter`套件的`FormattedGeneratorReporter`实现结果为xml格式。

一个ITestInvocationListener ，它将收集所有测试结果。

尽管此对象中使用的数据结构是线程安全的，但必须以正确的顺序调用ITestInvocationListener回调。

摘要

公共建设者
`CollectingTestListener ()`

公开方法
`IBuildInfo`	`getBuildInfo ()` 不建议使用此方法。依赖`getInvocationContext()`的`IBuildInfo` 。
`TestRunResult`	`getCurrentRunResults ()` 获取当前测试运行的结果。
`int`	`getExpectedTests ()` 返回预期的测试数量。
`IInvocationContext`	`getInvocationContext ()` 返回通过`invocationStarted(com.android.tradefed.invoker.IInvocationContext)`报告的调用上下文
	`getMergedTestRunResults ()` 返回不同尝试之间所有运行的合并结果集合。
`IInvocationContext`	`getModuleContextForRunResult (String testRunName)` 返回与结果关联的模块的`IInvocationContext` 。
	`getNonAssociatedLogFiles ()` 返回包含所有记录的文件的映射副本，该文件与测试运行无关。
`int`	`getNumAllFailedTestRuns ()` 返回失败状态下的测试运行总数
`int`	`getNumAllFailedTests ()` 返回处于失败状态的测试总数（仅失败，假设失败不计入失败）。
`int`	`getNumTestsInState (TestResult.TestStatus status)` 返回此运行在给定状态下的测试数。
`int`	`getNumTotalTests ()` 返回所有运行的完整测试总数。
`IBuildInfo`	`getPrimaryBuildInfo ()` 返回通过`invocationStarted(com.android.tradefed.invoker.IInvocationContext)`报告的主要构建信息。
	`getRunResults ()` 不建议使用此方法。使用`getMergedTestRunResults()`
`TestRunResult`	`getTestRunAtAttempt (String testRunName, int attempt)` 返回`TestRunResult`一次尝试。
`int`	`getTestRunAttemptCount (String testRunName)` 返回给定测试运行名称的尝试次数。
	`getTestRunAttempts (String testRunName)` 获取给定测试运行的所有`TestRunResult`尝试。
	`getTestRunForAttempts (int attempt)` 获取给定尝试的所有结果。
	`getTestRunNames ()` 返回所有测试运行的所有名称。
`boolean`	`hasFailedTests ()` 如果调用具有任何失败或假设失败的测试，则返回。
`boolean`	`hasTestRunResultsForName (String testRunName)` 返回给定的测试运行名称是否有任何结果。
`void`	`invocationEnded (long elapsedTime)`
`void`	`invocationFailed (Throwable cause)`
`void`	`invocationStarted (IInvocationContext context)`
`void`	`logAssociation (String dataName, LogFile logFile)`
`void`	`setBuildInfo (IBuildInfo buildInfo)` 不建议使用此方法。不再需要测试。
`void`	`setMergeStrategy (MergeStrategy strategy)` 设置合并结果时要使用的`MergeStrategy` 。
`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)`
`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)`
`void`	`testModuleEnded ()`
`void`	`testModuleStarted (IInvocationContext moduleContext)`
`void`	`testRunEnded (long elapsedTime, runMetrics)` `testRunEnded (long elapsedTime, runMetrics)`
`void`	`testRunFailed (FailureDescription failure)`
`void`	`testRunFailed (String errorMessage)`
`void`	`testRunStarted (String name, int numTests, int attemptNumber)`
`void`	`testRunStarted (String name, int numTests)`
`void`	`testRunStarted (String name, int numTests, int attemptNumber, long startTime)`
`void`	`testRunStopped (long elapsedTime)`
`void`	`testStarted (TestDescription test, long startTime)`
`void`	`testStarted (TestDescription test)`

受保护的方法
`final void`	`clearResultsForName (String testRunName)` 允许清除给定运行名称的结果。
`void`	`setIsAggregrateMetrics (boolean aggregate)` 切换“汇总指标”选项

公共建设者

收集测试监听器

public CollectingTestListener ()

公开方法

getBuildInfo

public IBuildInfo getBuildInfo ()

不建议使用此方法。
依赖于getInvocationContext()的IBuildInfo 。

返回构建信息。

退货
`IBuildInfo`

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

获取当前测试运行的结果。

注意结果可能不完整。建议在处理结果之前适当测试TestRunResult#isRunComplete()和/或（@link TestRunResult＃isRunFailure（）}的值。

退货
`TestRunResult`	`TestRunResult`代表上一次测试运行期间收集的数据

getExpectedTests

public int getExpectedTests ()

返回预期的测试数量。如果某些测试未运行，则可能与getNumTotalTests()不同。

退货
`int`

getInvocationContext

public IInvocationContext getInvocationContext ()

返回通过invocationStarted(com.android.tradefed.invoker.IInvocationContext)报告的调用上下文

退货
`IInvocationContext`

getMergedTestRunResults

public  getMergedTestRunResults ()

返回不同尝试之间所有运行的合并结果集合。

如果有多个结果，则将每个测试运行合并，最新的测试结果将覆盖以前运行的测试结果。试运行按尝试编号排序。

相同尝试的指标将基于由aggregate-metrics设置的首选项进行合并。最终指标将是最后一次尝试的指标。

退货

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

返回与结果关联的模块的IInvocationContext 。

参量
`testRunName`	`String` ：{ `testRunStarted(String, int)`给出的名称。

退货
`IInvocationContext`	如果给定的测试运行名称没有结果，则该模块的`IInvocationContext`为`null` 。

getNonAssociatedLogFiles

public  getNonAssociatedLogFiles ()

返回包含所有记录的文件的映射副本，该文件与测试运行无关。

退货

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

返回失败状态下的测试运行总数

退货
`int`

getNumAllFailedTests

public int getNumAllFailedTests ()

返回处于失败状态的测试总数（仅失败，假设失败不计入失败）。

退货
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus status)

返回此运行在给定状态下的测试数。

参量
`status`	`TestResult.TestStatus`

退货
`int`

getNumTotalTests

public int getNumTotalTests ()

返回所有运行的完整测试总数。

退货
`int`

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

返回通过invocationStarted(com.android.tradefed.invoker.IInvocationContext)报告的主要构建信息。主构建是运行配置的第一个构建提供程序返回的构建。如果没有上下文（没有构建到测试用例），则返回null。

退货
`IBuildInfo`

getRunResults

public  getRunResults ()

不建议使用此方法。
使用getMergedTestRunResults()

返回所有测试运行的结果。

退货

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

返回TestRunResult一次尝试。

参量
`testRunName`	`String` ：{ `testRunStarted(String, int)`给出的名称。
`attempt`	`int` ：尝试ID。

退货
`TestRunResult`	给定名称和尝试ID的`TestRunResult` ；如果不存在，则返回`null` 。

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

返回给定测试运行名称的尝试次数。

参量
`testRunName`	`String` ：{ `testRunStarted(String, int)`给出的名称。

退货
`int`

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

获取所有给定测试运行的TestRunResult的尝试。

参量
`testRunName`	`String` ：{ `testRunStarted(String, int)`给出的名称。

退货
	给定测试运行的所有`TestRunResult` ，按尝试顺序排序。

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

获取给定尝试的所有结果。

参量
`attempt`	`int` ：我们想要获得结果的尝试。

退货
	给定尝试的所有`TestRunResult` 。

getTestRunNames

public  getTestRunNames ()

返回所有测试运行的所有名称。

这些测试运行可能已多次尝试不同的运行。

退货

hasFailedTests

public boolean hasFailedTests ()

如果调用具有任何失败或假设失败的测试，则返回。

退货
`boolean`

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

返回给定的测试运行名称是否有任何结果。

参量
`testRunName`	`String` ：{ `testRunStarted(String, int)`给出的名称。

退货
`boolean`

调用结束

public void invocationEnded (long elapsedTime)

参量
`elapsedTime`	`long`

调用失败

public void invocationFailed (Throwable cause)

参量
`cause`	`Throwable`

调用开始

public void invocationStarted (IInvocationContext context)

参量
`context`	`IInvocationContext`

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

参量
`dataName`	`String`
`logFile`	`LogFile`

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

不建议使用此方法。
不再需要测试。

设置构建信息。仅应用于测试。

参量
`buildInfo`	`IBuildInfo`

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

设置合并结果时要使用的MergeStrategy 。

参量
`strategy`	`MergeStrategy`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

参量
`test`	`TestDescription`
`trace`	`String`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

参量
`test`	`TestDescription`
`failure`	`FailureDescription`

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

参量
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

参量
`test`	`TestDescription`
`testMetrics`

测试失败

public void testFailed (TestDescription test, 
                FailureDescription failure)

参量
`test`	`TestDescription`
`failure`	`FailureDescription`

测试失败

public void testFailed (TestDescription test, 
                String trace)

参量
`test`	`TestDescription`
`trace`	`String`

testIgnored

public void testIgnored (TestDescription test)

参量
`test`	`TestDescription`

testModuleEnded

102

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

参量
`moduleContext`	`IInvocationContext`

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

参量
`elapsedTime`	`long`
`runMetrics`

testRunFailed

public void testRunFailed (FailureDescription failure)

参量
`failure`	`FailureDescription`

testRunFailed

public void testRunFailed (String errorMessage)

参量
`errorMessage`	`String`

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

参量
`name`	`String`
`numTests`	`int`
`attemptNumber`	`int`

testRunStarted

public void testRunStarted (String name, 
                int numTests)

参量
`name`	`String`
`numTests`	`int`

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

参量
`name`	`String`
`numTests`	`int`
`attemptNumber`	`int`
`startTime`	`long`

testRunStopped

public void testRunStopped (long elapsedTime)

参量
`elapsedTime`	`long`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

参量
`test`	`TestDescription`
`startTime`	`long`

testStarted

public void testStarted (TestDescription test)

参量
`test`	`TestDescription`

受保护的方法

clearResultsForName

protected final void clearResultsForName (String testRunName)

允许清除给定运行名称的结果。仅应在某些情况下使用，例如结果汇总器。

参量
`testRunName`	`String`

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

切换“汇总指标”选项

参量
`aggregate`	`boolean`