萬盛學電腦網

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

Android Handler 常用方法詳解:post、postDelayed、sendMessage、handleMessage 實戰模式

Handler 三大核心使用模式

模式一:sendMessage + handleMessage — 傳遞數據

Handler handler = new Handler(Looper.getMainLooper()) {
    @Override
    public void handleMessage(@NonNull Message msg) {
        switch (msg.what) {
            case MSG_UPDATE_UI:
                String data = (String) msg.obj;
                int code = msg.arg1;
                updateUI(data, code);
                break;
            case MSG_SHOW_TOAST:
                Toast.makeText(ctx, (String) msg.obj, Toast.LENGTH_SHORT).show();
                break;
        }
    }
};

// 子線程發送
new Thread(() -> {
    Message msg = handler.obtainMessage(MSG_UPDATE_UI, 200, 0, "網絡請求成功");
    handler.sendMessage(msg);
    // 或延遲
    handler.sendMessageDelayed(msg, 3000);
}).start();

模式二:postDelayed(Runnable, delay) — 定時/延遲任務

Runnable refreshTask = () -> {
    // 運行在 Handler 綁定線程 (主線程)
    fetchDataAndUpdateUI();
    // 循環執行:任務末尾重新 postDelayed
    handler.postDelayed(this, 5000);
};

// 啟動
handler.postDelayed(refreshTask, 1000);

// 取消 (在 onDestroy/onStop)
handler.removeCallbacks(refreshTask);

模式三:post(Runnable) — 異步拋到主線程立即執行

// 當前在子線程,需在主線程更新 UI
handler.post(() -> {
    textView.setText("完成");
    progressBar.setVisibility(View.GONE);
});

Message 對象復用:obtainMessage / obtain

// 推薦:從池獲取,減少 GC
Message msg = handler.obtainMessage(WHAT, arg1, arg2, obj);
// 等價於
Message msg = Message.obtain(handler, WHAT, arg1, arg2, obj);

// 發送後自動回收池,無需手動 recycle() (除非手動 new Message())

完整示例:三種模式混用

public class MainActivity extends AppCompatActivity {
    private static final int MSG_UPDATE = 1;
    private static final int CANCEL_RUNNABLE = 99;
    private final Handler handler = new Handler(Looper.getMainLooper()) {
        @Override
        public void handleMessage(@NonNull Message msg) {
            if (msg.what == MSG_UPDATE) {
                Log.d("Handler", "收到消息: " + msg.obj);
                updateTitle((String) msg.obj);
            } else if (msg.what == CANCEL_RUNNABLE) {
                handler.removeCallbacks(updateRunnable);
                Log.d("Handler", "取消 Runnable");
            }
        }
    };

    private final Runnable updateRunnable = () -> {
        for (int i = 5; i < 15; i++) Log.d("Runnable", "i=" + i);
    };

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 模式一:子線程發送 Message
        new Thread(() -> {
            Message msg = handler.obtainMessage(MSG_UPDATE, "來自子線程");
            handler.sendMessage(msg);
        }).start();

        // 模式二:延遲執行 Runnable,隨後發送取消消息
        handler.postDelayed(updateRunnable, 1000);
        handler.sendEmptyMessageDelayed(CANCEL_RUNNABLE, 500); // 500ms 後取消

        // 模式三:立即 post (被上方取消前可能執行部分)
        // handler.post(updateRunnable); 
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        handler.removeCallbacksAndMessages(null); // 防洩漏
    }
}

關鍵 API 速查表

方法作用執行線程常用場景
sendMessage(Message)發送 Message 到隊列尾部Handler 綁定線程子線程→主線程傳數據
sendMessageDelayed(Message, long)延遲發送 MessageHandler 綁定線程定時刷新、防抖
sendEmptyMessage(int what)發送無數據信號Handler 綁定線程簡單觸發、取消標記
post(Runnable)立即執行 RunnableHandler 綁定線程切換到主線程執行
postDelayed(Runnable, long)延遲執行 RunnableHandler 綁定線程定時任務、動畫延遲
postAtTime(Runnable, long)在指定 uptimeMillis 執行Handler 綁定線程精確時間點調度
removeCallbacks(Runnable)移除待執行 Runnable-取消定時任務
removeMessages(int what)移除指定 what 的 Message-取消信號
removeCallbacksAndMessages(Object token)移除 token 相關所有-生命周期清理 (token=this)
hasMessages(int what)檢查隊列是否有指定 what-防重複發送
obtainMessage(...)從池獲取 Message-高頻發送優化

內存洩漏防範:靜態內部類 + WeakReference

static class SafeHandler extends Handler {
    private final WeakReference ref;
    SafeHandler(MainActivity act, Looper looper) { super(looper); ref = new WeakReference<>(act); }
    @Override public void handleMessage(@NonNull Message msg) {
        MainActivity act = ref.get();
        if (act != null) act.handleMsg(msg);
    }
}

現代替代:Kotlin Coroutines

// 替代 postDelayed 循環
lifecycleScope.launch {
    while (isActive) {
        delay(5000)
        updateTitle()
    }
}

// 替代 sendMessage 子線程通信
val result = withContext(Dispatchers.IO) { doNetworkRequest() }
withContext(Dispatchers.Main) { updateUI(result) }

總結

Handler 核心是 MessageQueue + Looper 循環。掌握 sendMessage (傳數據)、postDelayed (定時)、post (切線程) 三大模式,配合 obtainMessage 復用、removeCallbacksAndMessages 清理,能覆蓋 95% 異步通信場景。新代碼優先用協程,但理解 Handler 原理對維護舊代碼、閱讀框架源碼、調試 ANR 至關重要。

copyright © 萬盛學電腦網 all rights reserved