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.

MultiLineReceiver

public abstract class MultiLineReceiver
extends Object implements IShellOutputReceiver

java.lang.Object
↳	com.android.ddmlib.MultiLineReceiver

Known direct subclasses

GTestListTestParser, GTestResultParser, InstallReceiver, InstrumentationResultParser, ListInstrumentationParser, NativeBenchmarkTestParser, NativeStressTestParser, PythonUnitTestResultParser, RustBenchmarkResultParser, RustTestResultParser

GTestListTestParser	A result parser for gtest dry run mode with "--gtest_list_tests" parameter.
GTestResultParser	Parses the 'raw output mode' results of native tests using GTest that run from shell, and informs a ITestInvocationListener of the results.
InstallReceiver	Output receiver for "pm install package.apk" command line.
InstrumentationResultParser	Parses the 'raw output mode' results of an instrumentation test run from shell and informs a ITestRunListener of the results.
ListInstrumentationParser	A `IShellOutputReceiver` that parses the output of a 'pm list instrumentation' query
NativeBenchmarkTestParser	A `IShellOutputReceiver` that parses the benchmark test data output, collecting metrics on average time per operation.
NativeStressTestParser	A `IShellOutputReceiver` that parses the stress test data output, collecting metrics on number of iterations complete and average time per iteration.
PythonUnitTestResultParser	Interprets the output of tests run with Python's unittest framework and translates it into calls on a series of `ITestInvocationListener`s.
RustBenchmarkResultParser	Interprets the output of tests run with Criterion benchmarking framework and translates it into calls on a series of `ITestInvocationListener`s.
RustTestResultParser	Interprets the output of tests run with Rust's unittest framework and translates it into calls on a series of `ITestInvocationListener`s.

Known indirect subclasses

InstallCreateReceiver

InstallCreateReceiver Output receiver for "pm install-create" command line.

Base implementation of IShellOutputReceiver, that takes the raw data coming from the socket, and convert it into String objects.

Additionally, it splits the string by lines.

Classes extending it must implement processNewLines(String[]) which receives new parsed lines as they become available.

Summary

Public constructors
`MultiLineReceiver()`

Public methods
`final void`	`addOutput(byte[] data, int offset, int length)` Called every time some new data is available.
`void`	`done()` Terminates the process.
`void`	`flush()` Called at the end of the process execution (unless the process was canceled).
`abstract void`	`processNewLines(String[] lines)` Called when new lines are being received by the remote process.
`void`	`setTrimLine(boolean trim)` Set the trim lines flag.

Public constructors

MultiLineReceiver

public MultiLineReceiver ()

Public methods

addOutput

public final void addOutput (byte[] data, 
                int offset, 
                int length)

Called every time some new data is available.

Parameters
`data`	`byte`: The new data.
`offset`	`int`: The offset at which the new data starts.
`length`	`int`: The length of the new data.

done

public void done ()

Terminates the process. This is called after the last lines have been through processNewLines(String[]).

flush

public void flush ()

Called at the end of the process execution (unless the process was canceled). This allows the receiver to terminate and flush whatever data was not yet processed.

processNewLines

public abstract void processNewLines (String[] lines)

Called when new lines are being received by the remote process.

It is guaranteed that the lines are complete when they are given to this method.

Parameters
`lines`	`String`: The array containing the new lines.

setTrimLine

public void setTrimLine (boolean trim)

Set the trim lines flag.

Parameters
`trim`	`boolean`: whether the lines are trimmed, or not.