Swing 核心概念

在开始编码之前,理解几个核心概念至关重要。

MVC (Model-View-Controller) 设计模式

Swing 的组件设计遵循了 MVC 思想：

• Model (模型)：数据。JList 中显示的数据列表。
• View (视图)：组件的视觉表现。JList 的外观、颜色、字体等。
• Controller (控制器)：处理用户交互，当用户点击 JButton 时触发的事件。

在 Swing 中，View 和 Controller 通常被捆绑在一起，称为 UI Delegate，你可以通过继承 LookAndFeel 和 UIDefaults 来定制组件的外观。

重量级 vs. 轻量级组件

• 重量级组件：直接由操作系统（如 Windows, macOS）的窗口系统创建和管理，有自己的 native 窗口句柄。JFrame、JDialog。
• 轻量级组件：完全由 Java 代码在画布上绘制，没有自己的 native 窗口句柄。JButton、JPanel、JLabel。

Swing 大力推广轻量级组件，这使得应用程序在不同操作系统上能有一致的外观（Look and Feel），并且性能更好。

容器

容器是用于存放其他组件（包括其他容器）的特殊组件。

• 顶层容器：应用程序的窗口，不能被其他容器包含。
  • JFrame：一个主窗口，通常包含标题栏、菜单栏、边框等。
  • JDialog：一个对话框窗口，通常用于临时交互。
  • JApplet：已过时，用于在浏览器中运行的小程序。
  • JWindow：一个无边框、无标题栏的窗口，较少使用。
• 中间层容器：必须被顶层容器包含，用于组织和布局其他组件。
  • JPanel：最通用的容器，默认使用 FlowLayout。
  • JScrollPane：为组件（如 JTextArea）添加滚动条。
  • JSplitPane：一个可以分割两个组件的面板。
  • JTabbedPane：一个带有选项卡的面板。
  • JInternalFrame：在 JDesktopPane 中创建的 MDI（多文档界面）窗口。

布局管理器

布局管理器负责决定容器中组件的大小和位置。绝对定位（null 布局）是不推荐的，因为它会导致界面在不同分辨率和屏幕尺寸下错乱。

Swing 提供了多种内置布局管理器：

• FlowLayout：流式布局，组件从左到右、从上到下排列，像文字一样换行。JPanel 的默认布局。
• BorderLayout：边界布局，将容器分为东、南、西、北、中五个区域。JFrame 的默认布局。
• GridLayout：网格布局，将容器划分为一个等大小的网格，每个组件占据一个网格。
• GridBagLayout：最强大也最复杂的布局管理器，允许组件在网格中跨越多行多列，并提供精细的大小和对齐控制。
• BoxLayout：沿一个轴（X轴或Y轴）排列组件，可以创建垂直或水平堆叠的组件。
• GroupLayout：基于 GroupLayout 的设计器（如 NetBeans GUI Builder）使用的布局，通过平铺和分组来组织组件。

事件处理

Swing 采用事件监听器机制来处理用户交互。

1. 事件源：触发事件的组件，如 JButton。
2. 事件对象：封装了事件信息的对象，如 ActionEvent。
3. 事件监听器：一个实现了特定监听器接口（如 ActionListener）的对象，它包含了对事件发生时应该执行的操作。

工作流程： 事件源 (e.g., JButton) 添加 事件监听器 (e.g., new ActionListener())，当用户点击按钮时，事件源 创建一个 事件对象 并将其传递给所有已注册的 事件监听器，监听器中的 actionPerformed 方法就会被执行。

第一个 Swing 程序：Hello World

这是一个最简单的例子,展示了创建一个窗口并显示文本的基本步骤。

import javax.swing.*;
public class HelloWorldSwing {
    // 1. 创建并设置窗口
    private static void createAndShowGUI() {
        // 创建一个顶层容器 JFrame
        JFrame frame = new JFrame("HelloWorldSwing");
        // 当用户关闭窗口时，程序退出
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        // 2. 创建一个标签组件
        JLabel label = new JLabel("Hello World");
        // 将标签添加到窗口的内容面板中
        frame.getContentPane().add(label);
        // 3. 调整窗口大小以适应其内容
        frame.pack();
        // 4. 显示窗口
        frame.setVisible(true);
    }
    public static void main(String[] args) {
        // 确保GUI创建在事件分发线程上
        SwingUtilities.invokeLater(new Runnable() {
            public void run() {
                createAndShowGUI();
            }
        });
    }
}

关键点解释：

• JFrame.EXIT_ON_CLOSE：设置窗口的默认关闭操作。
• frame.getContentPane().add(label)：JFrame 的内容面板是 JRootPane 的一部分，所有组件都应该添加到内容面板中。
• frame.pack()：自动调整窗口大小，使其刚好能容纳所有添加的组件。
• SwingUtilities.invokeLater()：这是 Swing 编程的黄金法则！ 所有与 GUI 创建和更新相关的代码都必须在事件分发线程上执行。invokeLater 方法确保 createAndShowGUI() 会在 EDT 上安全地运行，避免多线程问题。

常用组件介绍

综合实例：一个简单的登录界面

这个例子将结合布局管理器、组件和事件处理。

import javax.swing.*;
import java.awt.*;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
public class LoginApp {
    public static void main(String[] args) {
        // 在EDT上创建GUI
        SwingUtilities.invokeLater(() -> {
            // 创建主窗口
            JFrame frame = new JFrame("登录");
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            frame.setSize(350, 200);
            frame.setLocationRelativeTo(null); // 居中显示
            // 使用 GroupLayout 作为布局管理器
            GroupLayout layout = new GroupLayout(frame.getContentPane());
            frame.getContentPane().setLayout(layout);
            layout.setAutoCreateGaps(true);
            layout.setAutoCreateContainerGaps(true);
            // 创建组件
            JLabel userLabel = new JLabel("用户名:");
            JTextField userField = new JTextField(15);
            JLabel passLabel = new JLabel("密码:");
            JPasswordField passField = new JPasswordField(15);
            JButton loginButton = new JButton("登录");
            JButton cancelButton = new JButton("取消");
            // 创建一个按钮组，虽然这里不需要互斥，但展示用法
            // ButtonGroup buttonGroup = new ButtonGroup();
            // 添加事件监听器
            loginButton.addActionListener(new ActionListener() {
                @Override
                public void actionPerformed(ActionEvent e) {
                    String username = userField.getText();
                    String password = new String(passField.getPassword());
                    // 简单的验证逻辑
                    if ("admin".equals(username) && "123456".equals(password)) {
                        JOptionPane.showMessageDialog(frame, "登录成功！", "提示", JOptionPane.INFORMATION_MESSAGE);
                    } else {
                        JOptionPane.showMessageDialog(frame, "用户名或密码错误！", "错误", JOptionPane.ERROR_MESSAGE);
                    }
                }
            });
            cancelButton.addActionListener(e -> {
                userField.setText("");
                passField.setText("");
            });
            // 使用 GroupLayout 进行布局
            // 水平组
            GroupLayout.SequentialGroup hGroup = layout.createSequentialGroup();
            GroupLayout.ParallelGroup labelsGroup = layout.createParallelGroup(GroupLayout.Alignment.TRAILING);
            labelsGroup.addComponent(userLabel);
            labelsGroup.addComponent(passLabel);
            GroupLayout.ParallelGroup fieldsGroup = layout.createParallelGroup();
            fieldsGroup.addComponent(userField);
            fieldsGroup.addComponent(passField);
            GroupLayout.ParallelGroup buttonsGroup = layout.createParallelGroup();
            buttonsGroup.addComponent(loginButton);
            buttonsGroup.addComponent(cancelButton);
            hGroup.addGroup(labelsGroup);
            hGroup.addGroup(fieldsGroup);
            hGroup.addGroup(buttonsGroup);
            layout.setHorizontalGroup(hGroup);
            // 垂直组
            GroupLayout.SequentialGroup vGroup = layout.createSequentialGroup();
            vGroup.addGroup(layout.createParallelGroup(GroupLayout.Alignment.BASELINE)
                    .addComponent(userLabel)
                    .addComponent(userField)
                    .addComponent(loginButton));
            vGroup.addGroup(layout.createParallelGroup(GroupLayout.Alignment.BASELINE)
                    .addComponent(passLabel)
                    .addComponent(passField)
                    .addComponent(cancelButton));
            layout.setVerticalGroup(vGroup);
            frame.setVisible(true);
        });
    }
}

代码解析：

1. GroupLayout：我们在这里使用了 GroupLayout，因为它可以非常精确地控制组件的位置和对齐方式，它通过创建水平组和垂直组来工作。
2. JPasswordField：用于密码输入，输入的字符会被遮蔽。
3. JOptionPane：这是一个方便的对话框工具类，用于显示简单的消息、警告或错误提示，或者进行简单的输入。
4. Lambda 表达式：cancelButton.addActionListener(e -> { ... }); 是 Java 8+ 的简化写法，替代了匿名内部类，使代码更简洁。

进阶主题

多线程与 Swing

严禁在非事件分发线程上更新 Swing 组件！ 在一个耗时操作（如网络请求、文件读取）中直接更新 JLabel 的文本，会导致界面卡死甚至死锁。

正确做法： 使用 SwingWorker。 SwingWorker 是一个抽象类，专门用于在后台线程执行耗时任务，并在任务完成后自动在 EDT 上更新 UI。

// 示例：在后台执行一个耗时任务，并更新进度条
SwingWorker<Void, Integer> worker = new SwingWorker<Void, Integer>() {
    @Override
    protected Void doInBackground() throws Exception {
        for (int i = 0; i <= 100; i++) {
            // 模拟耗时操作
            Thread.sleep(50);
            // publish 方法会将中间值发送到 process 方法
            publish(i); 
        }
        return null;
    }
    @Override
    protected void process(List<Integer> chunks) {
        // 在EDT上执行，用于更新UI
        int latestValue = chunks.get(chunks.size() - 1);
        progressBar.setValue(latestValue);
    }
    @Override
    protected void done() {
        // 在EDT上执行，任务完成后调用
        try {
            get(); // 检查是否有异常
            label.setText("任务完成！");
        } catch (Exception e) {
            label.setText("任务失败: " + e.getMessage());
        }
    }
};
worker.execute(); // 启动后台任务

自定义绘制

如果标准组件无法满足需求,你可以通过继承 JComponent 并重写其 paintComponent(Graphics g) 方法来实现自定义绘制。

public class MyCustomComponent extends JComponent {
    @Override
    protected void paintComponent(Graphics g) {
        super.paintComponent(g); // 总是先调用父类方法
        // 将 Graphics 对象转换为 Graphics2D 以获得更多功能
        Graphics2D g2d = (Graphics2D) g;
        // 设置抗锯齿
        g2d.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
        // 绘制一个红色圆
        g2d.setColor(Color.RED);
        g2d.fillOval(10, 10, 80, 80);
        // 绘制一段文字
        g2d.setColor(Color.BLACK);
        g2d.drawString("Hello Custom Drawing!", 20, 120);
    }
}

Look and Feel (外观)

你可以轻松地更改整个应用程序的外观,使其看起来像 Windows、macOS 或 GTK 风格。

try {
    // 设置系统默认外观
    UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName());
} catch (Exception e) {
    e.printStackTrace();
}
// 或者设置跨平台的 Java 外观
// UIManager.setLookAndFeel(UIManager.getCrossPlatformLookAndFeelClassName());
// 在创建任何 GUI 组件之前设置 Look and Feel
JFrame frame = new JFrame("L&F Demo");
// ... 其余代码

开发工具和资源

• IDE：
  • IntelliJ IDEA：社区版免费，对 Swing 支持，有 GUI 设计器（虽然不如 NetBeans 强大）。
  • Eclipse：有插件支持 Swing 开发。
  • NetBeans IDE：曾经是 Swing 开发的王者，其内置的 GUI 设计器非常强大，可以通过拖拽的方式快速构建界面，并自动生成代码，对于初学者来说，NetBeans 是入门 Swing 的绝佳选择。
• 资源：
  • Oracle 官方教程：Java Tutorials - Creating a GUI With JFC/Swing：最权威、最全面的文档。
  • Swing 教程 - ZetCode：ZetCode Java Swing tutorial：提供大量实例，易于理解。
  • MDN Web Docs：[Java Swing](https://developer.mozilla.org/zh-CN/docs/Web/Java Swing)：虽然主要是 Web 技术，但也有不错的 Swing 概述。

Swing 是一个功能强大且成熟的 GUI 工具包，虽然它的 API 有些陈旧，但它的核心思想（如 EDT、布局管理器）至今仍然适用。

学习路径建议：

1. 掌握基础：理解 JFrame, JPanel, 常见组件和 FlowLayout/BorderLayout。
2. 学习事件处理：熟练使用 ActionListener 等基本监听器。
3. 深入布局：重点掌握 GridBagLayout 和 BoxLayout，它们是构建复杂界面的关键。
4. 实践项目：尝试开发一个小的桌面应用，如记事本、图书管理系统等。
5. 探索进阶：学习 SwingWorker 和自定义绘制。

希望这份详细的指南能帮助你顺利开启 Java Swing 开发之旅！