Java Swing+MySQL学生宿舍管理系统实战设计

简介：本资源是一套面向高校计算机专业本科生的Java课程设计实战项目，基于MySQL数据库、Java语言与Swing图形界面技术开发的学生宿舍管理系统，适用于数据库原理、Java程序设计及软件工程类课程实践。资源包共334个文件，包含47个核心Java源码文件、202个编译后Class字节码、22张系统功能截图（如登录界面、宿舍分配、学生信息管理等）、9个XML配置文件及完整需求分析与ER图等文档材料，整体压缩包达112.72MB，结构规范，模块划分清晰（含管理员、学生、宿舍三大管理组件及多层接口定义）。已有268人学习下载，提供开箱即用的可运行工程（含jar包与数据库脚本），配套图表与说明文档覆盖系统设计全过程，便于理解MVC分层思想、JDBC连接实现及Swing事件驱动机制，是课程设计答辩与代码复现的理想参考范例。

1. 学生宿舍管理系统课程设计：不是写个 CRUD 就能交差的 Java Swing + MySQL 实战项目

你手头那份“基于 MySQL + Java + Swing 的学生宿舍管理系统”课程设计资源，真不是让你复制粘贴几个JFrame、填几条INSERT INTO就能糊弄过去的黑匣子。它是一套完整闭环的桌面端工程实践：从 MySQL 数据库建模（含宿舍楼-楼层-房间-床位四级关系、学生入住/调宿/退宿状态机）、Java 层面向对象封装（Student、Dormitory、Room、CheckInRecord 四类实体+Service 事务控制）、到 Swing 界面组件协同（带树形结构的宿舍楼导航 + 表格分页 + 模糊搜索 + 批量操作弹窗）。我带过三届计科专业课设，90% 的翻车都出在“数据库字段没加外键约束导致删除异常”“Swing 事件监听器没解绑引发内存泄漏”“MySQL 中文乱码没统一 utf8mb4 字符集”这三处。如果你正卡在答辩前一周、导师说“界面太简陋”或“数据一删就崩”，这份含源码+ER 图+数据库脚本+详细文档的资源，就是你最后的后悔药——它不教你 Java 基础语法，但会告诉你怎么用DefaultTreeModel动态刷新宿舍树、怎么用PreparedStatement防 SQL 注入、怎么用JTable的TableModel实现实时数据绑定。

---

2. 数据库设计与初始化：从 ER 图到可执行 SQL 脚本的落地细节

2.1 为什么必须用 ER 图先行建模？——四张核心表的业务逻辑闭环

课程设计里最容易被忽略的，是数据库设计阶段。很多同学直接开写代码，结果做到“学生调宿”功能时才发现：原宿舍记录没留操作时间戳，新宿舍没校验床位是否已占用，退宿后历史记录无法追溯。这份资源的 ER 图（PDF 文件）明确标注了四张主表的关联逻辑：

• dorm_building（宿舍楼）：id,name,total_floors
• dorm_floor（楼层）：id,building_id,floor_number（外键指向 building）
• dorm_room（房间）：id,floor_id,room_number,bed_count,used_bed_count（注意：used_bed_count是冗余字段，用于快速判断空闲床位，需在业务层严格维护一致性）
• student（学生）：id,name,gender,class_name,dorm_room_id,check_in_date,status（status 取值为 'IN'/'MOVED'/'CHECKED_OUT'）

提示：dorm_room.used_bed_count不是数据库自增字段，而是由 Java Service 层在checkIn()和checkOut()方法中手动更新。这是课程设计允许的折中方案——避免复杂触发器，但要求代码逻辑绝对可靠。

2.2 MySQL 初始化脚本实操：字符集、存储引擎、索引一个都不能少

资源包里的init_db.sql不是简单建表语句，它包含生产级配置。执行前务必确认你的 MySQL 版本 ≥ 5.7（推荐 5.7.44 或 8.0.33），并在命令行中执行：

# 进入 MySQL 客户端（假设 root 密码为空） mysql -u root -p < init_db.sql

init_db.sql关键片段如下：

-- 创建数据库并指定字符集（避坑重点！） CREATE DATABASE IF NOT EXISTS dorm_management CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE dorm_management; -- 建表语句（以 student 表为例） CREATE TABLE student ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL, gender ENUM('MALE', 'FEMALE') NOT NULL, class_name VARCHAR(100), dorm_room_id INT, check_in_date DATE, status ENUM('IN', 'MOVED', 'CHECKED_OUT') DEFAULT 'IN', created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, -- 外键约束（必须显式声明，否则 Swing 删除时会报错） CONSTRAINT fk_student_room FOREIGN KEY (dorm_room_id) REFERENCES dorm_room(id) ON DELETE SET NULL ON UPDATE CASCADE ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; -- 为高频查询字段加索引（提升 Swing 表格加载速度） CREATE INDEX idx_student_class ON student(class_name); CREATE INDEX idx_student_status ON student(status); CREATE INDEX idx_room_building ON dorm_room(floor_id);

参数说明：

• utf8mb4：支持 emoji 和生僻汉字（如“䶮”“堃”），比utf8更安全；若用utf8会导致中文插入失败或乱码。
• ON DELETE SET NULL：当房间被删除时，学生记录的dorm_room_id设为 NULL，而非直接报错中断操作——这是 Swing 界面友好性的底层保障。
• ENGINE=InnoDB：必须使用，支持事务和外键；MyISAM 不支持外键，会导致数据一致性崩溃。

2.3 验证数据库是否初始化成功：三条命令定乾坤

别急着跑 Java 程序，先用 SQL 验证数据结构是否正确：

-- 1. 查看所有表是否存在且字符集正确 SELECT table_name, table_collation FROM information_schema.tables WHERE table_schema = 'dorm_management'; -- 2. 查看 student 表外键是否生效（返回非空即成功） SELECT CONSTRAINT_NAME, COLUMN_NAME, REFERENCED_TABLE_NAME FROM information_schema.KEY_COLUMN_USAGE WHERE TABLE_SCHEMA = 'dorm_management' AND TABLE_NAME = 'student' AND REFERENCED_TABLE_NAME IS NOT NULL; -- 3. 插入一条测试数据（验证 INSERT 是否正常） INSERT INTO dorm_building(name, total_floors) VALUES ('A栋', 6); INSERT INTO dorm_floor(building_id, floor_number) VALUES (1, 1); INSERT INTO dorm_room(floor_id, room_number, bed_count, used_bed_count) VALUES (1, '101', 4, 0); INSERT INTO student(name, gender, class_name, dorm_room_id, status) VALUES ('张三', 'MALE', '计算机2021级1班', 1, 'IN');

如果第 3 条INSERT报错Cannot add or update a child row: a foreign key constraint fails，说明外键未生效——大概率是 MySQL 配置里禁用了外键检查（SET FOREIGN_KEY_CHECKS = 0），需在init_db.sql开头加上SET FOREIGN_KEY_CHECKS = 1;。

---

3. Java 核心模块实现：Swing 组件如何与 MySQL 事务协同工作

3.1 分层架构图解：为什么不能把 SQL 写死在 ActionListener 里？

资源中的 Java 项目采用经典三层结构（src/main/java 下）：

com.dorm.system ├── model/ # 实体类（Student.java, DormRoom.java...） ├── dao/ # 数据访问层（StudentDao.java 含 JDBC 封装） ├── service/ # 业务逻辑层（StudentService.java 含事务控制） └── ui/ # Swing 界面层（MainForm.java, StudentManagePanel.java...）

关键设计原则：

• Dao层只负责单表 CRUD，不处理跨表逻辑；
• Service层用@Transactional（手动模拟，因无 Spring）包装多步操作，例如“学生入住”需同时更新student.status和dorm_room.used_bed_count；
• UI层只响应事件，不碰数据库连接——这是避免Connection closed异常的根本。

注意：课程设计未引入 Spring，所以事务靠Connection.setAutoCommit(false)+try-catch-finally手动管理。StudentService.checkIn(Student s, DormRoom room)方法内会显式调用conn.commit()或conn.rollback()。

3.2 Swing 宿舍树（JTree）动态加载：从数据库到 DefaultTreeModel 的映射

ui/DormTreePanel.java是整个界面的灵魂。它不是静态写死“A栋→1楼→101室”，而是从数据库实时构建树结构。核心逻辑如下：

// 构建根节点 DefaultMutableTreeNode root = new DefaultMutableTreeNode("宿舍楼"); // 查询所有宿舍楼 List<DormBuilding> buildings = buildingDao.findAll(); for (DormBuilding b : buildings) { DefaultMutableTreeNode buildingNode = new DefaultMutableTreeNode(b.getName()); root.add(buildingNode); // 查询该楼所有楼层 List<DormFloor> floors = floorDao.findByBuildingId(b.getId()); for (DormFloor f : floors) { DefaultMutableTreeNode floorNode = new DefaultMutableTreeNode( String.format("第%d层", f.getFloorNumber()) ); buildingNode.add(floorNode); // 查询该楼层所有房间（带床位数提示） List<DormRoom> rooms = roomDao.findByFloorId(f.getId()); for (DormRoom r : rooms) { String roomLabel = String.format("%s（%d/%d床）", r.getRoomNumber(), r.getUsedBedCount(), r.getBedCount()); DefaultMutableTreeNode roomNode = new DefaultMutableTreeNode(roomLabel); roomNode.setUserObject(r); // 关键！绑定 Room 对象供后续点击使用 floorNode.add(roomNode); } } } // 设置到 JTree JTree tree = new JTree(new DefaultTreeModel(root)); tree.addTreeSelectionListener(e -> { DefaultMutableTreeNode selected = (DefaultMutableTreeNode) tree.getLastSelectedPathComponent(); if (selected != null && selected.getUserObject() instanceof DormRoom) { DormRoom room = (DormRoom) selected.getUserObject(); // 刷新右侧学生表格，显示该房间入住学生 loadStudentsByRoomId(room.getId()); } });

参数说明：

• setUserObject(r)：将DormRoom实例绑定到节点，避免二次查库——这是 Swing 性能优化的核心技巧；
• String.format("%s（%d/%d床）"：动态显示已用/总床位数，让管理员一眼识别空闲资源；
• loadStudentsByRoomId()：内部调用StudentDao.findByRoomId()，返回List<Student>并更新JTable。

3.3 学生信息表格（JTable）的实时绑定：TableModel 的正确写法

ui/StudentTablePanel.java使用自定义AbstractTableModel，而非DefaultTableModel（后者不支持对象绑定，修改数据需手动同步）：

public class StudentTableModel extends AbstractTableModel { private List<Student> data = new ArrayList<>(); private final String[] columnNames = {"学号", "姓名", "性别", "班级", "所在房间", "入住日期", "状态"}; @Override public int getRowCount() { return data.size(); } @Override public int getColumnCount() { return columnNames.length; } @Override public Object getValueAt(int rowIndex, int columnIndex) { Student s = data.get(rowIndex); switch (columnIndex) { case 0: return s.getId(); case 1: return s.getName(); case 2: return s.getGender().equals("MALE") ? "男" : "女"; case 3: return s.getClassName(); case 4: return s.getDormRoomId() != null ? roomDao.findById(s.getDormRoomId()).getRoomNumber() : "未分配"; case 5: return s.getCheckInDate(); case 6: return s.getStatus().equals("IN") ? "在住" : s.getStatus().equals("MOVED") ? "已调宿" : "已退宿"; default: return ""; } } @Override public String getColumnName(int column) { return columnNames[column]; } // 提供外部刷新接口（Swing 事件触发后调用） public void setData(List<Student> newData) { this.data = newData; fireTableDataChanged(); // 必须调用！否则表格不刷新 } }

关键点：

• fireTableDataChanged()：通知 JTable 重绘，缺了这行，你改完数据也看不到变化；
• roomDao.findById()在getValueAt()中调用——虽有性能损耗，但课程设计数据量小（<1000 条），可接受；若需优化，应在setData()时预加载房间信息到Student对象中；
• getColumnName()返回中文列名，避免 Swing 默认显示Column 0。

---

4. 常见问题排查：那些让答辩前夜崩溃的 5 个真实踩坑点

4.1 现象：Swing 界面启动后空白，控制台报java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver

原因：MySQL 8.0+ 驱动类名从com.mysql.jdbc.Driver变更为com.mysql.cj.jdbc.Driver，而资源中db.properties仍写旧类名。
解决：打开src/main/resources/db.properties，将driver=com.mysql.jdbc.Driver改为driver=com.mysql.cj.jdbc.Driver；同时确认lib/mysql-connector-java-8.0.33.jar已添加到项目 Build Path。

4.2 现象：新增学生时中文姓名存入数据库变成??，但用 Navicat 直接插入正常

原因：JDBC URL 缺少characterEncoding=utf8mb4参数，且 MySQL 服务端未全局启用utf8mb4。
解决：修改db.properties中的url：
url=jdbc:mysql://localhost:3306/dorm_management?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf8mb4&allowPublicKeyRetrieval=true
并执行 MySQL 命令：SET NAMES utf8mb4;

4.3 现象：点击“删除学生”按钮后，程序卡死，日志显示Lock wait timeout exceeded

原因：StudentService.delete()方法中未正确关闭PreparedStatement和ResultSet，导致连接池耗尽；或删除时未先更新dorm_room.used_bed_count，引发外键约束等待。
解决：检查StudentDao.delete()方法，确保finally块中调用rs.close()、ps.close()、conn.close()；并在StudentService.delete()中，先执行roomDao.updateUsedBedCount(roomId, -1)，再删除学生记录。

4.4 现象：宿舍树（JTree）点击某房间后，右侧学生表格无反应，但控制台无报错

原因：JTree的TreeSelectionListener未正确注册，或loadStudentsByRoomId()方法内SwingUtilities.invokeLater()调用位置错误，导致 UI 线程阻塞。
解决：确认tree.addTreeSelectionListener(...)在JTree初始化后立即调用；loadStudentsByRoomId()内部应将tableModel.setData(...)包裹在SwingUtilities.invokeLater()中，避免在事件线程中直接修改模型。

4.5 现象：导出 Excel 功能报java.lang.NoClassDefFoundError: org/apache/poi/ss/usermodel/Workbook

原因：资源包中lib/poi-5.2.4.jar未加入 Build Path，或存在版本冲突（如同时引入poi-3.17.jar）。
解决：清理lib/目录，仅保留poi-5.2.4.jar、poi-ooxml-5.2.4.jar、poi-scratchpad-5.2.4.jar三个文件；右键项目 → Build Path → Configure Build Path → Libraries → Add JARs，全选导入。

---

5. 进阶技巧：让课程设计答辩脱颖而出的 3 个硬核优化点

5.1 为 Swing 添加「操作日志」面板：用 JTextArea 实时打印 SQL 与业务动作

答辩老师最想看到的，不是功能多炫，而是你理解系统如何运转。在ui/MainForm.java底部加一个JTextArea日志面板，所有 DAO 操作都追加日志：

// 在 StudentDao.java 的 insert() 方法末尾 public void insert(Student student) throws SQLException { String sql = "INSERT INTO student (name, gender, class_name, dorm_room_id, status) VALUES (?, ?, ?, ?, ?)"; try (PreparedStatement ps = conn.prepareStatement(sql, Statement.RETURN_GENERATED_KEYS)) { ps.setString(1, student.getName()); ps.setString(2, student.getGender()); ps.setString(3, student.getClassName()); ps.setObject(4, student.getDormRoomId()); ps.setString(5, student.getStatus()); ps.executeUpdate(); // 记录日志（传入全局日志组件） LogPanel.appendLog(String.format("[INFO] 新增学生：%s，ID=%d", student.getName(), getGeneratedKey(ps))); } } // LogPanel.java（单例模式） public class LogPanel { private static JTextArea logArea; public static void appendLog(String msg) { SwingUtilities.invokeLater(() -> { logArea.append("[" + new SimpleDateFormat("HH:mm:ss").format(new Date()) + "] " + msg + "\n"); logArea.setCaretPosition(logArea.getDocument().getLength()); // 自动滚动到底部 }); } }

效果：答辩时点击“新增学生”，日志区实时显示[INFO] 新增学生：张三，ID=1001和对应 SQL —— 证明你清楚每一步数据流向，不是黑盒调用。

5.2 实现「批量调宿」功能：用 JTable 多选 + JComboBox 构建高效操作流

原资源只有单条调宿，但实际管理中常需整层调整。在StudentTablePanel.java中扩展：

// 添加批量操作工具栏 JToolBar toolbar = new JToolBar(); JComboBox<DormRoom> targetRoomCombo = new JComboBox<>(roomDao.findAll().toArray(new DormRoom[0])); toolbar.add(new JLabel("目标房间：")); toolbar.add(targetRoomCombo); JButton batchMoveBtn = new JButton("批量调宿"); batchMoveBtn.addActionListener(e -> { int[] selectedRows = table.getSelectedRows(); if (selectedRows.length == 0) return; DormRoom target = (DormRoom) targetRoomCombo.getSelectedItem(); if (target.getUsedBedCount() + selectedRows.length > target.getBedCount()) { JOptionPane.showMessageDialog(null, "目标房间床位不足！"); return; } List<Student> students = new ArrayList<>(); for (int row : selectedRows) { Student s = tableModel.getStudentAt(row); // 自定义方法，返回原始 Student 对象 students.add(s); } try { studentService.batchMoveToRoom(students, target); JOptionPane.showMessageDialog(null, "成功调宿 " + students.size() + " 名学生"); refreshTable(); // 重新加载表格 } catch (Exception ex) { JOptionPane.showMessageDialog(null, "调宿失败：" + ex.getMessage()); } }); toolbar.add(batchMoveBtn);

技术价值：展示你掌握JTable.getSelectedRows()、JComboBox数据绑定、以及事务性批量更新（batchMoveToRoom()内部用Connection批处理 + 一致性校验）。

5.3 生成数据库 ER 图的两种零成本方案：PlantUML vs MySQL Workbench

答辩 PPT 需要 ER 图？别再手动画。资源包里 PDF 图是静态的，但你可以现场生成可编辑版本：

方案一：PlantUML（纯文本，适合 Git 管理）
创建dorm.puml文件：

@startuml entity "dorm_building" as db { * id -- name -- total_floors } entity "dorm_floor" as df { * id -- building_id -- floor_number } entity "dorm_room" as dr { * id -- floor_id -- room_number -- bed_count -- used_bed_count } entity "student" as s { * id -- name -- gender -- class_name -- dorm_room_id -- status } db ||--|| df : "has" df ||--|| dr : "has" dr ||--o{ s : "occupies" @enduml

在线编译：https://www.plantuml.com/plantuml/ —— 复制文本，一键生成 PNG。

方案二：MySQL Workbench 反向工程（图形化，适合演示）

1. 打开 MySQL Workbench → Database → Reverse Engineer
2. 连接本地dorm_management数据库
3. 勾选四张表 → Next → Finish
4. 自动生成交互式 ER 图，支持拖拽布局、导出 SVG/PNG。

从那以后我每次做课程设计，都会在README.md里附上 PlantUML 源码和 Workbench 导出步骤——老师扫一眼就知道你懂设计源头，不是拼凑代码。希望帮到你。

本文还有配套的精品资源，点击获取