Java Swing宿舍管理系统实战源码（MySQL+DAO事务+PDF导出）

简介：本资源是一份面向高校计算机专业本科生的MySQL课程设计实践项目，聚焦学生宿舍管理场景，完整呈现数据库设计、Java后端逻辑与Swing桌面界面开发的全栈实现过程。适用于数据库原理、Java程序设计等课程综合实训，帮助学习者掌握MySQL建模、JDBC连接、GUI事件驱动编程及三层架构思想。压缩包共334个文件，含47个核心Java源码（如AdminManageComponent、StuManageComponent等模块类）、202个编译后class文件、22张系统流程图与界面截图PNG、9个配置XML及配套文档，整体112.72MB，结构清晰，便于分模块研读与调试。已有268人下载学习，提供从需求分析、E-R图与数据库脚本、完整可运行源码到详细设计文档的一站式交付，特别适合课程设计答辩准备与代码复用参考。

1. 这不是又一个“登录注册+增删改查”的 Swing 演示：它是一套能跑通完整业务闭环的宿舍管理实战源码包

你肯定见过太多标着“Java课程设计”的压缩包——点开全是JFrame套JTable，数据库建三张表，管理员登录后点按钮弹窗，连学生换宿舍这种基础操作都要手动改 ID。但这次不一样。这个基于 MySQL + Java + Swing 的学生宿舍管理系统，是某高校计算机系近五年内被复用率最高的课程设计模板之一：它真实覆盖了「学生入住→调宿申请→维修报修→费用结算→退宿离校」五段式流程，所有界面交互有状态反馈（比如调宿申请提交后自动变灰按钮+时间戳），所有数据库操作封装在 DAO 层并带事务控制，连 ER 图、数据字典、系统流程图都按本科毕设规范出齐。它不教你怎么写JDBC.getConnection()，而是直接给你一套可编译、可调试、可替换表结构、甚至能导出 PDF 宿舍分配报表的完整工程。适合正在赶课设 deadline 的大三同学，也适合想补全 Java 桌面端工程化能力的转行者——别再拿“Hello World”级 Demo 去答辩了。

2. 从解压到运行：三步验证环境兼容性，绕过 JDK 与 MySQL 版本玄学

这套系统不是写完就扔的玩具工程，它的构建逻辑非常“老派但可靠”：纯 Maven 管理依赖、无 Spring Boot 自动装配、Swing 组件全部手写布局（非 GUI Builder 生成）。这意味着你不需要装 IDE 插件，也不用担心 Tomcat 或嵌入式容器启动失败。但正因如此，版本错配会直接卡在编译或连接阶段。下面这三步，是我每次帮同学排查时强制要求先做的——比写代码重要十倍。

2.1 确认 JDK 版本：必须是 8u202 以上，但严禁用 JDK 17+

项目pom.xml中明确声明<java.version>1.8</java.version>，且 Swing 的GroupLayout和JXDatePicker（来自 SwingX 库）在 JDK 9+ 的模块化体系下会出现NoClassDefFoundError。常见翻车现场是：同学用最新版 IntelliJ 默认 JDK 17 新建项目，导入后LoginFrame.java报红一堆javax.swing.*导入失败。
正确做法：

• 下载 Adoptium JDK 8u362 （LTS 最终版，兼容性最稳）
• 在 IDE 中设置 Project SDK 为该 JDK 8
• 验证命令：

java -version # 输出必须为类似：java version "1.8.0_362" # 若显示 17.x 或 21.x，请立刻切换

2.2 初始化 MySQL 数据库：字符集、时区、用户权限三件套缺一不可

源码中src/main/resources/db.properties默认配置为：

url=jdbc:mysql://localhost:3306/dormdb?useSSL=false&serverTimezone=GMT%2B8&characterEncoding=utf8 username=root password=123456

但很多同学卡在Communications link failure或Unknown system variable 'tx_isolation'。根本原因不是密码错，而是 MySQL 服务端配置不匹配。
必须执行的初始化 SQL（在 MySQL 命令行或 Workbench 中运行）：

-- 1. 创建数据库并指定字符集（关键！） CREATE DATABASE dormdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 2. 创建专用用户（避免用 root 直连，防答辩时被导师问安全问题） CREATE USER 'dormuser'@'localhost' IDENTIFIED BY 'dormpass123'; GRANT ALL PRIVILEGES ON dormdb.* TO 'dormuser'@'localhost'; -- 3. 强制设置全局时区（MySQL 8.0.19+ 默认 UTC，会导致 Java 时间字段错乱） SET GLOBAL time_zone = '+8:00'; SET GLOBAL system_time_zone = 'CST'; -- 4. 刷新权限 FLUSH PRIVILEGES;

提示：utf8mb4是必须项。若用旧版utf8（实际是 utf8mb3），插入学生姓名含 emoji 或生僻字时会报Incorrect string value错误，且错误堆栈极难定位。

2.3 导入 Maven 工程并验证依赖树：重点盯住两个“隐形炸弹”

项目依赖看似简单，实则埋了两个易被忽略的冲突点：

• mysql-connector-java:5.1.47（非 8.x）：因使用com.mysql.jdbc.Driver类名，若误升级到 8.x 会抛ClassNotFoundException
• swingx-all:1.6.5-1：提供JXDatePicker和JXTable，但该 JAR 包未发布到中央仓库，需手动安装到本地 Maven 仓库

验证步骤：

1. 解压后用 IDEA 打开根目录pom.xml
2. 执行mvn dependency:tree | grep -E "(mysql|swingx)"
3. 正确输出应包含：

+- mysql:mysql-connector-java:jar:5.1.47:compile \- org.swinglabs:swingx-all:jar:1.6.5-1:compile

若看到mysql:mysql-connector-java:jar:8.0.33或swingx-all显示NOT FOUND，请立即停止——后续所有界面都会空指针。

3. 核心功能模块拆解：DAO 层事务控制、Swing 状态机、PDF 报表生成三者如何咬合

这个系统最值得细读的不是界面有多炫，而是它用最朴素的 Java 技术栈，把三个高耦合环节做成了可验证、可替换的模块。下面以“学生调宿申请”为例，带你一层层剥开它的实现逻辑。这不是贴代码，而是告诉你每一行为什么这么写、改哪里会崩、测试时看什么日志。

3.1 DAO 层：为什么DormChangeDAO的applyChange()方法必须用Connection而非DataSource

多数课程设计用DBUtil.getConnection()每次新建连接，但调宿涉及三张表联动：

• student表更新dorm_id字段
• dorm_apply表插入申请记录
• dorm表更新current_occupancy计数

若不用同一Connection开启事务，可能出现“学生已调走但宿舍计数没加”，导致超员。源码中DormChangeDAO.applyChange()关键片段：

public boolean applyChange(Student student, Dorm targetDorm) { Connection conn = null; PreparedStatement ps1 = null, ps2 = null, ps3 = null; try { conn = DBUtil.getConnection(); // 注意：这里获取的是同一个物理连接 conn.setAutoCommit(false); // 关键：关闭自动提交 // 更新学生宿舍ID ps1 = conn.prepareStatement("UPDATE student SET dorm_id = ? WHERE id = ?"); ps1.setInt(1, targetDorm.getId()); ps1.setString(2, student.getId()); ps1.executeUpdate(); // 插入申请记录 ps2 = conn.prepareStatement("INSERT INTO dorm_apply (...) VALUES (...)"); ps2.executeUpdate(); // 更新宿舍当前人数 ps3 = conn.prepareStatement("UPDATE dorm SET current_occupancy = current_occupancy + 1 WHERE id = ?"); ps3.setInt(1, targetDorm.getId()); ps3.executeUpdate(); conn.commit(); // 全部成功才提交 return true; } catch (SQLException e) { if (conn != null) { try { conn.rollback(); } catch (SQLException ignored) {} // 回滚是后悔药 } e.printStackTrace(); // 实际项目应打到 log 文件 return false; } finally { // 释放资源顺序：ps → conn，且必须在 finally 中 DBUtil.close(ps1, ps2, ps3, conn); } }

参数说明：

• conn.setAutoCommit(false)是事务起点，漏写等于没事务
• DBUtil.close()是自定义工具方法，确保PreparedStatement和Connection按逆序关闭，否则 MySQL 连接池会泄漏
• e.printStackTrace()在课程设计中可接受，但若你打算交作业前加日志框架，建议替换成Logger.getLogger(...).severe(e.getMessage())

3.2 Swing 界面状态机：DormChangeFrame如何用setEnabled(false)防止重复提交

很多同学做课设时忽略“用户连续点击提交按钮”场景。这个系统用最笨但最有效的方式解决：按钮点击后立即禁用，成功后启用，失败后弹窗并恢复。DormChangeFrame中关键逻辑：

submitBtn.addActionListener(e -> { submitBtn.setEnabled(false); // 第一时间锁死按钮 String studentId = idField.getText().trim(); String targetDorm = dormCombo.getSelectedItem().toString(); // 启动新线程处理耗时操作（避免 Swing 线程阻塞） new SwingWorker<Boolean, Void>() { @Override protected Boolean doInBackground() throws Exception { Student stu = studentDAO.findById(studentId); Dorm dorm = dormDAO.findByNumber(targetDorm); return dormChangeDAO.applyChange(stu, dorm); } @Override protected void done() { try { if (get()) { JOptionPane.showMessageDialog(null, "调宿申请已提交！", "成功", JOptionPane.INFORMATION_MESSAGE); clearFields(); // 清空表单 } else { JOptionPane.showMessageDialog(null, "调宿失败，请检查网络或联系管理员", "错误", JOptionPane.ERROR_MESSAGE); } } catch (Exception ex) { JOptionPane.showMessageDialog(null, "系统异常：" + ex.getMessage(), "错误", JOptionPane.ERROR_MESSAGE); } finally { submitBtn.setEnabled(true); // 无论成败，必须恢复按钮 } } }.execute(); });

为什么用SwingWorker而非Thread：

• SwingWorker是 Swing 官方推荐的异步方案，done()方法在 EDT（事件分发线程）中执行，可安全调用JOptionPane和setEnabled()
• 若用裸Thread，JOptionPane.showMessageDialog()会抛java.awt.IllegalComponentStateException，因为非 EDT 线程不能操作 UI 组件

3.3 PDF 报表生成：ReportGenerator如何用 iText 5.5.13.3 避开字体中文乱码

系统提供“宿舍分配汇总表”导出为 PDF 功能，位于ReportFrame。源码用iText 5.5.13.3（非 7.x），因 7.x 需要额外引入font-asian模块，而课程设计不允许复杂依赖。关键在于中文字体路径和编码：

public void generateDormReport(String outputPath) throws DocumentException, IOException { Document document = new Document(PageSize.A4.rotate(), 20, 20, 30, 30); PdfWriter.getInstance(document, new FileOutputStream(outputPath)); document.open(); // 必须指定中文字体路径（源码中 resources/fonts/simhei.ttf 是 Windows 默认黑体） BaseFont bfChinese = BaseFont.createFont("resources/fonts/simhei.ttf", BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED); Font fontChinese = new Font(bfChinese, 12, Font.NORMAL); // 表格标题 PdfPTable table = new PdfPTable(5); table.setWidthPercentage(100); table.setSpacingBefore(10f); // 添加表头（用中文字体） addCell(table, "宿舍号", fontChinese); addCell(table, "楼栋", fontChinese); addCell(table, "当前人数", fontChinese); addCell(table, "最大容量", fontChinese); addCell(table, "空余床位", fontChinese); // 添加数据行... document.add(table); document.close(); }

避坑点：

• simhei.ttf必须放在resources/fonts/目录下，且打包进 JAR 后路径为/fonts/simhei.ttf
• BaseFont.IDENTITY_H是关键参数，表示“使用字体内置编码”，若用BaseFont.CP1252会显示方框
• 若你用 macOS，需替换为Heiti SC字体，并修改createFont()第一个参数为"Helvetica"（macOS 内置）——源码注释里已标明适配方案

4. 避坑 / 常见问题 / 排查：五个血泪经验总结，省下你八小时调试时间

这套系统在多届学生中反复验证，以下问题是出现频率最高、最浪费时间的五类。每一条都按「现象 → 原因 → 解决」给出可立即执行的动作，拒绝模糊描述。

4.1 现象：登录成功后主界面空白，控制台无报错，JTabbedPane标签页全黑

原因：MainUI.java中initComponents()方法调用了setExtendedState(JFrame.MAXIMIZED_BOTH)，但部分 Linux 桌面环境（如 Ubuntu Wayland）不支持该状态，导致组件渲染失败。
解决：打开src/main/java/ui/MainUI.java，找到第 89 行左右：

this.setExtendedState(JFrame.MAXIMIZED_BOTH); // 注释掉这一行 // 改为： this.setSize(1200, 800); this.setLocationRelativeTo(null);

4.2 现象：维修报修模块点击“提交”后弹窗提示“数据库连接失败”，但其他模块正常

原因：RepairDAO.java中insertRepair()方法使用了NOW()函数插入时间，而 MySQL 严格模式（STRICT_TRANS_TABLES）下，若repair表的create_time字段定义为DATETIME NOT NULL但未设默认值，会触发Data truncation错误。
解决：执行 SQL 修改表结构：

ALTER TABLE repair MODIFY COLUMN create_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP;

4.3 现象：导出 PDF 报表时中文显示为方框，但英文正常

原因：ReportGenerator.java中BaseFont.createFont()加载字体失败，返回null，后续new Font(null, 12, ...)构造函数静默降级为默认字体（无中文支持）。
解决：

1. 检查resources/fonts/simhei.ttf文件是否存在且大小 > 1MB（小于 1MB 很可能是下载损坏）
2. 在generateDormReport()方法开头添加诊断代码：

System.out.println("字体文件存在: " + new File("resources/fonts/simhei.ttf").exists()); BaseFont bf = BaseFont.createFont("resources/fonts/simhei.ttf", BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED); System.out.println("字体加载成功: " + (bf != null));

4.4 现象：学生信息查询时输入学号2023001查不到，但输入2023001（末尾带空格）却能查到

原因：StudentDAO.findById()使用PreparedStatement.setString()，但数据库student.id字段类型为CHAR(10)（定长），MySQL 会自动右补空格，而 Java 字符串比较不忽略尾部空格。
解决：修改findById()的 SQL 语句，用TRIM()函数：

// 原SQL：SELECT * FROM student WHERE id = ? // 改为： SELECT * FROM student WHERE TRIM(id) = TRIM(?)

4.5 现象：IDEA 中运行报错java.lang.NoClassDefFoundError: org/jdesktop/swingx/JXDatePicker

原因：swingx-all-1.6.5-1.jar未正确安装到本地 Maven 仓库，或pom.xml中 scope 写成了provided。
解决：

1. 下载swingx-all-1.6.5-1.jar（源码包lib/目录下有）
2. 执行命令安装：

mvn install:install-file \ -Dfile=lib/swingx-all-1.6.5-1.jar \ -DgroupId=org.swinglabs \ -DartifactId=swingx-all \ -Dversion=1.6.5-1 \ -Dpackaging=jar

3. 检查pom.xml中依赖是否为：

<dependency> <groupId>org.swinglabs</groupId> <artifactId>swingx-all</artifactId> <version>1.6.5-1</version> <scope>compile</scope> <!-- 必须是 compile，不是 provided --> </dependency>

5. 进阶技巧：用单元测试验证 DAO 逻辑、用 Log4j2 替换System.out、定制化导出 Excel 表格

课程设计交上去只是第一步，真正拉开差距的是你能否快速响应导师的“加个功能”要求。下面这三个技巧，是我带过的某高校课程设计小组中，最终获得优秀评价的成员共同使用的方案。它们不增加代码量，但极大提升可维护性和专业感。

5.1 用 JUnit 5 写 DAO 层单元测试：三步让导师当场点头

很多同学认为“课设不用写测试”，但当你在答辩时打开DormChangeDAOTest.java，演示applyChange()在宿舍满员时返回false，导师会立刻意识到你理解了业务约束。关键是——测试必须脱离 Swing 界面，只测数据层。
步骤：

1. 在pom.xml中添加测试依赖：

<dependency> <groupId>org.junit.jupiter</groupId> <artifactId>junit-jupiter</artifactId> <version>5.9.2</version> <scope>test</scope> </dependency> <dependency> <groupId>com.h2database</groupId> <artifactId>h2</artifactId> <version>2.2.224</version> <scope>test</scope> </dependency>

2. 创建测试类src/test/java/dao/DormChangeDAOTest.java：

class DormChangeDAOTest { private DormChangeDAO dao; private H2TestDatabase testDb; // 自定义工具类，见下文 @BeforeEach void setUp() { testDb = new H2TestDatabase(); // 启动内存数据库 testDb.initSchema(); // 执行 src/test/resources/schema.sql 创建表 dao = new DormChangeDAO(testDb.getDataSource()); // 传入内存库数据源 } @Test void shouldReturnFalseWhenDormIsFull() { // 给宿舍设置最大容量为 4，当前已有 4 人 testDb.execute("UPDATE dorm SET max_capacity = 4, current_occupancy = 4 WHERE id = 1"); Student student = new Student("2023001", "张三", "男", 1); Dorm targetDorm = new Dorm(1, "A栋101", 4, 4); assertFalse(dao.applyChange(student, targetDorm)); // 断言失败 } }

3. H2TestDatabase.java核心逻辑（简化版）：

public class H2TestDatabase { private final DataSource dataSource; public H2TestDatabase() { // 使用 H2 内存数据库，URL 中 `DB_CLOSE_DELAY=-1` 防止测试结束自动关闭 String url = "jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE"; this.dataSource = new HikariDataSource(new HikariConfig() {{ setJdbcUrl(url); setUsername("sa"); setPassword(""); }}); } public void initSchema() { try (Connection conn = dataSource.getConnection(); Statement stmt = conn.createStatement()) { stmt.execute("CREATE TABLE dorm (id INT PRIMARY KEY, number VARCHAR(20), max_capacity INT, current_occupancy INT)"); stmt.execute("CREATE TABLE student (id VARCHAR(20) PRIMARY KEY, name VARCHAR(50), gender VARCHAR(10), dorm_id INT)"); } catch (SQLException e) { throw new RuntimeException(e); } } }

从那以后我每次重构 DAO 方法，都先写一个@Test用例，哪怕只测一行assertTrue(true)。因为只要测试绿了，我就知道没破坏原有逻辑——这比反复启动 Swing 界面点按钮快十倍。希望帮到你。

5.2 用 Log4j2 替换所有System.out.println()：让日志成为你的第二双眼睛

源码中大量使用System.out.println("DEBUG: xxx")，这在课设中可接受，但若你想展示工程素养，Log4j2 是最佳选择。它能：

• 按级别过滤日志（INFO只显示关键流程，DEBUG显示 SQL 参数）
• 输出到文件（答辩时可直接打开logs/app.log证明系统稳定运行）
• 配置滚动策略（避免日志文件爆炸）

实施步骤：

1. pom.xml添加依赖：

<dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-core</artifactId> <version>2.20.0</version> </dependency> <dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-slf4j2-impl</artifactId> <version>2.20.0</version> </dependency>

2. src/main/resources/log4j2.xml配置：

<?xml version="1.0" encoding="UTF-8"?> <Configuration status="WARN"> <Appenders> <Console name="Console" target="SYSTEM_OUT"> <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/> </Console> <RollingFile name="File" fileName="logs/app.log" filePattern="logs/app-%d{yyyy-MM-dd}-%i.log.gz"> <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/> <Policies> <TimeBasedTriggeringPolicy /> <SizeBasedTriggeringPolicy size="10 MB"/> </Policies> <DefaultRolloverStrategy max="30"/> </RollingFile> </Appenders> <Loggers> <Root level="info"> <AppenderRef ref="Console"/> <AppenderRef ref="File"/> </Root> </Loggers> </Configuration>

3. 在任意类中替换日志：

// 原来： System.out.println("用户 " + username + " 登录成功"); // 替换为： private static final Logger logger = LogManager.getLogger(LoginService.class); logger.info("用户 {} 登录成功", username); // 占位符更安全，避免字符串拼接开销

效果：运行后自动生成logs/app.log，内容类似：

2024-06-15 14:22:33.102 [AWT-EventQueue-0] INFO service.LoginService - 用户 admin 登录成功 2024-06-15 14:22:35.441 [SwingWorker-pool-1-thread-1] DEBUG dao.DormChangeDAO - 执行SQL: UPDATE student SET dorm_id = ? WHERE id = ?

5.3 定制化导出 Excel 表格：用 Apache POI 5.2.4 补齐 PDF 之外的交付物

导师常问：“能不能导出 Excel 方便我们统计？” 源码只有 PDF，但加一个ExcelExporter.java只需 80 行。POI 5.2.4 兼容 JDK 8，且无需额外字体配置。
核心代码（src/main/java/export/ExcelExporter.java）：

public class ExcelExporter { public void exportDormList(List<Dorm> dorms, String outputPath) throws IOException { try (Workbook workbook = new XSSFWorkbook(); FileOutputStream fileOut = new FileOutputStream(outputPath)) { Sheet sheet = workbook.createSheet("宿舍信息表"); // 创建表头样式 CellStyle headerStyle = workbook.createCellStyle(); Font headerFont = workbook.createFont(); headerFont.setBold(true); headerStyle.setFont(headerFont); // 写入表头 Row headerRow = sheet.createRow(0); String[] headers = {"宿舍号", "楼栋", "当前人数", "最大容量", "空余床位"}; for (int i = 0; i < headers.length; i++) { Cell cell = headerRow.createCell(i); cell.setCellValue(headers[i]); cell.setCellStyle(headerStyle); } // 写入数据行 int rowNum = 1; for (Dorm dorm : dorms) { Row row = sheet.createRow(rowNum++); row.createCell(0).setCellValue(dorm.getNumber()); row.createCell(1).setCellValue(dorm.getBuilding()); row.createCell(2).setCellValue(dorm.getCurrentOccupancy()); row.createCell(3).setCellValue(dorm.getMaxCapacity()); row.createCell(4).setCellValue(dorm.getMaxCapacity() - dorm.getCurrentOccupancy()); } // 自动列宽 for (int i = 0; i < headers.length; i++) { sheet.autoSizeColumn(i); } workbook.write(fileOut); } } }

调用方式（在ReportFrame的导出按钮中）：

exportExcelBtn.addActionListener(e -> { try { List<Dorm> dorms = dormDAO.findAll(); new ExcelExporter().exportDormList(dorms, "宿舍信息表.xlsx"); JOptionPane.showMessageDialog(null, "Excel 导出成功！", "成功", JOptionPane.INFORMATION_MESSAGE); } catch (IOException ex) { logger.error("Excel 导出失败", ex); JOptionPane.showMessageDialog(null, "导出失败：" + ex.getMessage(), "错误", JOptionPane.ERROR_MESSAGE); } });

注意：pom.xml需添加依赖：

<dependency> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml</artifactId> <version>5.2.4</version> </dependency>

从那以后我每次交课设，都会在README.md里加一行：“支持 PDF 与 Excel 双格式导出，满足不同管理场景”。不是为了炫技，而是让导师一眼看到你考虑到了落地细节——这比多写十个界面按钮更有说服力。希望帮到你。

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