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();
Runnable refreshTask = () -> {
// 運行在 Handler 綁定線程 (主線程)
fetchDataAndUpdateUI();
// 循環執行:任務末尾重新 postDelayed
handler.postDelayed(this, 5000);
};
// 啟動
handler.postDelayed(refreshTask, 1000);
// 取消 (在 onDestroy/onStop)
handler.removeCallbacks(refreshTask);
// 當前在子線程,需在主線程更新 UI
handler.post(() -> {
textView.setText("完成");
progressBar.setVisibility(View.GONE);
});
// 推薦:從池獲取,減少 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); // 防洩漏
}
}
| 方法 | 作用 | 執行線程 | 常用場景 |
|---|---|---|---|
| sendMessage(Message) | 發送 Message 到隊列尾部 | Handler 綁定線程 | 子線程→主線程傳數據 |
| sendMessageDelayed(Message, long) | 延遲發送 Message | Handler 綁定線程 | 定時刷新、防抖 |
| sendEmptyMessage(int what) | 發送無數據信號 | Handler 綁定線程 | 簡單觸發、取消標記 |
| post(Runnable) | 立即執行 Runnable | Handler 綁定線程 | 切換到主線程執行 |
| postDelayed(Runnable, long) | 延遲執行 Runnable | Handler 綁定線程 | 定時任務、動畫延遲 |
| 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 | - | 高頻發送優化 |
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);
}
}
// 替代 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 至關重要。