萬盛學電腦網

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

Android AsyncTask 正確取消與終止操作:isCancelled 檢查點模式

核心原則:協作式取消

`AsyncTask.cancel(true)` **只會設定內部標誌位**,**不會強制中斷執行緒**。必須在 `doInBackground()` 中**主動檢查 `isCancelled()`** 並提前返回。

完整可取消登入範例

public class LoginActivity extends AppCompatActivity {
    private EditText etUser, etPass;
    private ProgressDialog progressDialog;
    private LoginTask loginTask;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_login);
        etUser = findViewById(R.id.et_user);
        etPass = findViewById(R.id.et_pass);
        findViewById(R.id.btn_login).setOnClickListener(v -> attemptLogin());
    }

    private void attemptLogin() {
        String user = etUser.getText().toString().trim();
        String pass = etPass.getText().toString().trim();
        if (user.isEmpty() || pass.isEmpty()) {
            Toast.makeText(this, "請輸入帳號密碼", Toast.LENGTH_SHORT).show();
            return;
        }
        showProgressDialog();
        // 取消舊任務
        if (loginTask != null && loginTask.getStatus() != AsyncTask.Status.FINISHED) {
            loginTask.cancel(true);
        }
        loginTask = new LoginTask();
        loginTask.execute(user, pass);
    }

    private void showProgressDialog() {
        progressDialog = new ProgressDialog(this);
        progressDialog.setTitle("登入中");
        progressDialog.setMessage("請稍候...");
        progressDialog.setCancelable(true);
        progressDialog.setOnCancelListener(dialog -> {
            if (loginTask != null && loginTask.getStatus() != AsyncTask.Status.FINISHED) {
                loginTask.cancel(true);
            }
        });
        progressDialog.show();
    }

    private class LoginTask extends AsyncTask {
        // 參數:String... params (user, pass)
        // 進度:Integer (錯誤碼)
        // 結果:LoginResult (封裝類)

        @Override
        protected LoginResult doInBackground(String... params) {
            String username = params[0];
            String password = params[1];
            
            // 【檢查點 1】任務剛開始
            if (isCancelled()) return LoginResult.cancelled();

            try {
                URL url = new URL("https://api.example.com/login?u=" + URLEncoder.encode(username, "UTF-8") 
                    + "&p=" + URLEncoder.encode(password, "UTF-8"));
                HttpURLConnection conn = (HttpURLConnection) url.openConnection();
                conn.setConnectTimeout(5000);
                conn.setReadTimeout(10000);
                conn.connect();

                // 【檢查點 2】網路連接建立後
                if (isCancelled()) {
                    conn.disconnect();
                    return LoginResult.cancelled();
                }

                int responseCode = conn.getResponseCode();
                if (responseCode != 200) {
                    return LoginResult.error("HTTP " + responseCode);
                }

                // 【檢查點 3】讀取回應中 (長耗時操作建議循環檢查)
                BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream()));
                StringBuilder sb = new StringBuilder();
                String line;
                while ((line = reader.readLine()) != null) {
                    if (isCancelled()) { reader.close(); conn.disconnect(); return LoginResult.cancelled(); }
                    sb.append(line);
                }
                reader.close();
                conn.disconnect();

                // 解析 JSON
                JSONObject json = new JSONObject(sb.toString());
                boolean success = json.getBoolean("success");
                String msg = json.getString("message");
                if (success) {
                    String token = json.getString("token");
                    return LoginResult.success(token);
                } else {
                    return LoginResult.error(msg);
                }
            } catch (Exception e) {
                if (isCancelled()) return LoginResult.cancelled();
                return LoginResult.error(e.getMessage());
            }
        }

        @Override
        protected void onProgressUpdate(Integer... values) {
            // 可選:根據錯誤碼顯示 Toast
        }

        @Override
        protected void onPostExecute(LoginResult result) {
            dismissDialog();
            if (result == null || result.isCancelled()) return; // 被取消不處理
            if (result.isSuccess()) {
                // 保存 Token、跳轉主頁
                startActivity(new Intent(LoginActivity.this, MainActivity.class));
                finish();
            } else {
                Toast.makeText(LoginActivity.this, "登入失敗: " + result.getMessage(), Toast.LENGTH_LONG).show();
            }
        }

        @Override
        protected void onCancelled(LoginResult result) {
            dismissDialog();
            Toast.makeText(LoginActivity.this, "已取消登入", Toast.LENGTH_SHORT).show();
        }
    }

    private void dismissDialog() {
        if (progressDialog != null && progressDialog.isShowing()) {
            progressDialog.dismiss();
        }
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        if (loginTask != null && loginTask.getStatus() != AsyncTask.Status.FINISHED) {
            loginTask.cancel(true);
        }
    }

    // 簡單結果封裝
    static class LoginResult {
        boolean success, cancelled;
        String token, message;
        static LoginResult success(String token) { LoginResult r = new LoginResult(); r.success = true; r.token = token; return r; }
        static LoginResult error(String msg) { LoginResult r = new LoginResult(); r.success = false; r.message = msg; return r; }
        static LoginResult cancelled() { LoginResult r = new LoginResult(); r.cancelled = true; return r; }
        boolean isSuccess() { return success; }
        boolean isCancelled() { return cancelled; }
    }
}

關鍵檢查點位置

  1. 進入 `doInBackground` 開頭。
  2. 耗時操作前 (網路連接、大檔案讀寫、複雜計算迴圈)。
  3. 迴圈內每次迭代 (下載、解析大數據)。
  4. 阻塞性 API 呼叫後 (`Thread.sleep`、`wait`、鎖獲取)。

現代替代方案 (AsyncTask 已棄用 API 30)

  • Coroutines + Flow (Kotlin 首選):`job.cancel()`、協程結構化並發。
  • RxJava:`Disposable.dispose()`、操作符鏈自動傳播取消。
  • ExecutorService + Future:`future.cancel(true)` 中斷執行緒。
  • WorkManager:`WorkManager.cancelWorkById()` 系統級保證執行。

避坑提醒

  • 不要在 `onPreExecute`/`onPostExecute`/`onProgressUpdate` 做耗時操作,它們跑在主執行緒。
  • `cancel(true)` 傳 `true` 會嘗試 `Thread.interrupt()`,若你的阻塞操作響應中斷 (如 `Thread.sleep`、`Object.wait`、NIO Channel),會拋 `InterruptedException`,捕獲後應重設中斷標誌或直接返回。
  • Activity 銷毀時務必 `cancel(true)` 並持有 WeakReference 避免洩漏。
copyright © 萬盛學電腦網 all rights reserved