基于慢速服务器结果更新JPanel：用线程避免GUI阻塞

核心思路 #

Swing是单线程模型，所有UI操作必须在**事件调度线程（EDT）**执行，耗时的服务器请求必须放到独立后台线程处理。更新Shapes集合后，要回到EDT触发重绘，同时保证集合的线程安全。

推荐实现：使用SwingWorker #

虽然资料看似过时，但SwingWorker是Swing官方推荐的后台任务处理工具，专门解决后台耗时操作+UI更新的场景，至今依然是最优选择之一。

1. 实现SwingWorker子类处理后台请求

创建子类封装服务器请求逻辑，后台线程执行数据获取，EDT线程更新UI：

class ShapeFetchWorker extends SwingWorker<List<Shape>, Void> {
    private final MapPanel mapPanel;

    public ShapeFetchWorker(MapPanel mapPanel) {
        this.mapPanel = mapPanel;
    }

    // 后台线程执行：耗时的服务器请求
    @Override
    protected List<Shape> doInBackground() throws Exception {
        // 替换为你的实际服务器请求逻辑
        List<Shape> serverShapes = fetchShapesFromIndonesianServer();
        return serverShapes;
    }

    // EDT线程执行：更新UI
    @Override
    protected void done() {
        try {
            List<Shape> newShapes = get();
            // 更新MapPanel的形状集合并触发重绘
            mapPanel.updateShapes(newShapes);
            mapPanel.repaint();
        } catch (Exception e) {
            // 替换为实际的异常处理（比如弹窗提示用户）
            e.printStackTrace();
        }
    }

    // 模拟服务器请求方法，实际替换为你的API调用
    private List<Shape> fetchShapesFromIndonesianServer() throws InterruptedException {
        // 模拟2-8秒延迟
        Thread.sleep((long) (Math.random() * 6000 + 2000));
        // 示例：转换服务器返回数据为Shape列表
        List<Shape> shapes = new ArrayList<>();
        // shapes.add(new YourShapeImplementation(...));
        return shapes;
    }
}

2. 修改MapPanel保证线程安全

为避免多线程访问shapes集合时的并发问题，做以下调整：

public class MapPanel extends JPanel implements Pointable {
    // 替换为线程安全集合，或加锁保护访问
    private final List<Shape> shapes = new CopyOnWriteArrayList<>();
    // ... 其他原有代码不变 ...

    // 新增安全更新方法
    public void updateShapes(List<Shape> newShapes) {
        this.shapes.clear();
        this.shapes.addAll(newShapes);
    }

    @Override
    public void paintComponent(Graphics g) {
        super.paintComponent(g);
        g.drawImage(image, 0, 0, null);
        // CopyOnWriteArrayList保证遍历安全，无需额外锁
        for (Shape shape : shapes) {
            shape.draw((Graphics2D) g);
        }
    }

    // 移除无用的Runnable接口实现（JPanel不应作为后台线程执行体）
    // @Override public void run() {} 删掉这部分
}

3. 触发后台更新

在需要更新数据的时机（比如按钮点击、定时任务）启动Worker：

// 示例：按钮点击触发更新
refreshButton.addActionListener(e -> {
    new ShapeFetchWorker(mapPanel).execute();
});

为什么不推荐把JPanel设为Runnable？ #

JPanel是UI组件，它的所有方法（包括paintComponent）必须在EDT执行。把它放到独立线程运行会直接违反Swing单线程模型，导致不可预测的UI异常和线程安全问题，绝对不可取。

替代方案：CompletableFuture（Java 8+） #

如果偏好现代并发API，也可以用CompletableFuture实现，本质和SwingWorker逻辑一致：

CompletableFuture.supplyAsync(() -> {
    try {
        return fetchShapesFromIndonesianServer();
    } catch (InterruptedException ex) {
        throw new RuntimeException(ex);
    }
}).thenAccept(newShapes -> {
    // 强制回到EDT更新UI
    SwingUtilities.invokeLater(() -> {
        mapPanel.updateShapes(newShapes);
        mapPanel.repaint();
    });
});

内容的提问来源于stack exchange，提问作者Mr.Gomer