com.google.android.exoplayer.upstream

Class DataSpec

java.lang.Object

com.google.android.exoplayer.upstream.DataSpec

public final class DataSpec
extends Object

Defines a region of media data.

Field Summary

Fields

Modifier and Type	Field and Description
long	absoluteStreamPosition The absolute position of the data in the full stream.
static int	FLAG_ALLOW_GZIP Permits an underlying network stack to request that the server use gzip compression.
int	flags Request flags.
String	key A key that uniquely identifies the original stream.
long	length The length of the data.
long	position The position of the data when read from uri.
byte[]	postBody Body for a POST request, null otherwise.
Uri	uri Identifies the source from which data should be read.

Constructor Summary

Constructors

Constructor and Description
DataSpec(Uri uri) Construct a DataSpec for the given uri and with key set to null.
DataSpec(Uri uri, byte[] postBody, long absoluteStreamPosition, long position, long length, String key, int flags) Construct a DataSpec where position may differ from absoluteStreamPosition.
DataSpec(Uri uri, int flags) Construct a DataSpec for the given uri and with key set to null.
DataSpec(Uri uri, long absoluteStreamPosition, long position, long length, String key, int flags) Construct a DataSpec where position may differ from absoluteStreamPosition.
DataSpec(Uri uri, long absoluteStreamPosition, long length, String key) Construct a DataSpec where position equals absoluteStreamPosition.
DataSpec(Uri uri, long absoluteStreamPosition, long length, String key, int flags) Construct a DataSpec where position equals absoluteStreamPosition.

Method Summary

Modifier and Type	Method and Description
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

FLAG_ALLOW_GZIP

public static final int FLAG_ALLOW_GZIP

Permits an underlying network stack to request that the server use gzip compression.

Should not typically be set if the data being requested is already compressed (e.g. most audio and video requests). May be set when requesting other data.

When a DataSource is used to request data with this flag set, and if the DataSource does make a network request, then the value returned from DataSource.open(DataSpec) will typically be C.LENGTH_UNBOUNDED. The data read from DataSource.read(byte[], int, int) will be the decompressed data.

See Also:

Constant Field Values

uri

public final Uri uri

Identifies the source from which data should be read.

postBody

public final byte[] postBody

Body for a POST request, null otherwise.

absoluteStreamPosition

public final long absoluteStreamPosition

The absolute position of the data in the full stream.

position

public final long position

The position of the data when read from uri.

Always equal to absoluteStreamPosition unless the uri defines the location of a subset of the underyling data.

length

public final long length

The length of the data. Greater than zero, or equal to C.LENGTH_UNBOUNDED.

key

public final String key

A key that uniquely identifies the original stream. Used for cache indexing. May be null if the DataSpec is not intended to be used in conjunction with a cache.

flags

public final int flags

Request flags. Currently FLAG_ALLOW_GZIP is the only supported flag.

Constructor Detail

DataSpec

public DataSpec(Uri uri)

Construct a DataSpec for the given uri and with key set to null.

Parameters:

uri - uri.

DataSpec

public DataSpec(Uri uri,
                int flags)

Construct a DataSpec for the given uri and with key set to null.

Parameters:

uri - uri.

flags - flags.

DataSpec

public DataSpec(Uri uri,
                long absoluteStreamPosition,
                long length,
                String key)

Construct a DataSpec where position equals absoluteStreamPosition.

Parameters:

uri - uri.

absoluteStreamPosition - absoluteStreamPosition, equal to position.

length - length.

key - key.

DataSpec

public DataSpec(Uri uri,
                long absoluteStreamPosition,
                long length,
                String key,
                int flags)

Construct a DataSpec where position equals absoluteStreamPosition.

Parameters:

uri - uri.

absoluteStreamPosition - absoluteStreamPosition, equal to position.

length - length.

key - key.

flags - flags.

DataSpec

public DataSpec(Uri uri,
                long absoluteStreamPosition,
                long position,
                long length,
                String key,
                int flags)

Construct a DataSpec where position may differ from absoluteStreamPosition.

Parameters:

uri - uri.

absoluteStreamPosition - absoluteStreamPosition.

position - position.

length - length.

key - key.

flags - flags.

DataSpec

public DataSpec(Uri uri,
                byte[] postBody,
                long absoluteStreamPosition,
                long position,
                long length,
                String key,
                int flags)

Construct a DataSpec where position may differ from absoluteStreamPosition.

Parameters:

uri - uri.

postBody - postBody.

absoluteStreamPosition - absoluteStreamPosition.

position - position.

length - length.

key - key.

flags - flags.

Method Detail

toString

public String toString()

Overrides:

toString in class Object