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 java.lang.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 class	Loader.UnexpectedLoaderException Thrown when an unexpected exception is encountered during loading.

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(java.lang.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.
void	release(java.lang.Runnable postLoadAction) Releases the Loader, running postLoadAction on its thread.
<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(java.lang.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 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:

java.lang.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 void release(java.lang.Runnable postLoadAction)

Releases the Loader, running postLoadAction on its thread. This method should be called when the Loader is no longer required.

Parameters:

postLoadAction - A Runnable to run on the loader's thread when Loader.Loadable.load() is no longer running.

maybeThrowError

public void maybeThrowError()
                     throws java.io.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:

java.io.IOException - The error.

maybeThrowError

public void maybeThrowError(int minRetryCount)
                     throws java.io.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:

java.io.IOException - The error.