Java Swing JDialog 對話框組件完整指南：從基礎用法到模態與非模態實戰

JDialog 核心概念

JDialog 是 Swing 中的對話框組件，用於從主窗口彈出次級窗口。與 JFrame 類似，均需通過 getContentPane() 獲取容器再添加組件。關鍵區別在於 模態：模態對話框會阻塞父窗口交互，直到對話框關閉；非模態則允許同時操作父窗口。

五種構造方法

// 常用構造器
JDialog()                                    // 無參，無父窗口，非模態
JDialog(Frame owner)                         // 指定父窗口，非模態
JDialog(Frame owner, boolean modal)          // 指定父窗口與模態性
JDialog(Frame owner, String title, boolean modal) // 完整指定
JDialog(Dialog owner)                        // 以 Dialog 為父窗口

基礎用法示例：模態確認對話框

public class ConfirmDialog extends JDialog {
    private boolean confirmed = false;
    
    public ConfirmDialog(JFrame parent, String message) {
        super(parent, "確認操作", true); // 模態
        setLayout(new BorderLayout());
        add(new JLabel(message), BorderLayout.CENTER);
        
        JPanel btnPanel = new JPanel();
        JButton okBtn = new JButton("確定");
        JButton cancelBtn = new JButton("取消");
        okBtn.addActionListener(e -> { confirmed = true; dispose(); });
        cancelBtn.addActionListener(e -> { confirmed = false; dispose(); });
        btnPanel.add(okBtn); btnPanel.add(cancelBtn);
        add(btnPanel, BorderLayout.SOUTH);
        
        pack(); // 自適應大小
        setLocationRelativeTo(parent); // 居中顯示
        setDefaultCloseOperation(DISPOSE_ON_CLOSE);
    }
    
    public boolean isConfirmed() { return confirmed; }
    
    // 靜態工廠方法簡化調用
    public static boolean showConfirm(JFrame parent, String msg) {
        ConfirmDialog dlg = new ConfirmDialog(parent, msg);
        dlg.setVisible(true); // 阻塞直到關閉
        return dlg.isConfirmed();
    }
}

完整可運行示例：主窗口彈出對話框

public class JDialogDemo {
    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> {
            JFrame frame = new JFrame("主窗口");
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            frame.setSize(400, 300);
            frame.setLayout(new FlowLayout());
            
            JButton btn = new JButton("彈出模態對話框");
            btn.addActionListener(e -> {
                JDialog dialog = new JDialog(frame, "標題", true);
                dialog.setLayout(new BorderLayout());
                dialog.add(new JLabel("這是一個模態對話框"), BorderLayout.CENTER);
                JButton closeBtn = new JButton("關閉");
                closeBtn.addActionListener(ev -> dialog.dispose());
                dialog.add(closeBtn, BorderLayout.SOUTH);
                dialog.pack();
                dialog.setLocationRelativeTo(frame);
                dialog.setVisible(true); // 阻塞點
            });
            
            frame.add(btn);
            frame.setVisible(true);
        });
    }
}

進階要點

常見坑點提醒

• 忘記 dispose()：導致內存洩漏，對話框無法被 GC 回收
• 模態對話框阻塞 EDT：長時間操作需放入後台線程，否則界面凍結
• 重複創建對話框：建議復用實例或使用工廠模式管理
• 父窗口為 null：導致對話框無法居中、任務欄圖標異常

掌握 JDialog 的模態機制與生命週期管理，是構建良好用戶交互體驗的基礎。實際項目中建議封裝通用對話框基類（如確認框、輸入框、進度框），統一風格與行為。

1. 上一篇文章： Tomcat 啟動源碼深度解析（三）：容器組件啟動流程與 Pipeline-Valve 機制
2. 下一篇文章： JavaWeb 回顧：EL 表達式語法、隱含對象與自定義函數完整指南

Java 綜合教學

Java 進階類設計：抽象類、final、嵌套類、枚舉、介面與 Lambda 完整指南

Java 進階類設計：抽象類、final、嵌套類、枚舉、介面

Java 異常處理核心知識：體系結構、分類、常用方法與最佳實踐

什麼是異常？ 程序運行期間出現的違背預期事件，導致正常流程中

Ant 數據類型詳解：PatternSet、FileSet、Selector、FileList、Path、Regexp 核心用法

Ant 核心數據類型：構建腳本靈活文件集合與路徑管理 Ant

Eclipse Tomcat 啟動失敗「Server at localhost failed to start」根因與解決方案

Eclipse Tomcat 啟動失敗「Server at