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.

HarnessRuntimeException

public class HarnessRuntimeException
extends Object implements IHarnessException

java.lang.Object
↳	com.android.tradefed.error.HarnessRuntimeException

Known direct subclasses

DeviceRuntimeException, FatalHostError, IFileResolverLoader.ResolverLoadingException, NetworkNotAvailableException, NoDeviceException, RunInterruptedException

DeviceRuntimeException	Thrown when a device action did not results in the expected results.
FatalHostError	An exception that indicates a fatal unrecoverable error has occurred on the host machine running TradeFederation, and that the TradeFederation instance should be shut down.
IFileResolverLoader.ResolverLoadingException	Exception thrown if a resolver cannot be loaded or initialized.
NetworkNotAvailableException	Thrown when a device is not able to connect to network for testing.
NoDeviceException	Thrown when there's no device to execute a given command.
RunInterruptedException	Thrown when a run operation is interrupted by an external request.

Known indirect subclasses

FileUtil.LowDiskSpaceException

FileUtil.LowDiskSpaceException Thrown if usable disk space is below minimum threshold.

Summary

Public constructors
`HarnessRuntimeException(String message, IHarnessException cause)` Constructor for the exception.
`HarnessRuntimeException(String message, ErrorIdentifier errorId)` Constructor for the exception.
`HarnessRuntimeException(String message, ErrorIdentifier defaultError, IHarnessException cause)` Constructor for the exception.
`HarnessRuntimeException(String message, Throwable cause, ErrorIdentifier errorId)` Constructor for the exception.

Public methods
`ErrorIdentifier`	`getErrorId()` Returns the `ErrorIdentifier` associated with the exception.
`String`	`getOrigin()` Returns the origin of the exception.
`String`	`toString()`

Protected methods
`final void`	`setCallerClass(Class<?> clazz)`

Public constructors

HarnessRuntimeException

public HarnessRuntimeException (String message, 
                IHarnessException cause)

Constructor for the exception.

Parameters
`message`	`String`: The message associated with the exception
`cause`	`IHarnessException`: The `IHarnessException` that caused the exception.

HarnessRuntimeException

public HarnessRuntimeException (String message, 
                ErrorIdentifier errorId)

Constructor for the exception.

Parameters
`message`	`String`: The message associated with the exception
`errorId`	`ErrorIdentifier`: The `ErrorIdentifier` categorizing the exception.

HarnessRuntimeException

public HarnessRuntimeException (String message, 
                ErrorIdentifier defaultError, 
                IHarnessException cause)

Constructor for the exception.

Parameters
`message`	`String`: The message associated with the exception.
`defaultError`	`ErrorIdentifier`: the `ErrorIdentifier` to apply if not set in the exception.
`cause`	`IHarnessException`: The `IHarnessException` that caused the exception.

HarnessRuntimeException

public HarnessRuntimeException (String message, 
                Throwable cause, 
                ErrorIdentifier errorId)

Constructor for the exception.

Parameters
`message`	`String`: The message associated with the exception
`cause`	`Throwable`: The cause of the exception
`errorId`	`ErrorIdentifier`: The `ErrorIdentifier` categorizing the exception.

Public methods

getErrorId

public ErrorIdentifier getErrorId ()

Returns the ErrorIdentifier associated with the exception. Can be null.

Returns
`ErrorIdentifier`

getOrigin

public String getOrigin ()

Returns the origin of the exception.

Returns
`String`

toString

public String toString ()

Returns
`String`

Protected methods

setCallerClass

protected final void setCallerClass (Class<?> clazz)

Parameters
`clazz`	`Class`