Class FakeDataSource
- java.lang.Object
-
- com.google.android.exoplayer2.upstream.BaseDataSource
-
- com.google.android.exoplayer2.testutil.FakeDataSource
-
- All Implemented Interfaces:
DataReader,DataSource
public class FakeDataSource extends BaseDataSource
A fakeDataSourcecapable of simulating various scenarios. It uses aFakeDataSetinstance which determines the response to data access calls.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classFakeDataSource.FactoryFactory to create aFakeDataSource.
-
Constructor Summary
Constructors Constructor Description FakeDataSource()FakeDataSource(FakeDataSet fakeDataSet)FakeDataSource(FakeDataSet fakeDataSet, boolean isNetwork)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidclose()Closes the source.DataSpec[]getAndClearOpenedDataSpecs()Returns theDataSpecinstances passed toopen(DataSpec)since the last call to this method.FakeDataSetgetDataSet()UrigetUri()When the source is open, returns theUrifrom which data is being read.booleanisOpened()Returns whether the data source is currently opened.protected voidonClosed()Called when the source is closed.protected voidonDataRead(int bytesRead)Called when data is being read.longopen(DataSpec dataSpec)Opens the source to read the specified data.intread(byte[] buffer, int offset, int length)Reads up tolengthbytes of data from the input.-
Methods inherited from class com.google.android.exoplayer2.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 com.google.android.exoplayer2.upstream.DataSource
getResponseHeaders
-
-
-
-
Constructor Detail
-
FakeDataSource
public FakeDataSource()
-
FakeDataSource
public FakeDataSource(FakeDataSet fakeDataSet)
-
FakeDataSource
public FakeDataSource(FakeDataSet fakeDataSet, boolean isNetwork)
-
-
Method Detail
-
getDataSet
public final FakeDataSet getDataSet()
-
open
public final long open(DataSpec dataSpec) throws IOException
Description copied from interface:DataSourceOpens the source to read the specified data. If anIOExceptionis thrown, callers must still callDataSource.close()to ensure that any partial effects of the invocation are cleaned up.The following edge case behaviors apply:
- If the
requested positionis within the resource, but therequested lengthextends beyond the end of the resource, thenDataSource.open(com.google.android.exoplayer2.upstream.DataSpec)will succeed and data from the requested position to the end of the resource will be made available throughDataReader.read(byte[], int, int). - If the
requested positionis equal to the length of the resource, thenDataSource.open(com.google.android.exoplayer2.upstream.DataSpec)will succeed, andDataReader.read(byte[], int, int)will immediately returnC.RESULT_END_OF_INPUT. - If the
requested positionis greater than the length of the resource, thenDataSource.open(com.google.android.exoplayer2.upstream.DataSpec)will throw anIOExceptionfor whichDataSourceException.isCausedByPositionOutOfRange(java.io.IOException)will betrue.
- 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.lengthequalsC.LENGTH_UNSET) this value is the resolved length of the request, orC.LENGTH_UNSETif the length is still unresolved. For all other requests, the value returned will be equal to the request'sDataSpec.length. - Throws:
IOException- If an error occurs opening the source.DataSourceExceptioncan be thrown or used as a cause of the thrown exception to specify the reason of the error.
- If the
-
read
public final int read(byte[] buffer, int offset, int length) throws IOExceptionDescription copied from interface:DataReaderReads up tolengthbytes of data from the input.If
readLengthis zero then 0 is returned. Otherwise, if no data is available because the end of the opened range has been reached, thenC.RESULT_END_OF_INPUTis returned. Otherwise, the call will block until at least one byte of data has been read and the number of bytes read is returned.- Parameters:
buffer- A target array into which data should be written.offset- The offset into the target array at which to write.length- The maximum number of bytes to read from the input.- Returns:
- The number of bytes read, or
C.RESULT_END_OF_INPUTif the input has ended. This may be less thanlengthbecause the end of the input (or available data) was reached, the method was interrupted, or the operation was aborted early for another reason. - Throws:
IOException- If an error occurs reading from the input.
-
getUri
@Nullable public final Uri getUri()
Description copied from interface:DataSourceWhen the source is open, returns theUrifrom which data is being read. The returnedUriwill be identical to the one passedDataSource.open(DataSpec)in theDataSpecunless redirection has occurred. If redirection has occurred, theUriafter redirection is returned.- Returns:
- The
Urifrom which data is being read, or null if the source is not open.
-
close
public final void close()
Description copied from interface:DataSourceCloses the source. This method must be called even if the corresponding call toDataSource.open(DataSpec)threw anIOException.
-
getAndClearOpenedDataSpecs
public final DataSpec[] getAndClearOpenedDataSpecs()
Returns theDataSpecinstances passed toopen(DataSpec)since the last call to this method.
-
isOpened
public final boolean isOpened()
Returns whether the data source is currently opened.
-
onDataRead
protected void onDataRead(int bytesRead) throws IOExceptionCalled when data is being read.- Throws:
IOException
-
onClosed
protected void onClosed()
Called when the source is closed.
-
-