stanford.androidlib

Class SimpleTask

java.lang.Object

android.os.AsyncTask<String,Integer,Void>

stanford.androidlib.SimpleTask

public final class SimpleTask
extends AsyncTask<String,Integer,Void>

A simplified version of the AsyncTask class that does not require the use of generics or nested classes. A SimpleTask operates on a collection of string items. If you don't want to use strings, use the regular AsyncTask.

 SimpleTask.with(this).execute(item1, item2, ..., itemN);
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SimpleTask.TaskExecutor An interface for the object that actually runs the task.

Nested classes/interfaces inherited from class android.os.AsyncTask

AsyncTask.Status

Field Summary

Fields inherited from class android.os.AsyncTask

SERIAL_EXECUTOR, THREAD_POOL_EXECUTOR

Method Summary

Modifier and Type	Method and Description
protected Void	doInBackground(String... items) Runs the task in the background on the given set of items.
long	getElapsedTime() Returns the amount of time in MS that elapsed while this SimpleTask was running.
long	getEndTime() Returns the MS time at which this task finished running, as a long integer of MS since the epoch (Jan 1 1970 12:00:00am).
long	getStartTime() Returns the MS time at which this task began running, as a long integer of MS since the epoch (Jan 1 1970 12:00:00am).
protected void	onPostExecute(Void result) Called after the task ends.
protected void	onPreExecute() Called before the task begins.
protected void	onProgressUpdate(Integer... progress) Called when the task reports that progress has been made via its publishProgress method.
void	publishProgress(int progress) Your task code can call this to indicate that progress has been made.
static SimpleTask	with(SimpleActivity context) Returns a singleton SimpleTask instance bound to the given context.
static SimpleTask	with(SimpleFragment context) Returns a singleton SimpleTask instance bound to the given context.
static SimpleTask	with(SimpleTask.TaskExecutor context) Returns a singleton SimpleTask instance bound to the given context.

Methods inherited from class android.os.AsyncTask

cancel, execute, execute, executeOnExecutor, get, get, getStatus, isCancelled, onCancelled, onCancelled, publishProgress

Methods inherited from class java.lang.Object

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

Method Detail

with

public static SimpleTask with(SimpleActivity context)

Returns a singleton SimpleTask instance bound to the given context.

with

public static SimpleTask with(SimpleFragment context)

Returns a singleton SimpleTask instance bound to the given context.

with

public static SimpleTask with(SimpleTask.TaskExecutor context)

Returns a singleton SimpleTask instance bound to the given context.

doInBackground

protected Void doInBackground(String... items)

Runs the task in the background on the given set of items.

Specified by:

doInBackground in class AsyncTask<String,Integer,Void>

getElapsedTime

public long getElapsedTime()

Returns the amount of time in MS that elapsed while this SimpleTask was running. If the task has not yet finished running, returns -1.

getEndTime

public long getEndTime()

Returns the MS time at which this task finished running, as a long integer of MS since the epoch (Jan 1 1970 12:00:00am). If the task has not yet finished running, returns -1.

getStartTime

public long getStartTime()

Returns the MS time at which this task began running, as a long integer of MS since the epoch (Jan 1 1970 12:00:00am). If the task has not yet been started, returns -1.

onPreExecute

protected void onPreExecute()

Called before the task begins. This method logs the start time and calls your activity or context's onPreExecute method.

Overrides:

onPreExecute in class AsyncTask<String,Integer,Void>

onProgressUpdate

protected void onProgressUpdate(Integer... progress)

Called when the task reports that progress has been made via its publishProgress method. This method calls your activity or context's onProgressUpdate(int) method.

Overrides:

onProgressUpdate in class AsyncTask<String,Integer,Void>

onPostExecute

protected void onPostExecute(Void result)

Called after the task ends. This method logs the end time and calls your activity or context's onPostExecute method.

Overrides:

onPostExecute in class AsyncTask<String,Integer,Void>

publishProgress

public void publishProgress(int progress)

Your task code can call this to indicate that progress has been made.