Summary: Ctors | Methods | Protected Methods | Inherited Methods | [Expand All]

Since: API Level 11

public abstract class

AsyncTaskLoader

extends Loader<D>

java.lang.Object
↳	android.content.Loader<D>
	↳	android.content.AsyncTaskLoader<D>

Known Direct Subclasses

CursorLoader

Class Overview

Abstract Loader that provides an AsyncTask to do the work.

Summary

Public Constructors
	AsyncTaskLoader(Context context)

Public Methods
boolean	cancelLoad() Attempt to cancel the current load task.
void	dump(String prefix, FileDescriptor fd, PrintWriter writer, String[] args) Print the Loader's state into the given stream.
abstract D	loadInBackground()
void	onCanceled(D data) Called if the task was canceled before it was completed.
void	setUpdateThrottle(long delayMS) Set amount to throttle updates by.

Protected Methods
void	onForceLoad() Subclasses must implement this to take care of requests to `forceLoad()`.
D	onLoadInBackground() Called on a worker thread to perform the actual load.

[Expand]

Inherited Methods

From class android.content.Loader

void	abandon() Tell the Loader that it is being abandoned.
String	dataToString(D data) For debugging, converts an instance of the Loader's data class to a string that can be printed.
void	deliverResult(D data) Sends the result of the load to the registered listener.
void	dump(String prefix, FileDescriptor fd, PrintWriter writer, String[] args) Print the Loader's state into the given stream.
void	forceLoad() Force an asynchronous load.
Context	getContext()
int	getId()
boolean	isAbandoned() Return whether this loader has been abandoned.
boolean	isReset() Return whether this load has been reset.
boolean	isStarted() Return whether this load has been started.
void	onAbandon() Subclasses implement this to take care of being abandoned.
void	onContentChanged() Called when `Loader.ForceLoadContentObserver` detects a change.
void	onForceLoad() Subclasses must implement this to take care of requests to `forceLoad()`.
void	onReset() Subclasses must implement this to take care of resetting their loader, as per `reset()`.
void	onStartLoading() Subclasses must implement this to take care of loading their data, as per `startLoading()`.
void	onStopLoading() Subclasses must implement this to take care of stopping their loader, as per `stopLoading()`.
void	registerListener(int id, OnLoadCompleteListener<D> listener) Registers a class that will receive callbacks when a load is complete.
void	reset() Resets the state of the Loader.
final void	startLoading() Starts an asynchronous load of the Loader's data.
void	stopLoading() Stops delivery of updates until the next time `startLoading()` is called.
boolean	takeContentChanged() Take the current flag indicating whether the loader's content had changed while it was stopped.
String	toString() Returns a string containing a concise, human-readable description of this object.
void	unregisterListener(OnLoadCompleteListener<D> listener) Remove a listener that was previously added with `registerListener(int, Loader.OnLoadCompleteListener)`.

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Called before the object's memory is reclaimed by the VM.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

Public Constructors

public AsyncTaskLoader (Context context)

Since: API Level 11

Public Methods

public boolean cancelLoad ()

Since: API Level 11

Attempt to cancel the current load task. See cancel(boolean) for more info. Must be called on the main thread of the process.

Cancelling is not an immediate operation, since the load is performed in a background thread. If there is currently a load in progress, this method requests that the load be cancelled, and notes this is the case; once the background thread has completed its work its remaining state will be cleared. If another load request comes in during this time, it will be held until the cancelled load is complete.

Returns

Returns false if the task could not be cancelled, typically because it has already completed normally, or because startLoading() hasn't been called; returns true otherwise.

public void dump (String prefix, FileDescriptor fd, PrintWriter writer, String[] args)

Since: API Level 11

Print the Loader's state into the given stream.

Parameters

prefix	Text to print at the front of each line.
fd	The raw file descriptor that the dump is being sent to.
writer	A PrintWriter to which the dump is to be set.
args	Additional arguments to the dump request.

public abstract D loadInBackground ()

Since: API Level 11

public void onCanceled (D data)

Since: API Level 11

Called if the task was canceled before it was completed. Gives the class a chance to properly dispose of the result.

public void setUpdateThrottle (long delayMS)

Since: API Level 11

Set amount to throttle updates by. This is the minimum time from when the last onLoadInBackground() call has completed until a new load is scheduled.

Parameters

delayMS	Amount of delay, in milliseconds.

Protected Methods

protected void onForceLoad ()

Since: API Level 11

Subclasses must implement this to take care of requests to forceLoad(). This will always be called from the process's main thread.

protected D onLoadInBackground ()

Since: API Level 11

Called on a worker thread to perform the actual load. Implementations should not deliver the result directly, but should return them from this method, which will eventually end up calling deliverResult(D) on the UI thread. If implementations need to process the results on the UI thread they may override deliverResult(D) and do so there.

Returns

Implementations must return the result of their load operation.

Apr	MAY	Jun
	01
2010	2011	2012

Interfaces

Classes

Exceptions

AsyncTaskLoader

Class Overview

Summary

Public Constructors

public AsyncTaskLoader (Context context)

Public Methods

public boolean cancelLoad ()

Returns

public void dump (String prefix, FileDescriptor fd, PrintWriter writer, String[] args)

Parameters

public abstract D loadInBackground ()

public void onCanceled (D data)

public void setUpdateThrottle (long delayMS)

Parameters

Protected Methods

protected void onForceLoad ()

protected D onLoadInBackground ()

Returns