Android多線程分析之五：使用AsyncTask異步下載圖像

Android多線程分析之五：使用AsyncTask異步下載圖像

 

在本系列文章的第一篇《Android多線程分析之一：使用Thread異步下載圖像》中，曾演示了如何使用 Thread 來完成異步任務。Android 為了簡化在 UI 線程中完成異步任務（畢竟 UI 線程是 app 最重要的線程），實現了一個名為 AysncTask 的模板類。使用 AysncTask 能夠在異步任務進行的同時，將任務進度狀態反饋給 UI 線程（如讓 UI 線程更新進度條）。正是由於它與 UI 線程緊密相關，使用的時候要就有一些限制，AysncTask 必須在 UI 線程中創建，並在 UI 線程中啟動（通過調用其 execute() 方法）；此外，AysncTask 設計的目的是用於一些耗時較短的任務，如果是耗時較長的任務不推薦使用 AysncTask。

可以用簡化記憶 “三參數，四步驟” 來學習 AysncTask。 即帶有三個模板參數 ，四個處理步驟：onPreExecute，doInBackground，onProgressUpdate，onPostExecute。

三參數：

Params 是異步任務所需的參數類型，也即 doInBackground(Params... params) 方法的參數類型；Progress 是指進度的參數類型，也即 onProgressUpdate(Progress... values) 方法的參數類型；
Result 是指任務完成返回的參數類型，也即 onPostExecute(Result result) 或 onCancelled(Result result) 方法的參數類型。

如果某一個參數類型沒有意義或沒有被用到，傳遞 void 即可。

四步驟：

protected void onPreExecute()：在 UI 線程中運行，在異步任務開始之前被執行，以便 UI 線程完成一些初始化動作，如將進度條清零；
protected abstract Result doInBackground(Params... params)：在後台線程中運行，這是完成異步任務的地方，它是抽象接口，子類必須提供實現；
protected void onProgressUpdate(Progress... values)：在 UI 線程中運行，在異步任務執行的過程中可以通過調用 void publishProgress(Progress... values) 方法通知 UI 線程在 onProgressUpdate 方法內更新進度狀態；
protected void onPostExecute(Result result)：在 UI 線程中運行，當異步任務完成之後被執行，以便 UI 線程更新任務完成狀態。

AysncTask 支持取消異步任務，當異步任務被取消之後，上面的步驟四就不會被執行了，取而代之將執行 onCancelled(Result result)，以便 UI 線程更新任務被取消之後的狀態。謹記：上面提到的這些方法都是回調函數，不需要用戶手動去調用。

以前的 AysncTask 是基於單一後台線程實現的，而從 Android 3.0 起 AysncTask 是基於 Android 的並發庫（java.util.concurrent）實現的，本文中不會展開討論其具體實現，只是演示如何使用 AysncTask。

使用示例：

有了前面的輪廓介紹，再來使用 AysncTask 是非常容易的，下面的例子與 《使用Thread異步下載圖像》中的例子非常相似，只不過是使用 AysncTask 來完成異步任務罷了。

這是一個使用 AysncTask 從網絡上異步下載圖片並在 ImageView 中顯示的的簡單示例。因為需要訪問網絡，所以要在 manifest.xml 中添加網絡訪問權限：

布局文件很簡單，一個 Button，一個 ImageView：

 

 

接下來看代碼：

首先來看定義：圖片的 url 路徑，兩個消息值以及一些控件：

    private static final String sImageUrl = http://fashion.qqread.com/ArtImage/20110225/0083_13.jpg;
    private Button mLoadButton;
    private ImageView mImageView;

然後來看控件的設置：

 

	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，由這個類去完成異步圖片下載任務，並相應地更新 UI 狀態。

 

 

	class LoadImageTask extends AsyncTask 
	{
		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 中，前面提到的四個步驟都涉及到了：

首先在任務開始之前在 onPreExecute() 方法中設置進度條的初始狀態（UI線程）；然後在下載線程中執行 doInBackground() 以完成下載任務，並在其中調用 publishProgress() 來通知 UI 線程更新進度狀態；UI 線程在 onProgressUpdate() 中得知進度，並更新進度條（UI線程）；最後下載任務完成，UI 線程在 onPostExecute() 中得知下載好的圖像，並更新UI顯示該圖像（UI線程）。