com.google.android.exoplayer2.upstream

Class Loader

java.lang.Object

com.google.android.exoplayer2.upstream.Loader

All Implemented Interfaces:

LoaderErrorThrower

public final class Loader
extends Object
implements LoaderErrorThrower

Manages the background loading of Loader.Loadables.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Loader.Callback<T extends Loader.Loadable> A callback to be notified of Loader events.
static interface	Loader.Loadable An object that can be loaded using a Loader.
static interface	Loader.ReleaseCallback A callback to be notified when a Loader has finished being released.
static class	Loader.UnexpectedLoaderException Thrown when an unexpected exception or error is encountered during loading.

Nested classes/interfaces inherited from interface com.google.android.exoplayer2.upstream.LoaderErrorThrower

LoaderErrorThrower.Dummy

Field Summary

Fields

Modifier and Type	Field and Description
static int	DONT_RETRY
static int	DONT_RETRY_FATAL
static int	RETRY
static int	RETRY_RESET_ERROR_COUNT

Constructor Summary

Constructors

Constructor and Description
Loader(String threadName)

Method Summary

Modifier and Type	Method and Description
void	cancelLoading() Cancels the current load.
boolean	isLoading() Returns whether the Loader is currently loading a Loader.Loadable.
void	maybeThrowError() Throws a fatal error, or a non-fatal error if loading is currently backed off and the current Loader.Loadable has incurred a number of errors greater than the Loaders default minimum number of retries.
void	maybeThrowError(int minRetryCount) Throws a fatal error, or a non-fatal error if loading is currently backed off and the current Loader.Loadable has incurred a number of errors greater than the specified minimum number of retries.
void	release() Releases the Loader.
boolean	release(Loader.ReleaseCallback callback) Releases the Loader.
<T extends Loader.Loadable> long	startLoading(T loadable, Loader.Callback<T> callback, int defaultMinRetryCount) Starts loading a Loader.Loadable.

Methods inherited from class java.lang.Object

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

Field Detail

RETRY

public static final int RETRY

See Also:

Constant Field Values

RETRY_RESET_ERROR_COUNT

public static final int RETRY_RESET_ERROR_COUNT

See Also:

Constant Field Values

DONT_RETRY

public static final int DONT_RETRY

See Also:

Constant Field Values

DONT_RETRY_FATAL

public static final int DONT_RETRY_FATAL

See Also:

Constant Field Values

Constructor Detail

Loader

public Loader(String threadName)

Parameters:

threadName - A name for the loader's thread.

Method Detail

startLoading

public <T extends Loader.Loadable> long startLoading(T loadable,
                                                     Loader.Callback<T> callback,
                                                     int defaultMinRetryCount)

Starts loading a Loader.Loadable.

The calling thread must be a Looper thread, which is the thread on which the Loader.Callback will be called.

Type Parameters:

T - The type of the loadable.

Parameters:

loadable - The Loader.Loadable to load.

callback - A callback to be called when the load ends.

defaultMinRetryCount - The minimum number of times the load must be retried before maybeThrowError() will propagate an error.

Returns:

SystemClock.elapsedRealtime() when the load started.

Throws:

IllegalStateException - If the calling thread does not have an associated Looper.

isLoading

public boolean isLoading()

Returns whether the Loader is currently loading a Loader.Loadable.

cancelLoading

public void cancelLoading()

Cancels the current load. This method should only be called when a load is in progress.

release

public void release()

Releases the Loader. This method should be called when the Loader is no longer required.

release

public boolean release(Loader.ReleaseCallback callback)

Releases the Loader. This method should be called when the Loader is no longer required.

Parameters:

callback - A callback to be called when the release ends. Will be called synchronously from this method if no load is in progress, or asynchronously once the load has been canceled otherwise. May be null.

Returns:

True if callback was called synchronously. False if it will be called asynchronously or if callback is null.

maybeThrowError

public void maybeThrowError()
                     throws IOException

Description copied from interface: LoaderErrorThrower

Throws a fatal error, or a non-fatal error if loading is currently backed off and the current Loader.Loadable has incurred a number of errors greater than the Loaders default minimum number of retries. Else does nothing.

Specified by:

maybeThrowError in interface LoaderErrorThrower

Throws:

IOException - The error.

maybeThrowError

public void maybeThrowError(int minRetryCount)
                     throws IOException

Description copied from interface: LoaderErrorThrower

Throws a fatal error, or a non-fatal error if loading is currently backed off and the current Loader.Loadable has incurred a number of errors greater than the specified minimum number of retries. Else does nothing.

Specified by:

maybeThrowError in interface LoaderErrorThrower

Parameters:

minRetryCount - A minimum retry count that must be exceeded for a non-fatal error to be thrown. Should be non-negative.

Throws:

IOException - The error.