Android 中文 API (101) —— AsyncTask

前言

　　本章内容是android.os.AsyncTask，版本为Android 2.3 r1，翻译来自"0_1"，欢迎访问它的博客："http://dev.10086.cn/blog/?32546"，再次感谢"0_1" ！期待你一起参与Android API的翻译，联系我over140@gmail.com。

声明

　　欢迎转载，但请保留文章原始出处:)

　　　　博客园：http://www.cnblogs.com/

　　　　Android中文翻译组：http://goo.gl/6vJQl

正文

　　一、结构

public abstract class AsyncTask extends Object

java.lang.Object

android.os.AsyncTask<Params, Progress, Result>

　　二、类概述

　　AsyncTask能够适当地、简单地用于 UI线程。这个类不需要操作线程(Thread)就可以完成后台操作将结果返回UI。

　　异步任务的定义是一个在后台线程上运行，其结果是在 UI线程上发布的计算。异步任务被定义成三种泛型类型： Params，Progress和 Result；和四个步骤： begin , doInBackground，processProgress 和end。

　　三、用法

　　　　AysncTask必须被继承使用。子类至少覆盖一个方法 (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));
         }
         return totalSize;
     }

     protected void onProgressUpdate(Integer... progress) {
         setProgressPercent(progress[0]);
     }

     protected void onPostExecute(Long result) {
         showDialog("Downloaded " + result + " bytes");
     }
}

　　　　一旦创建，一个任务执行起来就非常简单：

new DownloadFilesTask().execute(url1, url2, url3);

　　四、AsyncTask的泛型类型

　　这三个类型被用于一个异步任务，如下：

　　1. Params，启动任务执行的输入参数

　　2. Progress，后台任务执行的百分比

　　3. Result，后台计算的结果类型

　　在一个异步任务里，不是所有的类型总被用。假如一个类型不被使用，可以简单地使用 Void类型：

private class MyTask extends AsyncTask<Void, Void, Void> { ... }

　　五、4个步骤

　　　　当一个异步任务被执行，任务经过四各步骤：

　　　　1．onPreExecute()，在UI线程上调用任务后立即执行。这步通常被用于设置任务，例如在用户界面显示一个进度条。

　　　　2．doInBackground(Params...)，后台线程执行onPreExecute()完后立即调用，这步被用于执行较长时间的后台计算。异步任务的参数也被传到这步。计算的结果必须在这步返回，将传回到上一步。在执行过程中可以调用publishProgress(Progress...)来更新任务的进度。

　　　　3．onProgressUpdate(Progress...),一次呼叫 publishProgress(Progress...)后调用 UI线程。执行时间是不确定的。这个方法用于当后台计算还在进行时在用户界面显示进度。例如：这个方法可以被用于一个进度条动画或在文本域显示记录。

　　　　4．onPostExecute(Result), 当后台计算结束时，调用 UI线程。后台计算结果作为一个参数传递到这步。

　　六、线程规则

　　有一些线程规则必须去遵守，这个类才会正确的工作:

　　　　任务实例必须创建在 UI线程

　　　　　　execute(Params...)必须在UI线程上调用

　　　　不要手动调用onPreExecute(), onPostExecute(Result), doInBackground(Params...), onProgressUpdate(Progress...)

　　　　这个任务只执行一次（如果执行第二次将会抛出异常）

　　七、内部类

　　enum AsyncTask.Status

　　表示任务的当前状态

　　八、构造函数

　　public AsyncTask ()

　　创建一个新的异步任务。这个构造函数必须在UI线程上调用。

　　九、公共方法

　　public final boolean cancel (boolean mayInterruptIfRunning)

　　尝试取消这个任务的执行，如果这个任务已经结束或者已经取消或者不能被取消或者某些其他原因，那么将导致这个操作失败，当调用此方法时，此方法执行成功并且这个任务还没有执行，那么此任务将不再执行。如果任务已经开始，这时执行此操作传入的参数mayInterruptIfRunning为true，执行此任务的线程将尝试中断该任务。

　　参数

　　mayInterruptIfRunning 如果为true则正在执行的线程将会中断，如果false，则会允许正在执行的任务线程执行完毕。

　　返回值

如果此任务不能取消返回false，如果已经正常的执行完毕，返回true

　　参见

isCancelled()

　　 onCancelled()

　　public final AsyncTask<Params, Progress, Result> execute (Params... params)

　　用指定的参数来执行此任务，这个方法将会返回此任务本身，所以调用者可以拥有此任务的引用。此方法必须在UI线程中调用

　　参数

　　params 任务参数

　　返回值