com.google.android.exoplayer.upstream

Class Loader

java.lang.Object

com.google.android.exoplayer.upstream.Loader

public final class Loader
extends Object

Manages the background loading of Loader.Loadables.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Loader.Callback Interface definition for a callback to be notified of Loader events.
static interface	Loader.Loadable Interface definition of an object that can be loaded using a Loader.
static class	Loader.UnexpectedLoaderException Thrown when an unexpected exception is encountered during loading.

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() Whether the Loader is currently loading a Loader.Loadable.
void	release() Releases the Loader.
void	release(Runnable postLoadAction) Releases the Loader, running postLoadAction on its thread.
void	startLoading(Loader.Loadable loadable, Loader.Callback callback) Invokes startLoading(Looper, Loadable, Callback), using the Looper associated with the calling thread.
void	startLoading(Looper looper, Loader.Loadable loadable, Loader.Callback callback) Start loading a Loader.Loadable.

Methods inherited from class java.lang.Object

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

Constructor Detail

Loader

public Loader(String threadName)

Parameters:

threadName - A name for the loader's thread.

Method Detail

startLoading

public void startLoading(Loader.Loadable loadable,
                         Loader.Callback callback)

Invokes startLoading(Looper, Loadable, Callback), using the Looper associated with the calling thread.

Parameters:

loadable - The Loader.Loadable to load.

callback - A callback to invoke when the load ends.

Throws:

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

startLoading

public void startLoading(Looper looper,
                         Loader.Loadable loadable,
                         Loader.Callback callback)

Start loading a Loader.Loadable.

A Loader instance can only load one Loader.Loadable at a time, and so this method must not be called when another load is in progress.

Parameters:

looper - The looper of the thread on which the callback should be invoked.

loadable - The Loader.Loadable to load.

callback - A callback to invoke when the load ends.

isLoading

public boolean isLoading()

Whether the Loader is currently loading a Loader.Loadable.

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(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.