【安卓笔记】AsyncTask

简介:

AsyncTask是android提供的一个处理异步任务的框架，相当于Handler+Thread。 相比而言，AsyncTask的优点是封装良好，代码简洁。

使用AsyncTask可以使你在后台执行耗时任务（doInBackground）并将结果反馈给UI线程（onPostExecute），方便UI线程更新界面，而不会阻塞UI线程。

文档中说AsyncTask只适合执行短时任务，如果你希望让线程长期运行在后台应该使用java.util.concurent并发包中的类，比如Executor,ThreadPoolExecutor和FutureTask。

---------------------------------------------------------------------------------------------------------------

API:

AsyncTask是个抽象类，如果你想使用的话必须显式继承它或者使用匿名内部类的方式。文档中将AsyncTask总结为 3个泛型参数（Params,Progress,Result）和 4个方法(doInBackground,onPreExecute,omPostExecute,onProgressUpdate).下面分别介绍：

类定义：

public abstract class AsyncTask<Params, Progress, Result>

泛型参数：

    Params:执行后台任务所需的参数。比如如果你是网络操作的话，maybe需要传入一个uri

    Progress:后台任务执行的进度。比如下载进度，通常是一个Integer,这个参数会被                  onProgressUpdate调用，然后去更新UI，比如ProgressBar或者progressDialog。

    Result:后台任务执行所返回的结果。比如你想下载一张图片，那可以将Result指定为Bitmap

如果你的AsyncTask不需要某个参数，可以直接指定为Void.

方法简介：

   void  onPreExecute():在后台任务执行之前会被调用，这个方法是由UI线程调用的，可以用来操作UI，比如你在这个方法里可以设置ProgressBar的可见性。

    Result doInBackground(Params ... params)：这个方法是AsyncTask类中唯一的一个抽象方法，开发者必须复写此方法。从名字上也可看出，这个方法用来执行后台耗时任务，工作在后台线程之上。onPreExecute执行完之后便会执行这个方法。这个方法中的参数是由主线程中调用AsyncTask类的execute方法时传进来的，方法返回的Result会被传递给onPostExecute，用来更新UI。另外这个方法中可以根据执行进度调用publishProgress方法将进度传递给onProgressUpdate方法，然后onProgressUpdate方法也会更新UI（通常是ProgressBar的进度）。

    void  onProgressUpdate(Progress... values):当你在doInbackground方法中调了publishProgress时，此方法会被调用。这个方法也是工作在UI线程上。通常用这个方法更新progressBar的进度以给用户一个友好提示。

    void  onPostExecute(Result result):后台任务执行完毕会调用此方法，参数即doInBackground方法返回的那个。这个方法用于更新UI。

除了上面4个方法，还有两个方法常用：

void onCancelled(Result result)： 这个方法是当用户取消了操作所执行。

final void publishProgress(Progress... values)：由doInBackground方法调用，及时发布后台任务的执行进度。不可以复写。

使用AsyncTask需要注意的问题：

• Task的实例必须在UI 线程中创建；
• execute方法必须在UI 线程中调用；
• 不要手动的调用onPreExecute(), onPostExecute(Result)，doInBackground(Params...), onProgressUpdate(Progress...)这几个方法；
• 该task只能被执行一次，多次调用execute时将会出现异常；
• 不要在doInBackground方法中更新UI。

这里特别需要注意的就是第四点，异步任务只能调用一次，否则会抛异常，看源码就一目了然了：

public final AsyncTask<Params, Progress, Result> executeOnExecutor(Executor exec,
            Params... params) {
        if (mStatus != Status.PENDING) {
            switch (mStatus) {
                case RUNNING:
                    throw new IllegalStateException("Cannot execute task:"
                            + " the task is already running.");
                case FINISHED:
                    throw new IllegalStateException("Cannot execute task:"
                            + " the task has already been executed "
                            + "(a task can be executed only once)");
            }
        }
    ... ...

所以你希望多次调用的话，只能new多个AsyncTask了，像这样：

new AsyncTask(){}.execute(..);

使用步骤：

1.继承AsyncTask类，在doInbackground方法中写好逻辑。

2.调用execute方法。

像这样：

new AsyncTask<Void, Void, Void>() {
    protected Void doInBackground(Void... params)
    {
        //TODO handle task
        return null;
    }
    @Override
    protected void onPostExecute(Void result) 
    {
        //TODO update UI
    }

}.execute(null);

以下载网络图片为例：

布局：

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity" >
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical" >
        <ImageView
            android:id="@+id/iv_show"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:layout_weight="1000" />
        <Button
            android:id="@+id/but_down"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:text="下载" />
    </LinearLayout>
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:gravity="center"
        android:orientation="vertical" >
        <ProgressBar
            android:id="@+id/pb"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:visibility="gone"
            android:layout_gravity="center" />
        <TextView
            android:id="@+id/tv_progress"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_gravity="center_horizontal"
            android:background="#fff"
            android:visibility="gone"
            android:text="下载进度："
            android:textColor="#000" />
    </LinearLayout>
</FrameLayout>

activity：

package com.example.asynctaskdemo4;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.DefaultHttpClient;
import android.app.Activity;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.graphics.BitmapFactory.Options;
import android.os.AsyncTask;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.ImageView;
import android.widget.ProgressBar;
import android.widget.TextView;
import android.widget.Toast;
public class MainActivity extends Activity implements OnClickListener
{
    private static final String PATH = "http://10.46.191.198:8080/demo.bmp";
    private Button but_down = null;
    private ImageView iv_show = null;
    private TextView tv_progress = null;
    private ProgressBar pb = null;
    @Override
    protected void onCreate(Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        but_down = (Button) findViewById(R.id.but_down);
        iv_show = (ImageView) findViewById(R.id.iv_show);
        tv_progress = (TextView) findViewById(R.id.tv_progress);
        pb = (ProgressBar) findViewById(R.id.pb);
        
        but_down.setOnClickListener(this);
    }
    @Override
    public void onClick(View v)
    {
        if (R.id.but_down == v.getId())
        {
            new DownloadImageTask().execute(PATH);
        }
    }
    private class DownloadImageTask extends AsyncTask<String, Integer, Bitmap>
    {
        @Override
        protected void onPostExecute(Bitmap result)
        {
            if (result != null)
            {
                tv_progress.setVisibility(View.GONE);
                pb.setVisibility(View.GONE);
                
                iv_show.setImageBitmap(result);
            } else
            {
                tv_progress.setVisibility(View.GONE);
                pb.setVisibility(View.GONE);
                Toast.makeText(MainActivity.this,"下载失败",0).show();
            }
        }
        @Override
        protected Bitmap doInBackground(String... params)
        {
            String path = params[0];
            HttpClient client = new DefaultHttpClient();
            HttpGet get = new HttpGet(path);
            try
            {
                HttpResponse resp = client.execute(get);
                if(resp.getStatusLine().getStatusCode() == 200)
                {
                    HttpEntity entity = resp.getEntity();
                    if(entity == null)
                    {
                        return null;
                    }
                    long total_length = entity.getContentLength();//获取文件总长
                    InputStream is = entity.getContent();
                    ByteArrayOutputStream bous = new ByteArrayOutputStream();
                    int len = 0;
                    byte[] buf = new byte[1024];
                    int current_len = 0;
                    int progress = 0;//当前下载进度
                    while((len = is.read(buf))!= -1)
                    {
                        current_len+=len;
                        bous.write(buf, 0, len);
                        //注意progress的写法哦
                        progress = (int) ((current_len/(float)total_length)*100);
                        this.publishProgress(progress);
                    }
                    is.close();
                    byte[] data = bous.toByteArray();
                    Options opts = new Options();
                    opts.inSampleSize = 2;//简单起见直接指定缩放比例
                    Bitmap bitmap = BitmapFactory.decodeByteArray(data, 0, data.length, opts);
                    return bitmap;
                }
            } catch (Exception e)
            {
                e.printStackTrace();
            }
            return null;
        }
        @Override
        protected void onProgressUpdate(Integer... values)
        {
            tv_progress.setText("下载进度:"+values[0]);
        }
        @Override
        protected void onPreExecute()
        {
            tv_progress.setVisibility(View.VISIBLE);
            pb.setVisibility(View.VISIBLE);
        }
    }
}

显示效果：