Java GUI进度条搭配CompletableFuture、SwingWorker时直到异步任务结束才更新如何解决
问题原因
- 违反Swing单线程模型:
SwingWorker的doInBackground方法运行在后台工作线程,所有Swing组件的状态修改操作必须在事件调度线程(EDT)中执行,直接在后台线程调用progressBar.setValue()属于非线程安全操作,会导致更新不生效、界面卡顿甚至死锁等异常。 - 无延迟的死循环占用全部线程资源:现有代码的while循环没有任何休眠逻辑,会持续占满CPU资源,EDT线程得不到调度机会,就算有更新请求也无法及时处理,直到异步任务结束、循环终止后才能一次性处理所有积压的更新请求。
- 不必要的
paintImmediately调用:正常情况下Swing组件的setValue方法会自动触发重绘事件,手动调用paintImmediately反而会打乱Swing的原生重绘调度逻辑,加剧更新异常。
修复方案
- 用
SwingWorker自带的进度通知机制:调用setProgress()方法更新进度,绑定PropertyChangeListener监听进度变化,该监听器的回调自动运行在EDT线程,符合Swing线程规范。 - 循环中加入合理的休眠间隔:避免循环占满CPU,给EDT留出调度时间,同时也能让进度条的动画更符合人眼观感。
- 异步任务完成后强制把进度条设为100%,避免进度没跑完任务就结束的显示问题。
修复后代码
JProgressBar progressBar = new JProgressBar(); progressBar.setMinimum(0); progressBar.setMaximum(100); progressBar.setValue(0); progressBar.setStringPainted(true); CompletableFuture<NetworkToolsTableModel> completableFuture = CompletableFuture.supplyAsync(() -> asyncTask()); SwingWorker<Void, Integer> worker = new SwingWorker<>() { @Override protected Void doInBackground() throws Exception { int val = 0; while (!completableFuture.isDone()) { if (val < 95) { // 预留5%进度最后补全,避免任务还在运行进度就到100的违和感 val += 5; setProgress(val); // 用SwingWorker内置方法发送进度通知 } // 休眠间隔可根据需求调整,这里以200ms为例 Thread.sleep(200); } setProgress(100); // 任务完成后直接拉满进度 return null; } @Override protected void done() { // 如果需要获取asyncTask的返回值,可在该方法中调用completableFuture.get(),该方法运行在EDT线程 } }; // 监听进度变化事件,回调自动运行在EDT线程 worker.addPropertyChangeListener(event -> { if ("progress".equals(event.getPropertyName())) { int progress = (int) event.getNewValue(); progressBar.setValue(progress); } }); worker.execute();
内容的提问来源于stack exchange,提问作者FiddleBug
相关产品推荐
相关产品推荐

