萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android AsyncTask 完整指南:異步任務四階段、泛型參數、取消機制與進度條實戰

AsyncTask 核心架構

AsyncTask<Params, Progress, Result> 是輕量級異步框架,內部封裝 Thread + Handler,適合**短時操作 (≤ 幾秒)**。長時間任務請用 ExecutorService、WorkManager 或 Coroutines。

三個泛型參數

  • Params:execute() 傳入的參數類型 (如 URL 字串陣列)
  • Progress:publishProgress() 發布的進度類型 (如 Integer 百分比)
  • Result:doInBackground() 返回的結果類型 (如 Bitmap)

四大生命週期回調 (按執行順序)

  1. onPreExecute() → **主線程**,任務啟動前初始化 (顯示 ProgressDialog)。
  2. doInBackground(Params...) → **背景執行緒**,執行耗時操作,**不可操作 UI**,可呼叫 publishProgress()。
  3. onProgressUpdate(Progress...) → **主線程**,接收進度更新 UI (進度條)。
  4. onPostExecute(Result) → **主線程**,任務完成處理結果 (隱藏 Dialog、更新列表)。

基礎範例:下載圖片 + 等待框

private static class DownloadImageTask extends AsyncTask<String, Void, Bitmap> {
    private final WeakReference<ImageView> ivRef;
    private final WeakReference<ProgressDialog> dialogRef;

    DownloadImageTask(ImageView iv, ProgressDialog dialog) {
        ivRef = new WeakReference<>(iv);
        dialogRef = new WeakReference<>(dialog);
    }

    @Override protected void onPreExecute() {
        dialogRef.get()?.show();
    }

    @Override protected Bitmap doInBackground(String... urls) {
        try {
            URL url = new URL(urls[0]);
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setConnectTimeout(5000);
            InputStream is = conn.getInputStream();
            return BitmapFactory.decodeStream(is);
        } catch (Exception e) {
            Log.e("AsyncTask", "下載失敗", e);
            return null;
        }
    }

    @Override protected void onPostExecute(Bitmap bitmap) {
        dialogRef.get()?.dismiss();
        ImageView iv = ivRef.get();
        if (iv != null && bitmap != null) iv.setImageBitmap(bitmap);
    }
}

// 使用
new DownloadImageTask(imageView, progressDialog).execute(imageUrl);

進階範例:帶進度條的檔案下載

private static class DownloadFileTask extends AsyncTask<String, Integer, File> {
    private final WeakReference ctxRef;
    private final WeakReference dialogRef;

    DownloadFileTask(Context ctx, ProgressDialog dialog) {
        ctxRef = new WeakReference<>(ctx);
        dialogRef = new WeakReference<>(dialog);
    }

    @Override protected void onPreExecute() {
        ProgressDialog d = dialogRef.get();
        if (d != null) {
            d.setProgressStyle(ProgressDialog.STYLE_HORIZONTAL);
            d.setMax(100);
            d.show();
        }
    }

    @Override protected File doInBackground(String... params) {
        String urlStr = params[0];
        try {
            URL url = new URL(urlStr);
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            int total = conn.getContentLength();
            InputStream is = conn.getInputStream();
            File outFile = new File(ctxRef.get().getCacheDir(), "download.tmp");
            FileOutputStream fos = new FileOutputStream(outFile);

            byte[] buffer = new byte[4096];
            int len, downloaded = 0;
            while ((len = is.read(buffer)) != -1) {
                if (isCancelled()) break; // 支援取消
                fos.write(buffer, 0, len);
                downloaded += len;
                if (total > 0) publishProgress((int) (downloaded * 100L / total));
            }
            fos.close();
            is.close();
            return isCancelled() ? null : outFile;
        } catch (Exception e) {
            Log.e("AsyncTask", "下載異常", e);
            return null;
        }
    }

    @Override protected void onProgressUpdate(Integer... values) {
        dialogRef.get()?.setProgress(values[0]);
    }

    @Override protected void onPostExecute(File file) {
        dialogRef.get()?.dismiss();
        if (file != null) {
            Toast.makeText(ctxRef.get(), "下載完成:" + file.getAbsolutePath(), Toast.LENGTH_SHORT).show();
        }
    }

    @Override protected void onCancelled(File file) {
        dialogRef.get()?.dismiss();
        Toast.makeText(ctxRef.get(), "已取消", Toast.LENGTH_SHORT).show();
    }
}

取消機制詳解

  • task.cancel(true):true = 中斷執行緒 (Thread.interrupt()),false = 僅標記取消。
  • 在 doInBackground 定期檢查 isCancelled(),及時返回。
  • 取消後會回調 onCancelled(Result),**不會**呼叫 onPostExecute。

五大鐵律 (違者崩潰/異常)

  1. Task 必須在 **主線程** 建立並 execute()。
  2. **不可手動呼叫** 四大回調方法。
  3. 同一 Task 實例**只能 execute 一次**,重複執行拋 IllegalStateException。
  4. Activity 銷毀前應 cancel() 避免洩漏 (持有 View/Context 參考)。
  5. 大量/長時間任務**禁止使用 AsyncTask**,改用 ThreadPoolExecutor / WorkManager / Coroutines。

現代替代方案對比

方案優點缺點
Kotlin Coroutines結構化並發、取消傳播、語法簡潔、生命週期感知需學習協程概念
RxJava強大操作符、背壓、跨平台學習曲線陡、體積較大
WorkManager延遲/周期性、保證執行、系統優化不適用即時 UI 更新
AsyncTaskAPI 簡單、無依賴**已棄用 (API 30)**、記憶體洩漏風險、執行緒池固定

💡 **Google 官方建議**:新代碼使用 Coroutines 或 RxJava,舊代碼漸進式遷移。

copyright © 萬盛學電腦網 all rights reserved