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  任务参数

  返回值

  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理解

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

                   小心,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://www.cnblogs.com/over140/archive/2011/02/17/1956634.html

时间: 2024-12-23 05:52:42

Android 中文 API (101) —— AsyncTask的相关文章

Android中文API(97)—— ContextMenu

前言 本章内容是android.view.ContextMenu,版本为Android 2.3 r1,翻译来自"Kun",再次感谢"Kun" !期待你一起参与Android 中文API的翻译,联系我over140@gmail.com.    声明 欢迎转载,但请保留文章原始出处:)  博客园:http://www.cnblogs.com/ Android中文翻译组:http://goo.gl/6vJQl   正文 一.结构 public interface Cont

Android 中文 API (100) —— ScrollView

前言 春节即至,谨代表Android中文翻译组全体同仁祝大家身体健康,工作顺利!从第一篇译稿2010年8月27发布至今天2011年1月27整5个月,共发布100篇译文,3个合集,在新的一年里,翻译组仍将坚持Android相关的翻译工作,秉承开源.合作.共享和坚持的信念打持久战,感谢大家的关心和支持! 本章内容是android.widget.ScrollView,版本为Android 2.3 r1,翻译来自"pengyouhong",再次感谢"pengyouhong"

Android 中文API (61) —— ViewSwitcher

前言 本章内容是 android.widget.ViewSwitcher,版本为Android 2.3 r1,翻译来自"ivanlee",再次感谢"ivanlee" !期待你一起参与Android中文API的翻译,联系我over140@gmail.com.   声明 欢迎转载,但请保留文章原始出处:)  博客园:http://www.cnblogs.com/ Android中文翻译组:http://code.taobao.org/project/view/404/

Android 中文API (69) —— BluetoothAdapter[蓝牙]

前言 本章内容是 android.bluetooth.BluetoothAdapter,为Android蓝牙部分的章节翻译.本地蓝牙设备的适配类,所有的蓝牙操作都要通过该类完成.版本为 Android 2.3 r1,翻译来自中山大学的"Android Club SYSU",欢迎访问他们的WIKI:http://www.android-wiki.net,再次感谢"Android Club SYSU"!期待你一起参与Android中文API的翻译,联系我 over140

Android 中文API (70) —— BluetoothDevice[蓝牙]

前言 本章内容是 android.bluetooth.BluetoothDevice,为Android蓝牙部分的章节翻译.蓝牙设备类,代表了蓝牙通讯国足中的远端设备.版本为 Android 2.3 r1,翻译来自中山大学的"Android Club SYSU",欢迎访问他们的WIKI:http://www.android-wiki.net,再次感谢"Android Club SYSU"!期待你一起参与Android中文API的翻译,联系我 over140@gmail

android中文api(80)——Gallery.LayoutParams

前言 本章内容是 android.widget.Gallery.LayoutParams,版本为Android 2.3 r1,翻译来自"我是谁",欢迎大家访问他的博客:http://blog.sina.com.cn/u/1744311365,再次感谢"我是谁" !期待你加入Android 中文API的翻译,联系我over140@gmail.com.   声明 欢迎转载,但请保留文章原始出处:)  博客园:http://www.cnblogs.com/ Android

Android 中文API (46) —— SimpleAdapter

前言 本章内容是 android.widget.SimpleAdapter,版本为Android 2.2 r1,翻译来自"德罗德",欢迎大家访问他的博客:http://sparkrico.javaeye.com/,再次感谢"德罗德" !期待你一起参与Android中文API的翻译,联系我over140@gmail.com.    声明 欢迎转载,但请保留文章原始出处:)  博客园:http://www.cnblogs.com/ Android中文翻译组:http:/

android中文api(79)——Gallery

前言 本章内容是 android.widget.Gallery,版本为Android 2.3 r1,翻译来自"henly.zhang",欢迎大家访问他的博客:http://www.blogjava.net/zlh320321,再次感谢"henly.zhang" !期待你加入Android 中文API的翻译,联系我over140@gmail.com.   声明 欢迎转载,但请保留文章原始出处:)  博客园:http://www.cnblogs.com/ Android

Android 中文 API 文档 (45) —— AbsoluteLayout.LayoutParams

前言 本章内容是 android.widget.AbsoluteLayout.LayoutParams,版本为Android 2.2 r1,翻译来自"绵白糖",再次感谢"绵白糖" !期待你一起参与Android中文API的翻译,联系我over140@gmail.com.    声明 欢迎转载,但请保留文章原始出处:)  博客园:http://www.cnblogs.com/ Android中文翻译组:http://code.taobao.org/project/vi