tv.danmaku.ijk.media.drm.upstream

Class DefaultHttpDataSource

java.lang.Object

tv.danmaku.ijk.media.drm.upstream.BaseDataSource

tv.danmaku.ijk.media.drm.upstream.DefaultHttpDataSource

All Implemented Interfaces:

DataReader, DataSource, HttpDataSource

public class DefaultHttpDataSource
extends BaseDataSource
implements HttpDataSource

An HttpDataSource that uses Android's HttpURLConnection.

By default this implementation will not follow cross-protocol redirects (i.e. redirects from HTTP to HTTPS or vice versa). Cross-protocol redirects can be enabled by passing true to DefaultHttpDataSource.Factory.setAllowCrossProtocolRedirects(boolean).

Note: HTTP request headers will be set using all parameters passed via (in order of decreasing priority) the dataSpec, setRequestProperty(java.lang.String, java.lang.String) and the default properties that can be passed to HttpDataSource.Factory.setDefaultRequestProperties(Map).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DefaultHttpDataSource.Factory DataSource.Factory for DefaultHttpDataSource instances.

Nested classes/interfaces inherited from interface tv.danmaku.ijk.media.drm.upstream.HttpDataSource

HttpDataSource.BaseFactory, HttpDataSource.CleartextNotPermittedException, HttpDataSource.HttpDataSourceException, HttpDataSource.InvalidContentTypeException, HttpDataSource.InvalidResponseCodeException, HttpDataSource.RequestProperties

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_CONNECT_TIMEOUT_MILLIS The default connection timeout, in milliseconds.
static int	DEFAULT_READ_TIMEOUT_MILLIS The default read timeout, in milliseconds.

Constructor Summary

Constructors

Constructor and Description
DefaultHttpDataSource() Deprecated. Use DefaultHttpDataSource.Factory instead.
DefaultHttpDataSource(java.lang.String userAgent) Deprecated. Use DefaultHttpDataSource.Factory instead.
DefaultHttpDataSource(java.lang.String userAgent, int connectTimeoutMillis, int readTimeoutMillis) Deprecated. Use DefaultHttpDataSource.Factory instead.
DefaultHttpDataSource(java.lang.String userAgent, int connectTimeoutMillis, int readTimeoutMillis, boolean allowCrossProtocolRedirects, HttpDataSource.RequestProperties defaultRequestProperties) Deprecated. Use DefaultHttpDataSource.Factory instead.

Method Summary

Modifier and Type	Method and Description
protected long	bytesRead() Returns the number of bytes that have been read since the most recent call to open(DataSpec).
protected long	bytesRemaining() Returns the number of bytes that are still to be read for the current DataSpec.
protected long	bytesSkipped() Returns the number of bytes that have been skipped since the most recent call to open(DataSpec).
void	clearAllRequestProperties() Clears all request headers that were set by HttpDataSource.setRequestProperty(String, String).
void	clearRequestProperty(java.lang.String name) Clears the value of a request header.
void	close() Closes the source.
protected java.net.HttpURLConnection	getConnection() Returns the current connection, or null if the source is not currently opened.
int	getResponseCode() When the source is open, returns the HTTP response status code associated with the last HttpDataSource.open(tv.danmaku.ijk.media.drm.upstream.DataSpec) call.
java.util.Map<java.lang.String,java.util.List<java.lang.String>>	getResponseHeaders() When the source is open, returns the response headers associated with the last DataSource.open(tv.danmaku.ijk.media.drm.upstream.DataSpec) call.
android.net.Uri	getUri() When the source is open, returns the Uri from which data is being read.
long	open(DataSpec dataSpec) Opens the source to read the specified data.
int	read(byte[] buffer, int offset, int readLength) Reads up to length bytes of data from the input.
void	setContentTypePredicate(java.lang.String contentTypePredicate) Deprecated. Use DefaultHttpDataSource.Factory.setContentTypePredicate(String) instead.
void	setRequestProperty(java.lang.String name, java.lang.String value) Sets the value of a request header.

Methods inherited from class tv.danmaku.ijk.media.drm.upstream.BaseDataSource

addTransferListener, bytesTransferred, transferEnded, transferInitializing, transferStarted

Methods inherited from class java.lang.Object

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

Methods inherited from interface tv.danmaku.ijk.media.drm.upstream.DataSource

addTransferListener

Field Detail

DEFAULT_CONNECT_TIMEOUT_MILLIS

public static final int DEFAULT_CONNECT_TIMEOUT_MILLIS

The default connection timeout, in milliseconds.

See Also:

Constant Field Values

DEFAULT_READ_TIMEOUT_MILLIS

public static final int DEFAULT_READ_TIMEOUT_MILLIS

The default read timeout, in milliseconds.

See Also:

Constant Field Values

Constructor Detail

DefaultHttpDataSource

@Deprecated
public DefaultHttpDataSource()

Deprecated. Use DefaultHttpDataSource.Factory instead.

DefaultHttpDataSource

@Deprecated
public DefaultHttpDataSource(java.lang.String userAgent)

Deprecated. Use DefaultHttpDataSource.Factory instead.

DefaultHttpDataSource

@Deprecated
public DefaultHttpDataSource(java.lang.String userAgent,
                                         int connectTimeoutMillis,
                                         int readTimeoutMillis)

Deprecated. Use DefaultHttpDataSource.Factory instead.

DefaultHttpDataSource

@Deprecated
public DefaultHttpDataSource(java.lang.String userAgent,
                                         int connectTimeoutMillis,
                                         int readTimeoutMillis,
                                         boolean allowCrossProtocolRedirects,
                                         HttpDataSource.RequestProperties defaultRequestProperties)

Deprecated. Use DefaultHttpDataSource.Factory instead.

Method Detail

setContentTypePredicate

@Deprecated
public void setContentTypePredicate(java.lang.String contentTypePredicate)

Deprecated. Use DefaultHttpDataSource.Factory.setContentTypePredicate(String) instead.

getUri

public android.net.Uri getUri()

Description copied from interface: DataSource

When the source is open, returns the Uri from which data is being read. The returned Uri will be identical to the one passed DataSource.open(DataSpec) in the DataSpec unless redirection has occurred. If redirection has occurred, the Uri after redirection is returned.

Specified by:

getUri in interface DataSource

Returns:

The Uri from which data is being read, or null if the source is not open.

getResponseCode

public int getResponseCode()

Description copied from interface: HttpDataSource

When the source is open, returns the HTTP response status code associated with the last HttpDataSource.open(tv.danmaku.ijk.media.drm.upstream.DataSpec) call. Otherwise, returns a negative value.

Specified by:

getResponseCode in interface HttpDataSource

getResponseHeaders

public java.util.Map<java.lang.String,java.util.List<java.lang.String>> getResponseHeaders()

Description copied from interface: DataSource

When the source is open, returns the response headers associated with the last DataSource.open(tv.danmaku.ijk.media.drm.upstream.DataSpec) call. Otherwise, returns an empty map.

Key look-up in the returned map is case-insensitive.

Specified by:

getResponseHeaders in interface DataSource

Specified by:

getResponseHeaders in interface HttpDataSource

setRequestProperty

public void setRequestProperty(java.lang.String name,
                               java.lang.String value)

Description copied from interface: HttpDataSource

Sets the value of a request header. The value will be used for subsequent connections established by the source.

Note: If the same header is set as a default parameter in the HttpDataSource.Factory, then the header value set with this method should be preferred when connecting with the data source. See HttpDataSource.open(tv.danmaku.ijk.media.drm.upstream.DataSpec).

Specified by:

setRequestProperty in interface HttpDataSource

Parameters:

name - The name of the header field.

value - The value of the field.

clearRequestProperty

public void clearRequestProperty(java.lang.String name)

Description copied from interface: HttpDataSource

Clears the value of a request header. The change will apply to subsequent connections established by the source.

Specified by:

clearRequestProperty in interface HttpDataSource

Parameters:

name - The name of the header field.

clearAllRequestProperties

public void clearAllRequestProperties()

Description copied from interface: HttpDataSource

Clears all request headers that were set by HttpDataSource.setRequestProperty(String, String).

Specified by:

clearAllRequestProperties in interface HttpDataSource

open

public long open(DataSpec dataSpec)
          throws HttpDataSource.HttpDataSourceException

Opens the source to read the specified data.

Specified by:

open in interface DataSource

Specified by:

open in interface HttpDataSource

Parameters:

dataSpec - Defines the data to be read.

Returns:

The number of bytes that can be read from the opened source. For unbounded requests (i.e. requests where DataSpec.length equals C.LENGTH_UNSET) this value is the resolved length of the request, or C.LENGTH_UNSET if the length is still unresolved. For all other requests, the value returned will be equal to the request's DataSpec.length.

Throws:

HttpDataSource.HttpDataSourceException

read

public int read(byte[] buffer,
                int offset,
                int readLength)
         throws HttpDataSource.HttpDataSourceException

Description copied from interface: DataReader

Reads up to length bytes of data from the input.

If readLength is zero then 0 is returned. Otherwise, if no data is available because the end of the opened range has been reached, then C.RESULT_END_OF_INPUT is returned. Otherwise, the call will block until at least one byte of data has been read and the number of bytes read is returned.

Specified by:

read in interface DataReader

Specified by:

read in interface HttpDataSource

Parameters:

buffer - A target array into which data should be written.

offset - The offset into the target array at which to write.

readLength - The maximum number of bytes to read from the input.

Returns:

The number of bytes read, or C.RESULT_END_OF_INPUT if the input has ended. This may be less than length because the end of the input (or available data) was reached, the method was interrupted, or the operation was aborted early for another reason.

Throws:

HttpDataSource.HttpDataSourceException

close

public void close()
           throws HttpDataSource.HttpDataSourceException

Description copied from interface: DataSource

Closes the source.

Note: This method must be called even if the corresponding call to DataSource.open(DataSpec) threw an IOException. See DataSource.open(DataSpec) for more details.

Specified by:

close in interface DataSource

Specified by:

close in interface HttpDataSource

Throws:

HttpDataSource.HttpDataSourceException

getConnection

protected final java.net.HttpURLConnection getConnection()

Returns the current connection, or null if the source is not currently opened.

Returns:

The current open connection, or null.

bytesSkipped

protected final long bytesSkipped()

Returns the number of bytes that have been skipped since the most recent call to open(DataSpec).

Returns:

The number of bytes skipped.

bytesRead

protected final long bytesRead()

Returns the number of bytes that have been read since the most recent call to open(DataSpec).

Returns:

The number of bytes read.

bytesRemaining

protected final long bytesRemaining()

Returns the number of bytes that are still to be read for the current DataSpec.

If the total length of the data being read is known, then this length minus bytesRead() is returned. If the total length is unknown, C.LENGTH_UNSET is returned.

Returns:

The remaining length, or C.LENGTH_UNSET.