Android 中文 API (101) —— AsyncTask

矫情吗；* 2022-04-08 16:27 131阅读 0赞

**前言**

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

**声明**

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

农民伯伯：[http://over140.blog.51cto.com/][http_over140.blog.51cto.com]

Android中文翻译组：[http://goo.gl/6vJQl][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 任务参数

返回值

AsyncTask的实例

异常

IllegalStateException 如果getStatus()返回的是RUNNING或者FINISHED

public final Result **get** ()

等待计算结束并返回结果

返回值

计算结果

异常

CancellationException 如果计算取消

ExecutionException 如果计算抛出异常

InterruptedException 当等待时当前线程抛出异常

public final Result **get** (long timeout, TimeUnit unit)

等待计算结束并返回结果，最长等待时间为：timeOut（超时时间）.

参数

timeout 计算等待超时时间

unit 超时的时间单位

返回值

计算结果

异常

CancellationException 如果计算取消

ExecutionException 如果计算抛出异常

InterruptedException 当等待时当前线程抛出异常

TimeoutException 等待时间超时

public final AsyncTask.Status **getStatus** ()

获得任务的当前状态

返回值

当前状态

public final boolean **isCancelled** ()

如果在任务正常结束之前取消任务成功则返回true，否则返回false

返回值

如果任务正常结束之前取消任务成功返回true。

参见

`cancel(boolean)`

十、受保护方法

protected abstract Result **doInBackground** (Params... params)

覆盖此方法在后台线程执行计算，此方法中的参数是此任务的`execute(Params...)``方法的调用这传递的参数，此方法可以调用publishProgress(Progress...)在`UI`线程中来更新数据`

参数

params 此任务的参数

返回值

返回一个由此任务子类定义的结果 Result

参见

`onPreExecute()`

`onPostExecute(Result)`

`publishProgress(Progress...)`

protected void **onCancelled** ()

此方法在UI线程中当`cancel(boolean)` 被调用后调用

参见

`cancel(boolean)`

`isCancelled()`

protected void **onPostExecute** (Result result)

此方法在UI线程中`doInBackground(Params...)`。方法调用之后调用，此方法中的参数的值是`doInBackground(Params...)``的返回值或者当此任务已经被取消或有异常发生时此参数值为空`null

参数

result 由`doInBackground(Params...)`计算出的操作的结果。

参见

`onPreExecute()`

`doInBackground(Params...)`

protected void **onPreExecute** ()

在方法`doInBackground(Params...)``调用之前调用`

参见

`onPostExecute(Result)`

`doInBackground(Params...)`

protected void **onProgressUpdate** (Progress... values)

该方法在UI线程中`publishProgress(Progress...)``被调用之后调用，该方法中的参数`values`是已经被传递到``publishProgress(Progress...)`中的参数

参数

values 进度表示值

参见

``　　　`publishProgress(Progress...)`

`doInBackground(Params...)`

protected final void **publishProgress** (Progress... values)

当调用`doInBackground(Params...)`在后台执行计算时会调用该方法，每当在UI线程中调用此方法时将触发`onProgressUpdate(Progress...)`方法的执行

参数

values 将进度值更新到UI

参见

`onProgressUpdate(Progress...)`

`doInBackground(Params...)`

十一、补充

文章精选

[Android AsyncTask理解][Android AsyncTask]

[TabActivity下在AsyncTask中使用ProgressDialog存在问题的解决方法][TabActivity_AsyncTask_ProgressDialog]

[小心，AsyncTask 不是萬能的][AsyncTask]\[blogspot\]

十二、公告

内部类、内部接口由于内容较少均不再单独发布。

**结束**

随着春节的结束，翻译组工作重新回到正轨，感谢大家的关注与支持！

——————————————————————————————————————————

**AsyncTask.Status**

一、结构

***public static final enum AsyncTask.Status extends Enum<E extends Enum<E>>***

java.lang.Object

java.lang.Enum<E extends java.lang.Enum<E>>

android.os.AsyncTask.Status

二、类概述

标志任务的当前状态，每个状态在任务的生命周期中只会出现一次。

三、枚举值

public static final AsyncTask.Status **FINISHED**

标志`onPostExecute(Result)`方法已经结束

public static final AsyncTask.Status **PENDING**

标志任务还没有执行

public static final AsyncTask.Status **RUNNING**

标志任务正在执行

[http_dev.10086.cn_blog_32546]: http://dev.10086.cn/blog/?32546
[http_over140.blog.51cto.com]: http://over140.blog.51cto.com/
[http_goo.gl_6vJQl]: http://goo.gl/6vJQl
[Android AsyncTask]: http://blog.csdn.net/zhenyongyuan123/archive/2010/08/30/5850389.aspx
[TabActivity_AsyncTask_ProgressDialog]: http://blog.liaoxiaoqi.com/?p=473
[AsyncTask]: http://ysl-paradise.blogspot.com/2010/09/asynctask.html