AsyncTask of Android
原文链接:http://developer.android.com/reference/android/os/AsyncTask.html
AsyncTask最好用于执行最多耗时几秒钟的操作。
AsyncTask是由在后台线程运行的计算定义的,计算结果将会公布到UI线程。
一个异步任务(An asynchronous task)由三个泛型(generic types)定义:Params,Progress 和 Result;任务的过程分为四步:onPreExecute,doInBackground,onProgressUpdate和onPostExecute。
AsyncTask必须通过创建一个子类来使用,这个子类最少重写一个方法(doInBackground(Params…)),在大部分情况下都会重写第二个方法(onPostExecute(Result))。
private class DownloadFilesTask extends AsyncTask<URL, Integer, Long> {
protected Long doInBackground(URL... urls) {
int count = urls.length;
long totalSize = 0;
for (int i = 0; i < count; i++) {
totalSize += Downloader.downloadFile(urls[i]);
publishProgress((int) ((i / (float) count) * 100));
// Escape early if cancel() is called
if (isCancelled()) break;
}
return totalSize;
}
protected void onProgressUpdate(Integer... progress) {
setProgressPercent(progress[0]);
}
protected void onPostExecute(Long result) {
showDialog("Downloaded " + result + " bytes");
}
}
创建完一个AsyncTasks后,通过如下代码执行:
new DownloadFilesTask().execute(url1, url2, url3);
AsyncTask’s generic types
- Params:在任务执行时,发送给任务的参数类型
- Progress:在后台计算的过程中公布的进展单元的类型
- Result:后台计算的结果的类型
不是所有的泛型在异步任务中都是被用到的。对于不需要用到的类型,通常使用Void
private class MyTask extends AsyncTask<Void, Void, Void> { ... }
The 4 steps
当一个异步任务被执行后,会经历4步
- onPreExecute:此方法会在异步任务执行前在UI线程上被调用,这一步通常用来设置任务,比如在用户界面展示一个loading对话框(Progress Bar)。
- doInBackground(Params…):onPreExecute结束后,此方法会立即在后台线程被调用。这一步是用来执行耗时很长的后台计算。异步任务的参数是在这一步被传入的。计算的结果必须在这一步返回,结果会传递到最后一步(onPostExecute(Result))。在这一步中可以调用publishProgress(Progress…)公布一个或多个进展单元。这些进展单元会通过第三步(onProgressUpdate(Progress…))公布在UI线程上。
- onProgressUpdate(Progress…):在publishProgress(Progress…)结束后,此方法会在UI线程上被调用。此方法执行的时间是不确定的。此方法用于以某种形式(如更新ProgressBar或更新日志)在用户界面展示任务执行的进度,此时后台计算仍在继续。
- onPostExecute(Result):当后台计算结束时,此方法会在UI线程上被调用。后台计算的结果会以参数的形式被传入这个方法。
Canceling a task
在任意时刻,我们都可以通过调用cancel(boolean)来取消一个任务。调用完此方法后,再调用isCancelled()会返回true。调用完此方法后,onCancelled(Object)会代替onPostExecute(Object)在doInBackground(Object[])结束后被调用。为了尽快知晓任务是否被取消,在doInBackground(Object[])方法中,我们需要经常性的检查isCancelled()的返回值。例如doInBackground(Object[])包含一个循环时。
Threading rules
- 一个任务实例(Task Instance)只能在UI线程上创建。
- execute(Params…)只能在UI线程上被调用。
- 不要手动调用onPreExecute(), onPostExecute(Result), doInBackground(Params…), onProgressUpdate(Progress…)
- 一个任务实例只可以被执行一次。
Memory observability
AsyncTask保证所有回调的执行都是同步的, the following operations are safe without explicit synchronizations.
- 在构造函数或onPreExecute()中设置成员字段,在doInBackground(Params…)中使用。
- 在doInBackground(Params…)中设置成员字段,在onProgressUpdate(Progress…)和onPostExecute(Result)中使用。
Order of execution
第一次推出AsyncTask时,所有的AsyncTasks在一个后台线程上连续的执行。从Android 1.6开始,改成在线程池里执行,允许多个线程并发执行。从Android3.0开始,为了避免并发执行带来的常见的程序错误,再次改为在一个线程上执行。