Java Swing教务管理系统开发指南：从MVC架构到数据库连接池实践

1. 项目概述与核心价值

最近在整理过往项目时，翻到了一个大学时期和同学一起做的课程设计——一个带图形界面的Java教务管理系统。当时觉得这玩意儿就是个“大作业”，但现在回过头看，它几乎囊括了从桌面应用到数据库交互的完整知识链条，是理解Java应用开发一个非常经典的练手项目。今天，我就把这个项目的完整实现思路、技术选型、踩过的坑以及一些可以优化的点，系统地梳理一遍。无论你是正在学习Java Swing和数据库的在校生，还是想重温一下桌面应用开发基础的在职开发者，这篇文章都能给你提供一份可以直接“抄作业”的详细指南。

这个系统的核心目标很简单：为教务管理人员提供一个可视化的操作界面，来管理学生、教师、课程和成绩等核心数据，并将这些数据持久化存储到数据库中。它要解决的核心问题，就是把原本可能需要在命令行或者Excel里进行的繁琐操作，变成一个直观、易用、且数据安全有保障的桌面软件。实现它，你需要串联起Java基础语法、Swing/AWT图形界面开发、JDBC数据库连接、SQL语句编写以及初步的MVC（模型-视图-控制器）架构思想。下面，我们就从零开始，一步步拆解这个系统。

2. 技术栈选型与项目架构设计

在动手写代码之前，定好技术栈和架构是避免后期返工的关键。对于这个项目，我们的选择其实非常经典和务实。

2.1 为什么选择Swing而不是JavaFX或其他？

首先看界面。Java生态里做桌面GUI，主流的有AWT、Swing和JavaFX。AWT太古老，依赖本地系统组件，跨平台表现不一致，基本被淘汰了。JavaFX很现代，功能强大，但它在JDK 11之后被剥离出了标准JDK，需要单独引入依赖，对于初学者来说环境配置多了一步，且其FXML布局方式对新手有一定学习曲线。Swing则是纯Java实现的，100%跨平台，组件丰富，从JDK 1.2时代起就是标准库的一部分，至今稳定。对于教务管理系统这类对界面美观度要求不是极高（不需要酷炫的动画和特效），但要求稳定、易开发、教学资源丰富的项目，Swing是性价比最高的选择。它的JFrame,JPanel,JTable,JButton等组件足以构建出清晰可用的管理界面。

2.2 数据库的选择：MySQL是最佳起点

数据库方面，热搜词里出现了Oracle、达梦、人大金仓等。对于学习和小型项目，MySQL或MariaDB是毫无争议的首选。原因有三：第一，完全免费开源，没有授权费用和复杂的安装限制；第二，社区活跃，资料和解决方案遍地都是，遇到问题几乎都能搜到答案；第三，轻量且性能足够，对于教务管理这种数据量（通常几千到几万条记录）的应用绰绰有余。像Oracle这类商业数据库，虽然强大，但配置复杂、资源占用高，并不适合入门练手。我们选择MySQL 8.0或5.7版本即可。

2.3 连接桥梁：JDBC与连接池

Java程序连接数据库，标准答案就是JDBC（Java Database Connectivity）。它是Java官方定义的一套操作数据库的接口，各个数据库厂商（如MySQL）提供对应的“驱动”来实现这些接口。我们只需要引入一个mysql-connector-java的JAR包，就能用一套统一的代码操作MySQL。但是，直接使用JDBC的DriverManager获取连接，在频繁操作的场景下会有性能问题，因为创建和销毁数据库连接是非常耗资源的。因此，在生产思维下，即使是个课程设计，我也强烈建议引入数据库连接池，比如HikariCP或者Druid。它们能预先建立好一批连接放在“池子”里，程序用的时候直接取，用完了还回去，而不是关闭，极大地提升了效率。这步操作能让你的项目瞬间显得更专业。

2.4 项目架构：迈向MVC的雏形

绝对不能把所有代码都堆在界面按钮的监听器里！那会变成一场维护噩梦。我们需要一个清晰的架构。虽然完整的MVC（Model-View-Controller）对于这个小项目可能有点重，但我们必须有意识地向这个方向靠拢。

• Model（模型）：对应数据库中的表，以及操作这些表的Java类（常称为实体类或POJO）。例如Student类，有id、name、major等属性，以及对应的getter/setter方法。
• View（视图）：就是我们用Swing构建的各个界面窗口，如“学生信息管理界面”。它只负责数据的展示和接收用户输入，不应该包含任何业务逻辑（比如计算成绩平均分）或数据库操作（比如执行INSERT语句）。
• Controller（控制器）：这是连接View和Model的桥梁。当用户在界面上点击“添加学生”按钮时，这个按钮的监听器（属于Controller层）会收集界面上的数据，然后调用一个专门处理学生业务的StudentService（服务层），再由这个服务层去调用操作数据库的StudentDao（数据访问对象，DAO层）。DAO层是唯一允许出现SQL语句的地方。

这样分层的好处是，如果哪天你想把Swing界面换成JavaFX甚至Web界面，只需要重写View层，Controller和Model层的代码几乎可以复用。同样，如果要从MySQL换到PostgreSQL，也主要改动DAO层的少量SQL语句和驱动即可。

3. 开发环境搭建与核心依赖配置

工欲善其事，必先利其器。一个顺手的开发环境能事半功倍。

3.1 IDE与JDK选择

IDE首推IntelliJ IDEA Community Edition（社区版），它对Java的支持和智能提示远超Eclipse，而且是免费的。JDK版本选择JDK 8或JDK 11的LTS（长期支持）版本，稳定性有保障。JDK 8的兼容性最好，JDK 11则是目前很多企业的主流选择。在IDEA中新建一个普通的Java项目即可，不需要用Maven或Gradle（当然，用了更好，便于依赖管理）。

3.2 MySQL数据库安装与初始化

去MySQL官网下载安装包，安装过程中记住你设置的root用户密码。安装完成后，使用命令行工具（如MySQL Shell）或图形化工具（如MySQL Workbench，或热搜词里的Navicat、DBeaver）连接数据库。 首先，为我们的项目创建一个专用的数据库和用户，这是一个好习惯，不要直接用root用户操作应用数据库。

CREATE DATABASE `educational_management` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'edu_admin'@'localhost' IDENTIFIED BY 'YourStrongPassword123!'; GRANT ALL PRIVILEGES ON `educational_management`.* TO 'edu_admin'@'localhost'; FLUSH PRIVILEGES;

这里使用utf8mb4字符集，可以支持存储Emoji等所有Unicode字符，避免中文乱码。collate规则选择utf8mb4_unicode_ci，排序比较准确。

3.3 数据库表结构设计

这是项目的基石，设计不好后期改起来很痛苦。我们至少需要以下几张核心表：

1. 学生表 (student)：student_id（主键），name，gender，birth_date，major，class_name，enrollment_date等。
2. 教师表 (teacher)：teacher_id（主键），name，title（职称），department（院系）。
3. 课程表 (course)：course_id（主键），course_name，credit（学分），teacher_id（外键，关联教师）。
4. 选课成绩表 (score)：id（主键），student_id（外键），course_id（外键），score（成绩），semester（学期）。这里(student_id, course_id, semester)可以组成一个联合唯一键，防止一个学生同一学期同一课程重复录入成绩。

建表SQL示例（学生表）：

USE educational_management; CREATE TABLE `student` ( `student_id` varchar(20) NOT NULL COMMENT '学号', `name` varchar(50) NOT NULL COMMENT '姓名', `gender` char(1) DEFAULT NULL COMMENT '性别（M/F）', `birth_date` date DEFAULT NULL COMMENT '出生日期', `major` varchar(100) DEFAULT NULL COMMENT '专业', `class_name` varchar(50) DEFAULT NULL COMMENT '班级', `enrollment_date` date DEFAULT NULL COMMENT '入学日期', PRIMARY KEY (`student_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='学生信息表';

3.4 引入JDBC驱动与连接池

去Maven仓库下载最新版的mysql-connector-java的JAR包（例如mysql-connector-java-8.0.33.jar）。同时，下载HikariCP的JAR包（例如HikariCP-5.0.1.jar）。 在IntelliJ IDEA中，在项目根目录下新建一个lib文件夹，把这两个JAR包放进去。然后，在项目结构中（File -> Project Structure -> Modules -> Dependencies），点击+号，选择JARs or directories，添加lib目录下的这两个JAR包，这样项目就能使用它们了。

4. 核心模块实现详解

接下来，我们按照分层架构，从底层到界面，逐一实现核心功能。我们以“学生信息管理”模块为例，其他模块（教师、课程、成绩）原理完全相同。

4.1 模型层（Model）实体类编写

对应student表，创建Student.java类。这是一个纯数据类。

package com.edu.model; import java.util.Date; public class Student { private String studentId; private String name; private String gender; private Date birthDate; // 使用java.util.Date或java.time.LocalDate private String major; private String className; private Date enrollmentDate; // 无参构造器、全参构造器、getter和setter方法 // 这里省略具体代码，可以使用IDE的Generate功能快速生成 }

注意：关于日期类型，java.util.Date是老的选择，存在时区等问题。如果使用JDK 8+，强烈推荐使用java.time.LocalDate，它只表示日期，不包含时间和时区，更符合“出生日期”、“入学日期”的业务含义。但需要确保你的数据库驱动（mysql-connector-java）版本支持LocalDate与MySQLDATE类型的自动转换（8.0以上驱动通常支持）。

4.2 数据访问层（DAO）封装

创建StudentDao.java，它负责所有与student表相关的数据库操作。这里会用到JDBC。

package com.edu.dao; import com.edu.model.Student; import com.edu.util.DBUtil; // 我们待会要写的数据库连接工具类 import java.sql.*; import java.util.ArrayList; import java.util.List; public class StudentDao { // 1. 新增学生 public boolean addStudent(Student student) { String sql = "INSERT INTO student(student_id, name, gender, birth_date, major, class_name, enrollment_date) VALUES(?,?,?,?,?,?,?)"; try (Connection conn = DBUtil.getConnection(); // 从连接池获取连接 PreparedStatement pstmt = conn.prepareStatement(sql)) { pstmt.setString(1, student.getStudentId()); pstmt.setString(2, student.getName()); pstmt.setString(3, student.getGender()); // 处理日期，假设Student中使用的是java.sql.Date pstmt.setDate(4, new java.sql.Date(student.getBirthDate().getTime())); pstmt.setString(5, student.getMajor()); pstmt.setString(6, student.getClassName()); pstmt.setDate(7, new java.sql.Date(student.getEnrollmentDate().getTime())); return pstmt.executeUpdate() > 0; // 执行插入，返回影响的行数 } catch (SQLException e) { e.printStackTrace(); return false; } // try-with-resources语法会自动关闭PreparedStatement和Connection（实际上是还回连接池） } // 2. 根据学号删除学生 public boolean deleteStudent(String studentId) { String sql = "DELETE FROM student WHERE student_id = ?"; // ... 类似addStudent，使用PreparedStatement防止SQL注入 } // 3. 更新学生信息 public boolean updateStudent(Student student) { String sql = "UPDATE student SET name=?, gender=?, birth_date=?, major=?, class_name=?, enrollment_date=? WHERE student_id=?"; // ... } // 4. 根据学号查询单个学生 public Student getStudentById(String studentId) { String sql = "SELECT * FROM student WHERE student_id = ?"; Student student = null; try (Connection conn = DBUtil.getConnection(); PreparedStatement pstmt = conn.prepareStatement(sql)) { pstmt.setString(1, studentId); ResultSet rs = pstmt.executeQuery(); if (rs.next()) { student = new Student(); student.setStudentId(rs.getString("student_id")); student.setName(rs.getString("name")); // ... 设置其他属性 // 注意从ResultSet中获取Date：rs.getDate("birth_date") 返回的是java.sql.Date } } catch (SQLException e) { e.printStackTrace(); } return student; } // 5. 查询所有学生（用于在界面表格中显示） public List<Student> getAllStudents() { List<Student> studentList = new ArrayList<>(); String sql = "SELECT * FROM student ORDER BY student_id"; try (Connection conn = DBUtil.getConnection(); Statement stmt = conn.createStatement(); ResultSet rs = stmt.executeQuery(sql)) { while (rs.next()) { Student student = new Student(); // 从ResultSet中提取数据，填充student对象 studentList.add(student); } } catch (SQLException e) { e.printStackTrace(); } return studentList; } // 6. 按条件查询（例如按姓名模糊查询、按专业查询） public List<Student> findStudents(String keyword, String major) { List<Student> list = new ArrayList<>(); StringBuilder sql = new StringBuilder("SELECT * FROM student WHERE 1=1 "); List<Object> params = new ArrayList<>(); if (keyword != null && !keyword.trim().isEmpty()) { sql.append(" AND (name LIKE ? OR student_id LIKE ?) "); params.add("%" + keyword + "%"); params.add("%" + keyword + "%"); } if (major != null && !major.trim().isEmpty()) { sql.append(" AND major = ? "); params.add(major); } sql.append(" ORDER BY student_id"); // 动态构建PreparedStatement并设置参数... } }

实操心得：

1. 一定要用PreparedStatement：所有带参数的SQL（如INSERT,UPDATE,DELETE, 带条件的SELECT）都必须使用PreparedStatement，并通过setXxx()方法设置参数。这能有效防止SQL注入攻击，也是JDBC编程的规范。
2. 资源关闭：使用try-with-resources语法（Java 7+），它能确保Connection,Statement,ResultSet这些资源被自动关闭，避免内存泄漏。即使不适用此语法，也必须在finally块中手动关闭。
3. 连接管理：DBUtil.getConnection()是我们接下来要封装的从连接池获取连接的方法，不要直接使用DriverManager.getConnection()。

4.3 工具类：数据库连接池封装（DBUtil）

创建DBUtil.java，这是项目的基础设施，至关重要。

package com.edu.util; import com.zaxxer.hikari.HikariConfig; import com.zaxxer.hikari.HikariDataSource; import javax.sql.DataSource; import java.sql.Connection; import java.sql.SQLException; public class DBUtil { private static final HikariDataSource dataSource; // 静态代码块，在类加载时初始化连接池 static { HikariConfig config = new HikariConfig(); config.setJdbcUrl("jdbc:mysql://localhost:3306/educational_management?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai"); config.setUsername("edu_admin"); config.setPassword("YourStrongPassword123!"); config.setDriverClassName("com.mysql.cj.jdbc.Driver"); // MySQL 8.0驱动类名 // 连接池配置（根据实际情况调整） config.setMaximumPoolSize(10); // 最大连接数 config.setMinimumIdle(5); // 最小空闲连接 config.setIdleTimeout(600000); // 空闲连接超时时间（毫秒） config.setConnectionTimeout(30000); // 获取连接超时时间 config.setMaxLifetime(1800000); // 连接最大生命周期 dataSource = new HikariDataSource(config); } // 提供静态方法获取连接 public static Connection getConnection() throws SQLException { return dataSource.getConnection(); } // 关闭连接池（通常在应用退出时调用） public static void closeDataSource() { if (dataSource != null && !dataSource.isClosed()) { dataSource.close(); } } }

注意事项：

• serverTimezone=Asia/Shanghai参数对于MySQL 8.0很重要，避免时区错误导致的日期时间问题。
• useSSL=false在本地开发环境可以关闭SSL以简化连接。生产环境应设置为true并提供证书。
• 连接池参数需要根据实际应用负载调整。对于小型桌面应用，MaximumPoolSize设为10-20通常足够。

4.4 服务层（Service）业务逻辑处理

创建StudentService.java。它介于Controller和DAO之间，处理更复杂的业务逻辑。在这个简单例子中，它可能只是直接调用DAO，但预留这一层是为了未来扩展。比如，添加学生前需要校验学号是否已存在。

package com.edu.service; import com.edu.dao.StudentDao; import com.edu.model.Student; import java.util.List; public class StudentService { private StudentDao studentDao = new StudentDao(); public boolean addStudent(Student student) { // 业务逻辑：检查学号是否重复 if (studentDao.getStudentById(student.getStudentId()) != null) { // 可以抛出自定义异常，或者返回错误信息 System.out.println("学号已存在！"); return false; } return studentDao.addStudent(student); } // 其他方法：deleteStudent, updateStudent, getAllStudents等，直接委托给DAO public List<Student> getAllStudents() { return studentDao.getAllStudents(); } // ... }

4.5 视图层（View）Swing界面构建

这是最直观的部分。我们创建一个StudentManagementFrame.java作为主界面。

package com.edu.view; import com.edu.model.Student; import com.edu.service.StudentService; import javax.swing.*; import javax.swing.table.DefaultTableModel; import java.awt.*; import java.awt.event.ActionEvent; import java.awt.event.ActionListener; import java.util.List; public class StudentManagementFrame extends JFrame { private JTable studentTable; private DefaultTableModel tableModel; private JTextField searchField; private StudentService studentService = new StudentService(); public StudentManagementFrame() { setTitle("学生信息管理系统"); setSize(900, 600); setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); setLocationRelativeTo(null); // 窗口居中 // 1. 创建顶部工具栏 JPanel topPanel = new JPanel(new FlowLayout(FlowLayout.LEFT)); JButton addButton = new JButton("新增"); JButton editButton = new JButton("编辑"); JButton deleteButton = new JButton("删除"); JButton refreshButton = new JButton("刷新"); searchField = new JTextField(20); JButton searchButton = new JButton("搜索"); topPanel.add(addButton); topPanel.add(editButton); topPanel.add(deleteButton); topPanel.add(refreshButton); topPanel.add(new JLabel("搜索:")); topPanel.add(searchField); topPanel.add(searchButton); // 2. 创建中央表格 String[] columnNames = {"学号", "姓名", "性别", "出生日期", "专业", "班级", "入学日期"}; tableModel = new DefaultTableModel(columnNames, 0); studentTable = new JTable(tableModel); JScrollPane scrollPane = new JScrollPane(studentTable); // 3. 布局 setLayout(new BorderLayout()); add(topPanel, BorderLayout.NORTH); add(scrollPane, BorderLayout.CENTER); // 4. 加载初始数据 refreshTable(); // 5. 绑定按钮事件 addButton.addActionListener(e -> openAddDialog()); refreshButton.addActionListener(e -> refreshTable()); deleteButton.addActionListener(e -> deleteSelectedStudent()); searchButton.addActionListener(e -> searchStudents()); // 编辑按钮事件类似，需要先获取表格选中行 } private void refreshTable() { // 清空表格 tableModel.setRowCount(0); // 从服务层获取数据 List<Student> students = studentService.getAllStudents(); for (Student s : students) { Object[] rowData = { s.getStudentId(), s.getName(), s.getGender(), s.getBirthDate(), s.getMajor(), s.getClassName(), s.getEnrollmentDate() }; tableModel.addRow(rowData); } } private void openAddDialog() { // 创建一个模态对话框来添加学生 JDialog dialog = new JDialog(this, "添加学生", true); dialog.setSize(400, 300); dialog.setLayout(new GridLayout(8, 2, 10, 10)); JTextField idField = new JTextField(); JTextField nameField = new JTextField(); // ... 其他字段输入框 dialog.add(new JLabel("学号:")); dialog.add(idField); dialog.add(new JLabel("姓名:")); dialog.add(nameField); // ... 添加其他标签和输入框 JButton submitButton = new JButton("提交"); JButton cancelButton = new JButton("取消"); submitButton.addActionListener(e -> { // 收集对话框中的数据，构建Student对象 Student student = new Student(); student.setStudentId(idField.getText()); student.setName(nameField.getText()); // ... 设置其他属性 // 调用服务层添加 boolean success = studentService.addStudent(student); if (success) { JOptionPane.showMessageDialog(dialog, "添加成功！"); dialog.dispose(); refreshTable(); // 刷新主表格 } else { JOptionPane.showMessageDialog(dialog, "添加失败，学号可能已存在！", "错误", JOptionPane.ERROR_MESSAGE); } }); cancelButton.addActionListener(e -> dialog.dispose()); JPanel buttonPanel = new JPanel(); buttonPanel.add(submitButton); buttonPanel.add(cancelButton); dialog.add(new JLabel()); // 占位 dialog.add(buttonPanel); dialog.setLocationRelativeTo(this); dialog.setVisible(true); } private void deleteSelectedStudent() { int selectedRow = studentTable.getSelectedRow(); if (selectedRow == -1) { JOptionPane.showMessageDialog(this, "请先选择要删除的学生！", "提示", JOptionPane.WARNING_MESSAGE); return; } String studentId = (String) tableModel.getValueAt(selectedRow, 0); // 第一列是学号 int confirm = JOptionPane.showConfirmDialog(this, "确定要删除学号为 " + studentId + " 的学生吗？", "确认删除", JOptionPane.YES_NO_OPTION); if (confirm == JOptionPane.YES_OPTION) { boolean success = studentService.deleteStudent(studentId); if (success) { JOptionPane.showMessageDialog(this, "删除成功！"); refreshTable(); } else { JOptionPane.showMessageDialog(this, "删除失败！", "错误", JOptionPane.ERROR_MESSAGE); } } } private void searchStudents() { String keyword = searchField.getText().trim(); // 调用Service中带查询条件的方法，然后刷新表格数据 // 这里需要先在StudentService和StudentDao中实现按关键词查询的方法 // List<Student> result = studentService.findStudents(keyword); // 更新tableModel JOptionPane.showMessageDialog(this, "搜索功能待实现，关键词: " + keyword); } public static void main(String[] args) { // 在事件分发线程中启动GUI，这是Swing的最佳实践 SwingUtilities.invokeLater(() -> { new StudentManagementFrame().setVisible(true); }); } }

5. 功能扩展与高级特性实现

基础CRUD（增删改查）完成后，我们可以让系统变得更实用、更健壮。

5.1 成绩管理模块的关联操作

成绩管理是教务系统的核心，它涉及学生和课程两张表的关联。Score实体类会包含studentId和courseId。在DAO层，查询成绩时往往需要联表查询，以获取学生姓名和课程名称，而不是只显示ID。

-- 查询所有成绩单（带学生名和课程名） SELECT s.score, s.semester, stu.name as student_name, c.course_name FROM score s JOIN student stu ON s.student_id = stu.student_id JOIN course c ON s.course_id = c.course_id ORDER BY s.semester DESC, stu.student_id;

在Java中，你可能需要创建一个ScoreVO（View Object）来承载这种联查结果，而不仅仅是基本的Score实体。

5.2 使用TableModel实现数据与视图分离

上面例子中，我们直接使用了DefaultTableModel。对于更复杂的场景，建议自定义AbstractTableModel。这样可以更灵活地控制表格数据的来源（直接绑定一个List<Student>），并且当数据变化时，只需通知模型更新，视图会自动刷新，更符合MVC思想。

public class StudentTableModel extends AbstractTableModel { private List<Student> studentList; private String[] columnNames = {"学号", "姓名", "性别", "专业"}; public StudentTableModel(List<Student> studentList) { this.studentList = studentList; } @Override public int getRowCount() { return studentList.size(); } @Override public int getColumnCount() { return columnNames.length; } @Override public String getColumnName(int column) { return columnNames[column]; } @Override public Object getValueAt(int rowIndex, int columnIndex) { Student student = studentList.get(rowIndex); switch (columnIndex) { case 0: return student.getStudentId(); case 1: return student.getName(); case 2: return student.getGender(); case 3: return student.getMajor(); default: return null; } } // 更新数据源并刷新表格 public void setStudentList(List<Student> studentList) { this.studentList = studentList; fireTableDataChanged(); // 重要！通知所有监听器数据已更改 } } // 在界面中使用：studentTable.setModel(new StudentTableModel(studentList));

5.3 数据验证与异常处理

在Service层和界面事件处理中，必须加入数据验证。

• 非空校验：学号、姓名等关键字段不能为空。
• 格式校验：学号是否符合规则（如长度、前缀），日期格式是否正确。
• 业务逻辑校验：添加成绩时，分数是否在0-100之间；选课时，学生和课程是否存在。 异常处理要友好，不要将堆栈信息直接抛给用户。使用try-catch捕获SQLException等异常，并转换为用户能理解的提示信息，通过JOptionPane.showMessageDialog显示。

5.4 报表生成与数据导出

这是一个很有用的扩展功能。你可以使用Apache POI库将查询到的学生列表、成绩单导出为Excel文件，或者使用iTextPDF导出为PDF。基本流程是：从数据库查询数据 -> 在内存中构建Excel/PDF文档 -> 通过文件选择器让用户选择保存路径 -> 写入文件。这能极大提升系统的实用性。

6. 项目部署、打包与常见问题排查

开发完成后，如何让用户（比如老师）方便地使用呢？

6.1 打包成可执行JAR文件

我们不能要求用户都安装IDEA来运行。需要将项目打包成一个独立的JAR。

1. 确保所有依赖JAR（mysql驱动、HikariCP）都在lib目录下。
2. 在IDEA中，File -> Project Structure -> Artifacts，点击+，选择JAR -> From modules with dependencies。
3. 选择主类（包含main方法的类，如StudentManagementFrame）。
4. 选择“复制依赖JAR到输出目录并打包到JAR中”或“提取到目标JAR”的选项。对于Swing项目，通常选择“提取到目标JAR”，这样会生成一个包含了所有依赖类的单一Fat JAR，分发最方便。
5. 点击Build -> Build Artifacts进行构建。
6. 在输出目录会生成一个xxx.jar文件。用户只需要安装JRE（Java运行环境），在命令行执行java -jar xxx.jar即可运行。

6.2 连接数据库的配置外部化

把数据库连接信息（URL、用户名、密码）硬编码在DBUtil里是非常糟糕的做法。应该将这些配置放到外部的属性文件（如config.properties）中。

# config.properties db.url=jdbc:mysql://localhost:3306/educational_management?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai db.username=edu_admin db.password=YourStrongPassword123! db.pool.maxSize=10

然后在DBUtil中读取这个文件：

Properties props = new Properties(); try (InputStream input = DBUtil.class.getClassLoader().getResourceAsStream("config.properties")) { props.load(input); config.setJdbcUrl(props.getProperty("db.url")); // ... 设置其他属性 } catch (IOException e) { // 处理异常，或使用默认值 }

这样，当数据库环境变化时，只需修改配置文件，无需重新编译打包项目。

6.3 常见问题与解决方案实录

在开发和运行过程中，你几乎一定会遇到下面这些问题：

关于界面卡顿的特别提醒：这是Swing开发中最容易踩的坑。Swing的界面渲染和事件处理都在一个叫事件分发线程（Event Dispatch Thread, EDT）的单独线程中进行。如果你在按钮点击事件里直接执行一个需要5秒的数据库查询，那么在这5秒内，整个界面会“冻住”，无法响应任何点击。正确的做法是使用SwingWorker：

addButton.addActionListener(e -> { new SwingWorker<Void, Void>() { @Override protected Void doInBackground() throws Exception { // 在后台线程执行耗时操作，如数据库查询 List<Student> students = studentService.getAllStudents(); // 假设这个操作很慢 return null; } @Override protected void done() { // 在EDT中执行，用于更新界面 try { get(); // 获取doInBackground的结果（如果有） // 更新表格模型 tableModel.setRowCount(0); for (Student s : students) { ... } } catch (Exception ex) { ex.printStackTrace(); JOptionPane.showMessageDialog(StudentManagementFrame.this, "加载数据失败！"); } } }.execute(); });

7. 项目总结与进阶思考

走完以上所有步骤，一个功能完整、结构清晰的Java Swing教务管理系统就搭建起来了。它虽然界面看起来可能不那么“炫酷”，但五脏俱全，涵盖了企业级应用开发的许多核心概念：分层架构、数据库设计、连接池、异常处理、打包部署。

我个人在多次实现和教学类似项目后，最大的体会是：理解并贯彻分层思想（MVC/三层架构）的价值，远大于学会某个Swing组件的用法。初期可能会觉得多写几个类很麻烦，但当你要加一个“按班级统计平均成绩”的功能时，你会发现只需要在StudentService里写统计逻辑，然后新增一个按钮和对话框来调用它即可，其他层的代码完全不用动。这种可维护性和可扩展性，是软件工程的核心。

这个项目还可以从多个方向进行深化：

1. 引入日志框架：用Logback或Log4j2替换System.out.println，方便记录运行日志和错误信息。
2. 加入权限控制：不同的用户（管理员、教师、学生）登录后看到不同的界面和功能。这需要设计用户表、角色表，并在Service层进行权限校验。
3. 更换数据持久化框架：将纯JDBC DAO层替换为MyBatis或Spring Data JPA，能大幅减少模板代码，让你更专注于业务逻辑。
4. 美化界面：使用JGoodies Forms、MigLayout等更强大的布局管理器，或者使用FlatLaf等现代Look and Feel主题包，让Swing界面看起来更接近现代软件。
5. 向Web转型：用Spring Boot + Thymeleaf/Vue.js重写后端和前端，理解B/S架构与C/S架构的差异。你会发现，核心的Service和DAO层代码，可以很大程度上复用。

最后，把代码放到GitHub上，写一个清晰的README，这不仅是备份，更是你能力的最好证明。当你去面试，被问到“有没有完整的项目经验”时，这个麻雀虽小五脏俱全的教务管理系统，就是一个非常扎实的起点。