Swing计数器应用：showMessageDialog重复显示及复选框失效问题

嗨，我之前也踩过Swing UI阻塞的坑，咱们一步步拆解你的问题：

问题根源分析 #

你遇到的双对话框弹出、复选框无法正常启用的问题，核心是JOptionPane.showMessageDialog的模态特性——它会直接阻塞事件调度线程（EDT），而Swing的所有UI更新和事件处理都依赖这个线程。当你在复选框的事件方法里直接调用对话框时：

1. EDT被卡住，窗口置顶状态的更新没法及时完成；
2. 模态对话框弹出时的焦点转移，可能意外触发复选框的二次事件；
3. 加上EDT阻塞导致的UI状态不同步，最终出现复选框状态混乱的情况。

正确实现方式 #

我们需要调整事件处理顺序，并用异步方式弹出对话框，避免阻塞EDT。这里推荐用ItemListener（专门处理复选框选中状态变化）而非ActionListener，代码示例如下：

import javax.swing.*;
import java.awt.event.ItemEvent;
import java.awt.event.ItemListener;

public class SimpleCounterApp extends JFrame {
    private JCheckBox onTopCheckbox;

    public SimpleCounterApp() {
        initUI();
    }

    private void initUI() {
        setTitle("简易Swing计数器");
        setSize(300, 150);
        setDefaultCloseOperation(EXIT_ON_CLOSE);
        setLocationRelativeTo(null);

        onTopCheckbox = new JCheckBox("保持窗口置顶");
        onTopCheckbox.addItemListener(new ItemListener() {
            @Override
            public void itemStateChanged(ItemEvent e) {
                // 先获取复选框的最终状态
                boolean isOnTop = e.getStateChange() == ItemEvent.SELECTED;
                
                // 先完成窗口置顶状态设置（这一步要在对话框弹出前执行）
                setAlwaysOnTop(isOnTop);
                
                // 异步弹出对话框，把操作放到EDT事件队列末尾，避免阻塞当前UI更新
                SwingUtilities.invokeLater(() -> {
                    String message = isOnTop ? "On Top" : "Not On Top";
                    // 指定当前窗口为对话框父组件，确保模态关联正确
                    JOptionPane.showMessageDialog(SimpleCounterApp.this, message);
                });
            }
        });

        add(onTopCheckbox);
    }

    public static void main(String[] args) {
        // 确保UI在EDT上初始化，这是Swing的最佳实践
        SwingUtilities.invokeLater(() -> new SimpleCounterApp().setVisible(true));
    }
}

关键优化点说明 #

1. 用ItemListener替代ActionListener：它只会在复选框状态（选中/未选中）真正变化时触发，相比ActionListener（只要点击就触发）能精准避免不必要的事件重复。
2. 先更新窗口状态，再异步弹对话框：先完成setAlwaysOnTop的设置，再用SwingUtilities.invokeLater延后对话框弹出操作，确保EDT不会被阻塞，UI状态能及时同步。
3. 指定对话框父组件：把当前窗口作为对话框的父组件，避免对话框弹出时的焦点混乱，减少额外事件触发的概率。

额外注意事项 #

• 永远不要在EDT上执行阻塞操作（比如长时间计算、同步IO），模态对话框虽属于UI操作，但阻塞EDT会导致整个应用卡顿甚至状态异常；
• 不要在事件处理方法里手动修改复选框的选中状态（比如onTopCheckbox.setSelected(!isOnTop)），这会再次触发itemStateChanged事件，形成循环。

内容的提问来源于stack exchange，提问作者Michael Kellam