DataSourceException

Kotlin |Java

public class DataSourceException extends IOException

java.lang.Object
↳	kotlin.Throwable
	↳	java.lang.Exception
		↳	java.io.IOException
			↳	androidx.media3.datasource.DataSourceException

Known direct subclasses

`AssetDataSource.AssetDataSourceException`	Thrown when an `IOException` is encountered reading a local asset.
`ContentDataSource.ContentDataSourceException`	Thrown when an `IOException` is encountered reading from a content URI.
`FileDataSource.FileDataSourceException`	Thrown when a `FileDataSource` encounters an error reading a file.
`HttpDataSource.HttpDataSourceException`	Thrown when an error is encountered when trying to read from a `HttpDataSource`.
`RawResourceDataSource.RawResourceDataSourceException`	Thrown when an `IOException` is encountered reading from a raw resource.
`UdpDataSource.UdpDataSourceException`	Thrown when an error is encountered when trying to read from a `UdpDataSource`.

Known indirect subclasses

`CronetDataSource.OpenException`	Thrown when an error is encountered when trying to open a `CronetDataSource`.
`HttpDataSource.CleartextNotPermittedException`	Thrown when cleartext HTTP traffic is not permitted.
`HttpDataSource.InvalidContentTypeException`	Thrown when the content type is invalid.
`HttpDataSource.InvalidResponseCodeException`	Thrown when an attempt to open a connection results in a response code not in the 2xx range.
`HttpEngineDataSource.OpenException`	Thrown when an error is encountered when trying to open a `HttpEngineDataSource`.

Used to specify reason of a DataSource error.

Summary

Constants
`static final int`	`@UnstableApi POSITION_OUT_OF_RANGE = 2008` This field is deprecated. Use `ERROR_CODE_IO_READ_POSITION_OUT_OF_RANGE`.

static final int

@UnstableApi
POSITION_OUT_OF_RANGE = 2008

This field is deprecated.

Use ERROR_CODE_IO_READ_POSITION_OUT_OF_RANGE.

Public fields
`final int`	`@PlaybackException.ErrorCode reason` The reason of this `DataSourceException`, should be one of the `ERROR_CODE_IO_*` in `PlaybackException.ErrorCode`.

Public constructors
`@UnstableApi DataSourceException(@PlaybackException.ErrorCode int reason)` Constructs a DataSourceException.
`@UnstableApi DataSourceException( @Nullable Throwable cause, @PlaybackException.ErrorCode int reason )` Constructs a DataSourceException.
`@UnstableApi DataSourceException( @Nullable String message, @PlaybackException.ErrorCode int reason )` Constructs a DataSourceException.
`@UnstableApi DataSourceException( @Nullable String message, @Nullable Throwable cause, @PlaybackException.ErrorCode int reason )` Constructs a DataSourceException.

Public methods
`static boolean`	`@UnstableApi isCausedByPositionOutOfRange(IOException e)` Returns whether the given `IOException` was caused by a `DataSourceException` whose `reason` is `ERROR_CODE_IO_READ_POSITION_OUT_OF_RANGE` in its cause stack.

From java.lang.Throwable

`synchronized final void`	`addSuppressed(Throwable exception)`
`synchronized Throwable`	`fillInStackTrace()`
`synchronized Throwable`	`getCause()`
`String`	`getLocalizedMessage()`
`String`	`getMessage()`
`StackTraceElement[]`	`getStackTrace()`
`synchronized final Throwable[]`	`getSuppressed()`
`synchronized Throwable`	`initCause(Throwable cause)`
`void`	`printStackTrace()`
`void`	`setStackTrace(StackTraceElement[] stackTrace)`
`String`	`toString()`

@UnstableApi
public static final int POSITION_OUT_OF_RANGE = 2008

Indicates that the starting position of the request was outside the bounds of the data.

@PlaybackException.ErrorCode
public final int reason

The reason of this DataSourceException, should be one of the ERROR_CODE_IO_* in PlaybackException.ErrorCode.

@UnstableApi
public DataSourceException(@PlaybackException.ErrorCode int reason)

Constructs a DataSourceException.

Parameters
`@PlaybackException.ErrorCode int reason`	Reason of the error, should be one of the `ERROR_CODE_IO_*` in `PlaybackException.ErrorCode`.

@UnstableApi
public DataSourceException(
    @Nullable Throwable cause,
    @PlaybackException.ErrorCode int reason
)

Constructs a DataSourceException.

Parameters
`@Nullable Throwable cause`	The error cause.
`@PlaybackException.ErrorCode int reason`	Reason of the error, should be one of the `ERROR_CODE_IO_*` in `PlaybackException.ErrorCode`.

@UnstableApi
public DataSourceException(
    @Nullable String message,
    @PlaybackException.ErrorCode int reason
)

Constructs a DataSourceException.

Parameters
`@Nullable String message`	The error message.
`@PlaybackException.ErrorCode int reason`	Reason of the error, should be one of the `ERROR_CODE_IO_*` in `PlaybackException.ErrorCode`.

@UnstableApi
public DataSourceException(
    @Nullable String message,
    @Nullable Throwable cause,
    @PlaybackException.ErrorCode int reason
)

Constructs a DataSourceException.

Parameters
`@Nullable String message`	The error message.
`@Nullable Throwable cause`	The error cause.
`@PlaybackException.ErrorCode int reason`	Reason of the error, should be one of the `ERROR_CODE_IO_*` in `PlaybackException.ErrorCode`.

@UnstableApi
public static boolean isCausedByPositionOutOfRange(IOException e)

Returns whether the given IOException was caused by a DataSourceException whose reason is ERROR_CODE_IO_READ_POSITION_OUT_OF_RANGE in its cause stack.