Starting March 27, 2025, we recommend using android-latest-release instead of aosp-main to build and contribute to AOSP. For more information, see Changes to AOSP.

ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

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

Known direct subclasses

FilteredResultForwarder, LogSaverResultForwarder, LogcatCrashResultForwarder, ResultAndLogForwarder, RetryResultForwarder, ShardMainResultForwarder

FilteredResultForwarder	Variant of `ResultForwarder` that only allows an allowlist of `TestDescription` to be reported.
LogSaverResultForwarder	A `ResultForwarder` for saving logs with the global file saver.
LogcatCrashResultForwarder	Special listener: on failures (instrumentation process crashing) it will attempt to extract from the logcat the crash and adds it to the failure message associated with the test.
ResultAndLogForwarder	Forwarder for results and logs events.
RetryResultForwarder	An Extension of `ResultForwarder` that always push to a given attempt number.
ShardMainResultForwarder	A `ResultForwarder` that combines the results of a sharded test invocations.

Known indirect subclasses

RetryLogSaverResultForwarder

RetryLogSaverResultForwarder Forwarder that also handles passing the current attempt we are at.

A ITestInvocationListener that forwards invocation results to a list of other listeners.

Summary

Public constructors
`ResultForwarder( listeners)` Create a `ResultForwarder`.
`ResultForwarder(ITestInvocationListener... listeners)` Alternate variable arg constructor for `ResultForwarder`.

Protected constructors
`ResultForwarder()` Create a `ResultForwarder` with deferred listener setting.

Public methods
`TestSummary`	`getSummary()`
`void`	`invocationEnded(long elapsedTime)`
`void`	`invocationFailed(FailureDescription failure)`
`void`	`invocationFailed(Throwable cause)`
`void`	`invocationStarted(IInvocationContext context)`
`void`	`testAssumptionFailure(TestDescription test, String trace)`
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)`
`void`	`testEnded(TestDescription test, long endTime, testMetrics)`
`void`	`testEnded(TestDescription test, testMetrics)`
`void`	`testFailed(TestDescription test, FailureDescription failure)`
`void`	`testFailed(TestDescription test, String trace)`
`void`	`testIgnored(TestDescription test)`
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)`
`void`	`testModuleEnded()`
`void`	`testModuleStarted(IInvocationContext moduleContext)`
`void`	`testRunEnded(long elapsedTime, runMetrics)`
`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`	`testStarted(TestDescription test, long startTime)`
`void`	`testStarted(TestDescription test)`

Protected methods
	`getListeners()` Get the list of listeners.
`void`	`setListeners( listeners)` Set the listeners after construction.
`void`	`setListeners(ITestInvocationListener... listeners)` Set the listeners after construction.

Public constructors

ResultForwarder

public ResultForwarder ( listeners)

Create a ResultForwarder.

Parameters
`listeners`	: the real `ITestInvocationListener`s to forward results to

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

Alternate variable arg constructor for ResultForwarder.

Parameters
`listeners`	`ITestInvocationListener`: the real `ITestInvocationListener`s to forward results to

Protected constructors

ResultForwarder

protected ResultForwarder ()

Create a ResultForwarder with deferred listener setting. Intended only for use by subclasses.

Public methods

getSummary

public TestSummary getSummary ()

Returns
`TestSummary`

invocationEnded

public void invocationEnded (long elapsedTime)

Parameters
`elapsedTime`	`long`

invocationFailed

public void invocationFailed (FailureDescription failure)

Parameters
`failure`	`FailureDescription`

invocationFailed

public void invocationFailed (Throwable cause)

Parameters
`cause`	`Throwable`

invocationStarted

public void invocationStarted (IInvocationContext context)

Parameters
`context`	`IInvocationContext`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Parameters
`test`	`TestDescription`
`trace`	`String`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Parameters
`test`	`TestDescription`
`failure`	`FailureDescription`

testEnded

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

Parameters
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Parameters
`test`	`TestDescription`
`testMetrics`

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Parameters
`test`	`TestDescription`
`failure`	`FailureDescription`

testFailed

public void testFailed (TestDescription test, 
                String trace)

Parameters
`test`	`TestDescription`
`trace`	`String`

testIgnored

public void testIgnored (TestDescription test)

Parameters
`test`	`TestDescription`

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Parameters
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testModuleEnded

public void testModuleEnded ()

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Parameters
`moduleContext`	`IInvocationContext`

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Parameters
`elapsedTime`	`long`
`runMetrics`

testRunFailed

public void testRunFailed (FailureDescription failure)

Parameters
`failure`	`FailureDescription`

testRunFailed

public void testRunFailed (String errorMessage)

Parameters
`errorMessage`	`String`

testRunStarted

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

Parameters
`runName`	`String`
`testCount`	`int`
`attemptNumber`	`int`

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Parameters
`runName`	`String`
`testCount`	`int`

testRunStarted

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

Parameters
`runName`	`String`
`testCount`	`int`
`attemptNumber`	`int`
`startTime`	`long`

testRunStopped

public void testRunStopped (long elapsedTime)

Parameters
`elapsedTime`	`long`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Parameters
`test`	`TestDescription`
`startTime`	`long`

testStarted

public void testStarted (TestDescription test)

Parameters
`test`	`TestDescription`

Protected methods

getListeners

protected  getListeners ()

Get the list of listeners. Intended only for use by subclasses.

Returns
	The list of `ITestInvocationListener`s.

setListeners

protected void setListeners ( listeners)

Set the listeners after construction. Intended only for use by subclasses.

Parameters
`listeners`	: the real `ITestInvocationListener`s to forward results to

setListeners

protected void setListeners (ITestInvocationListener... listeners)

Set the listeners after construction. Intended only for use by subclasses.

Parameters
`listeners`	`ITestInvocationListener`: the real `ITestInvocationListener`s to forward results to