Eclipse RCP/UI 開發中的線程模型深度解析：UI 線程、Job、進度報告與最佳實踐

Eclipse 基於 SWT 的原生線程模型要求所有 UI 操作必須在 UI 線程 (創建 Display 的線程) 執行，長耗時任務必須轉至後台線程。Eclipse 提供 Job、UIJob、IProgressService 等高級 API 封裝線程協調、進度報告、取消機制，本文系統講解核心概念與實戰模式。

1. SWT UI 線程 — 事件循環核心

public static void main(String[] args) {
    Display display = new Display();
    Shell shell = new Shell(display);
    shell.open();
    // 事件循環
    while (!shell.isDisposed()) {
        if (!display.readAndDispatch()) display.sleep();
    }
    display.dispose();
}

• UI 線程 = 創建 Display 的線程 (通常是 main)。
• 所有 Widget 操作 (setText、addListener、佈局) 必須在 UI 線程，否則拋 SWTException: Invalid thread access。
• 長任務阻塞 UI 線程會導致界面凍結、「未響應」。

2. Job — 後台任務框架 (org.eclipse.core.runtime.jobs)

基本用法

Job job = new Job("My Background Job") {
    @Override
    protected IStatus run(IProgressMonitor monitor) {
        System.out.println("Running in background thread");
        // 耗時操作...
        monitor.worked(10); // 進度更新
        return Status.OK_STATUS;
    }
};
job.setPriority(Job.SHORT); // 優先級: SHORT, LONG, DECORATE, BUILD
job.schedule(); // 盡快啟動

進階特性

• 進度監控：IProgressMonitor 支援 worked()、subTask()、isCanceled() (用戶點擊取消)。
• 取消響應：定期檢查 monitor.isCanceled() 返回 Status.CANCEL_STATUS。
• 監聽器：job.addJobChangeListener(new JobChangeAdapter() { public void done(IJobChangeEvent e) { ... } }) 獲取完成通知。
• 系統/用戶級別：job.setSystem(true) 後台靜默運行；setUser(true) 顯示進度對話框，用戶可選「後台運行」。
• 排程：job.schedule(60000) 延遲 60s；schedule(0) 立即。
• 同步等待：job.join() 阻塞當前線程直到 Job 完成，配合 job.getResult() 獲取狀態。

Job 執行時序說明

job.schedule();
System.out.println("After schedule");
// 輸出順序不確定：可能先打印 "Running..." 也可能先打印 "After schedule"

使用 join() 可強制同步。

3. 非 UI 線程中安全更新 UI 的三種方式

UIJob 範例

UIJob uiJob = new UIJob("Update Label") {
    @Override
    public IStatus runInUIThread(IProgressMonitor monitor) {
        label.setText("Updated from background"); // 直接操作 UI
        return Status.OK_STATUS;
    }
};
uiJob.schedule();

4. 進度報告最佳實踐 (JFace / Workbench)

非 UI 任務 + 忙碌游標

IProgressService service = PlatformUI.getWorkbench().getProgressService();
service.busyCursorWhile(new IRunnableWithProgress() {
    @Override
    public void run(IProgressMonitor monitor) {
        // 非 UI 耗時操作
    }
});

需 UI 操作的任務 + 模態對話框

service.runInUI(
    PlatformUI.getWorkbench().getProgressService(),
    new IRunnableWithProgress() {
        @Override
        public void run(IProgressMonitor monitor) {
            // 可安全操作 UI (如彈出對話框、修改編輯器)
        }
    },
    Platform.getWorkspace().getRoot() // 鎖定資源範圍
);

僅狀態欄顯示 (無彈窗)

Job job = new Job("Silent Job") { ... };
job.setUser(false); // 關鍵：非用戶級，不彈進度框
job.schedule();

5. 核心參考文檔

• Jobs API 指南
• JFace Operations
• Workbench Jobs 進度服務

核心原則：UI 線程只做 UI，耗時操作全扔 Job。善用 asyncExec/UIJob 回主線程更新界面，利用 IProgressService 提供統一進度體驗，遵循 Eclipse 線程模型即可構建流暢、健壯的 RCP 應用。