HttpDataSource.HttpDataSourceException

Artifact: androidx.media3:media3-datasource

View Source

---

Kotlin |Java

public class HttpDataSource.HttpDataSourceException extends DataSourceException

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

Known direct subclasses

CronetDataSource.OpenException, HttpDataSource.CleartextNotPermittedException, HttpDataSource.InvalidContentTypeException, HttpDataSource.InvalidResponseCodeException, HttpEngineDataSource.OpenException

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.

---

Thrown when an error is encountered when trying to read from a HttpDataSource.

Summary

Nested types
@Documented @Retention(value = RetentionPolicy.SOURCE) @Target(value = TYPE_USE) @IntDef(value = ) public annotation HttpDataSource.HttpDataSourceException.Type The type of operation that produced the error.

Constants
static final int	TYPE_CLOSE = 3 The error occurred in closing a HttpDataSource.
static final int	TYPE_OPEN = 1 The error occurred reading data from a HttpDataSource.
static final int	TYPE_READ = 2 The error occurred in opening a HttpDataSource.

Public fields
final DataSpec	@UnstableApi dataSpec The DataSpec associated with the current connection.
final int	@HttpDataSource.HttpDataSourceException.Type type

Public constructors
@UnstableApi HttpDataSourceException(     DataSpec dataSpec,     @HttpDataSource.HttpDataSourceException.Type int type ) This method is deprecated. Use HttpDataSourceException(DataSpec, PlaybackException.ERROR_CODE_IO_UNSPECIFIED, int).
@UnstableApi HttpDataSourceException(     IOException cause,     DataSpec dataSpec,     @HttpDataSource.HttpDataSourceException.Type int type ) This method is deprecated. Use HttpDataSourceException(IOException, DataSpec, PlaybackException.ERROR_CODE_IO_UNSPECIFIED, int).
@UnstableApi HttpDataSourceException(     DataSpec dataSpec,     @PlaybackException.ErrorCode int errorCode,     @HttpDataSource.HttpDataSourceException.Type int type ) Constructs an HttpDataSourceException.
@UnstableApi HttpDataSourceException(     String message,     DataSpec dataSpec,     @HttpDataSource.HttpDataSourceException.Type int type ) This method is deprecated. Use HttpDataSourceException(String, DataSpec, PlaybackException.ERROR_CODE_IO_UNSPECIFIED, int).
@UnstableApi HttpDataSourceException(     IOException cause,     DataSpec dataSpec,     @PlaybackException.ErrorCode int errorCode,     @HttpDataSource.HttpDataSourceException.Type int type ) Constructs an HttpDataSourceException.
@UnstableApi HttpDataSourceException(     String message,     IOException cause,     DataSpec dataSpec,     @HttpDataSource.HttpDataSourceException.Type int type ) This method is deprecated. Use HttpDataSourceException(String, IOException, DataSpec, PlaybackException.ERROR_CODE_IO_UNSPECIFIED, int).
@UnstableApi HttpDataSourceException(     String message,     DataSpec dataSpec,     @PlaybackException.ErrorCode int errorCode,     @HttpDataSource.HttpDataSourceException.Type int type ) Constructs an HttpDataSourceException.
@UnstableApi HttpDataSourceException(     String message,     @Nullable IOException cause,     DataSpec dataSpec,     @PlaybackException.ErrorCode int errorCode,     @HttpDataSource.HttpDataSourceException.Type int type ) Constructs an HttpDataSourceException.

Public methods
static HttpDataSource.HttpDataSourceException	@UnstableApi createForIOException(     IOException cause,     DataSpec dataSpec,     @HttpDataSource.HttpDataSourceException.Type int type ) Returns a HttpDataSourceException whose error code is assigned according to the cause and type.

Inherited Constants
From androidx.media3.datasource.DataSourceException static final int @UnstableApi POSITION_OUT_OF_RANGE = 2008 This field is deprecated. Use ERROR_CODE_IO_READ_POSITION_OUT_OF_RANGE.

Inherited fields
From androidx.media3.datasource.DataSourceException final int @PlaybackException.ErrorCode reason The reason of this DataSourceException, should be one of the ERROR_CODE_IO_* in PlaybackException.ErrorCode.

Inherited methods
From androidx.media3.datasource.DataSourceException 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()

Constants

TYPE_CLOSE

public static final int TYPE_CLOSE = 3

The error occurred in closing a HttpDataSource.

TYPE_OPEN

public static final int TYPE_OPEN = 1

The error occurred reading data from a HttpDataSource.

TYPE_READ

public static final int TYPE_READ = 2

The error occurred in opening a HttpDataSource.

Public fields

dataSpec

@UnstableApi
public final DataSpec dataSpec

The DataSpec associated with the current connection.

type

@HttpDataSource.HttpDataSourceException.Type
public final int type

Public constructors

HttpDataSourceException

@UnstableApi
public HttpDataSourceException(
    DataSpec dataSpec,
    @HttpDataSource.HttpDataSourceException.Type int type
)

This method is deprecated.

Use HttpDataSourceException(DataSpec, PlaybackException.ERROR_CODE_IO_UNSPECIFIED, int).

HttpDataSourceException

@UnstableApi
public HttpDataSourceException(
    IOException cause,
    DataSpec dataSpec,
    @HttpDataSource.HttpDataSourceException.Type int type
)

This method is deprecated.

Use HttpDataSourceException(IOException, DataSpec, PlaybackException.ERROR_CODE_IO_UNSPECIFIED, int).

HttpDataSourceException

@UnstableApi
public HttpDataSourceException(
    DataSpec dataSpec,
    @PlaybackException.ErrorCode int errorCode,
    @HttpDataSource.HttpDataSourceException.Type int type
)

Constructs an HttpDataSourceException.

Parameters
DataSpec dataSpec	The DataSpec.
@PlaybackException.ErrorCode int errorCode	Reason of the error, should be one of the ERROR_CODE_IO_* in .
@HttpDataSource.HttpDataSourceException.Type int type	See Type.

HttpDataSourceException

@UnstableApi
public HttpDataSourceException(
    String message,
    DataSpec dataSpec,
    @HttpDataSource.HttpDataSourceException.Type int type
)

This method is deprecated.

Use HttpDataSourceException(String, DataSpec, PlaybackException.ERROR_CODE_IO_UNSPECIFIED, int).

HttpDataSourceException

@UnstableApi
public HttpDataSourceException(
    IOException cause,
    DataSpec dataSpec,
    @PlaybackException.ErrorCode int errorCode,
    @HttpDataSource.HttpDataSourceException.Type int type
)

Constructs an HttpDataSourceException.

Parameters
IOException cause	The error cause.
DataSpec dataSpec	The DataSpec.
@PlaybackException.ErrorCode int errorCode	Reason of the error, should be one of the ERROR_CODE_IO_* in .
@HttpDataSource.HttpDataSourceException.Type int type	See Type.

HttpDataSourceException

@UnstableApi
public HttpDataSourceException(
    String message,
    IOException cause,
    DataSpec dataSpec,
    @HttpDataSource.HttpDataSourceException.Type int type
)

This method is deprecated.

Use HttpDataSourceException(String, IOException, DataSpec, PlaybackException.ERROR_CODE_IO_UNSPECIFIED, int).

HttpDataSourceException

@UnstableApi
public HttpDataSourceException(
    String message,
    DataSpec dataSpec,
    @PlaybackException.ErrorCode int errorCode,
    @HttpDataSource.HttpDataSourceException.Type int type
)

Constructs an HttpDataSourceException.

Parameters
String message	The error message.
DataSpec dataSpec	The DataSpec.
@PlaybackException.ErrorCode int errorCode	Reason of the error, should be one of the ERROR_CODE_IO_* in .
@HttpDataSource.HttpDataSourceException.Type int type	See Type.

HttpDataSourceException

@UnstableApi
public HttpDataSourceException(
    String message,
    @Nullable IOException cause,
    DataSpec dataSpec,
    @PlaybackException.ErrorCode int errorCode,
    @HttpDataSource.HttpDataSourceException.Type int type
)

Constructs an HttpDataSourceException.

Parameters
String message	The error message.
@Nullable IOException cause	The error cause.
DataSpec dataSpec	The DataSpec.
@PlaybackException.ErrorCode int errorCode	Reason of the error, should be one of the ERROR_CODE_IO_* in .
@HttpDataSource.HttpDataSourceException.Type int type	See Type.

Public methods

createForIOException

@UnstableApi
public static HttpDataSource.HttpDataSourceException createForIOException(
    IOException cause,
    DataSpec dataSpec,
    @HttpDataSource.HttpDataSourceException.Type int type
)

Returns a HttpDataSourceException whose error code is assigned according to the cause and type.