Android多線程分析之五：使用AsyncTask異步下載圖像
羅朝輝 (http://m.shnenglu.com/kesalin/)
在本系列文章的第一篇《Android多線程分析之一：使用Thread異步下載圖像》中，曾演示了如何使用 Thread 來完成異步任務(wù)。Android 為了簡化在 UI 線程中完成異步任務(wù)（畢竟 UI 線程是 app 最重要的線程），實(shí)現(xiàn)了一個名為 AysncTask 的模板類。使用 AysncTask 能夠在異步任務(wù)進(jìn)行的同時，將任務(wù)進(jìn)度狀態(tài)反饋給 UI 線程（如讓 UI 線程更新進(jìn)度條）。正是由于它與 UI 線程緊密相關(guān)，使用的時候要就有一些限制，AysncTask 必須在 UI 線程中創(chuàng)建，并在 UI 線程中啟動（通過調(diào)用其 execute() 方法）；此外，AysncTask 設(shè)計的目的是用于一些耗時較短的任務(wù)，如果是耗時較長的任務(wù)不推薦使用 AysncTask。
可以用簡化記憶 “三參數(shù)，四步驟” 來學(xué)習(xí) AysncTask。 即帶有三個模板參數(shù) <Params, Progress, Result>，四個處理步驟：onPreExecute，doInBackground，onProgressUpdate，onPostExecute。
三參數(shù)：
Params 是異步任務(wù)所需的參數(shù)類型，也即 doInBackground(Params... params) 方法的參數(shù)類型；Progress 是指進(jìn)度的參數(shù)類型，也即 onProgressUpdate(Progress... values) 方法的參數(shù)類型；
Result 是指任務(wù)完成返回的參數(shù)類型，也即 onPostExecute(Result result) 或 onCancelled(Result result) 方法的參數(shù)類型。
如果某一個參數(shù)類型沒有意義或沒有被用到，傳遞 void 即可。
四步驟：
protected void onPreExecute()：在 UI 線程中運(yùn)行，在異步任務(wù)開始之前被執(zhí)行，以便 UI 線程完成一些初始化動作，如將進(jìn)度條清零；
protected abstract Result doInBackground(Params... params)：在后臺線程中運(yùn)行，這是完成異步任務(wù)的地方，它是抽象接口，子類必須提供實(shí)現(xiàn)；
protected void onProgressUpdate(Progress... values)：在 UI 線程中運(yùn)行，在異步任務(wù)執(zhí)行的過程中可以通過調(diào)用 void publishProgress(Progress... values) 方法通知 UI 線程在 onProgressUpdate 方法內(nèi)更新進(jìn)度狀態(tài)；
protected void onPostExecute(Result result)：在 UI 線程中運(yùn)行，當(dāng)異步任務(wù)完成之后被執(zhí)行，以便 UI 線程更新任務(wù)完成狀態(tài)。
AysncTask 支持取消異步任務(wù)，當(dāng)異步任務(wù)被取消之后，上面的步驟四就不會被執(zhí)行了，取而代之將執(zhí)行 onCancelled(Result result)，以便 UI 線程更新任務(wù)被取消之后的狀態(tài)。謹(jǐn)記：上面提到的這些方法都是回調(diào)函數(shù)，不需要用戶手動去調(diào)用。
以前的 AysncTask 是基于單一后臺線程實(shí)現(xiàn)的，而從 Android 3.0 起 AysncTask 是基于 Android 的并發(fā)庫（java.util.concurrent）實(shí)現(xiàn)的，本文中不會展開討論其具體實(shí)現(xiàn)，只是演示如何使用 AysncTask。
使用示例：
有了前面的輪廓介紹，再來使用 AysncTask 是非常容易的，下面的例子與 《使用Thread異步下載圖像》中的例子非常相似，只不過是使用 AysncTask 來完成異步任務(wù)罷了。
這是一個使用 AysncTask 從網(wǎng)絡(luò)上異步下載圖片并在 ImageView 中顯示的的簡單示例。因?yàn)樾枰L問網(wǎng)絡(luò)，所以要在 manifest.xml 中添加網(wǎng)絡(luò)訪問權(quán)限：
<uses-permission android:name="android.permission.INTERNET">
</uses-permission>
布局文件很簡單，一個 Button，一個 ImageView：<LinearLayout 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"
android:orientation="vertical"
android:padding="10dip" >
<Button
android:id="@+id/LoadButton"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="Load">
</Button>
<ImageView
android:id="@+id/ImageVivew"
android:layout_width="match_parent"
android:layout_height="400dip"
android:scaleType="centerInside"
android:padding="2dp">
</ImageView>
</LinearLayout>
接下來看代碼：
首先來看定義：圖片的 url 路徑，兩個消息值以及一些控件：
private static final String sImageUrl = "http://fashion.qqread.com/ArtImage/20110225/0083_13.jpg";
private Button mLoadButton;
private ImageView mImageView;
然后來看控件的設(shè)置： protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Log.i("UI thread", " >> onCreate()");
mImageView = (ImageView)this.findViewById(R.id.ImageVivew);
mLoadButton = (Button)this.findViewById(R.id.LoadButton);
mLoadButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
LoadImageTask task = new LoadImageTask(v.getContext());
task.execute(sImageUrl);
}
});
}
LoadImageTask 繼承自 AysncTask，由這個類去完成異步圖片下載任務(wù)，并相應(yīng)地更新 UI 狀態(tài)。 class LoadImageTask
extends AsyncTask<String, Integer, Bitmap>
{
private ProgressDialog mProgressBar;
LoadImageTask(Context context)
{
mProgressBar =
new ProgressDialog(context);
mProgressBar.setCancelable(
true);
mProgressBar.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL);
mProgressBar.setMax(100);
}
@Override
protected Bitmap doInBackground(String
params) {
Log.i("Load thread", " >> doInBackground()");
Bitmap bitmap =
null;
try{
publishProgress(10);
Thread.sleep(1000);
InputStream in =
new java.net.URL(sImageUrl).openStream();
publishProgress(60);
Thread.sleep(1000);
bitmap = BitmapFactory.decodeStream(in);
in.close();
}
catch (Exception e) {
e.printStackTrace();
}
publishProgress(100);
return bitmap;
}
@Override
protected void onCancelled() {
super.onCancelled();
}
@Override
protected void onPreExecute() {
mProgressBar.setProgress(0);
mProgressBar.setMessage("Image downloading
%0");
mProgressBar.show();
Log.i("UI thread", " >> onPreExecute()");
}
@Override
protected void onPostExecute(Bitmap result) {
Log.i("UI thread", " >> onPostExecute()");
if (result !=
null) {
mProgressBar.setMessage("Image downloading success!");
mImageView.setImageBitmap(result);
}
else {
mProgressBar.setMessage("Image downloading failure!");
}
mProgressBar.dismiss();
}
@Override
protected void onProgressUpdate(Integer
values) {
Log.i("UI thread", " >> onProgressUpdate() %" + values[0]);
mProgressBar.setMessage("Image downloading
%" + values[0]);
mProgressBar.setProgress(values[0]);
}
};
在 LoadImageTask 中，前面提到的四個步驟都涉及到了：
首先在任務(wù)開始之前在 onPreExecute() 方法中設(shè)置進(jìn)度條的初始狀態(tài)（UI線程）；然后在下載線程中執(zhí)行 doInBackground() 以完成下載任務(wù)，并在其中調(diào)用 publishProgress() 來通知 UI 線程更新進(jìn)度狀態(tài)；UI 線程在 onProgressUpdate() 中得知進(jìn)度，并更新進(jìn)度條（UI線程）；最后下載任務(wù)完成，UI 線程在 onPostExecute() 中得知下載好的圖像，并更新UI顯示該圖像（UI線程）。