Java课设实战：医院挂号系统（Swing+MySQL）完整开发指南

简介这是一套面向高校Java课程设计的医院挂号系统实战项目采用Swing构建GUI界面、MySQL实现数据持久化专为Java初学者及课设学生打造覆盖用户登录、医生管理、挂号增删改查等核心业务流程代码风格简洁规范符合教学验收要求。资源包共75个文件含14个核心Java源码如Login.java、UserMain.java、GHAdd.java、38个编译后class文件、12张界面截图PNG、7个XML配置文件含IDEA项目结构与UI设计器配置以及关键的yygh.sql数据库脚本和明文账号密码说明整体仅175KB轻量易部署。已有267人学习下载所有模块均经真实交付验证可正常运行。读者可直接导入IDEA运行快速掌握JDBC连接、Swing事件驱动、MVC简易分层、SQL建表与CRUD等Java课设必备技能并通过源码结构理解典型C/S架构中小型管理系统的设计逻辑。1. 医院挂号系统【GUI/SwingMySQL】Java课设为什么它仍是Java初学者验证“能干活”的黄金练手项目很多同学拿到“医院挂号系统Java课设”这个题目时第一反应是这不就是个带按钮的表格写完交差就行。但真实踩过坑的人知道——它恰恰是 Swing MySQL 组合下边界最清晰、反馈最即时、失败最可追溯的完整闭环训练场。你得设计患者、医生、科室、号源四张表之间的外键约束得用JTable动态刷新当日号源余量得在JDialog弹窗里做号源锁定与事务回滚还得让JComboBox的科室联动医生列表不卡顿。这不是炫技而是把 JDBC 连接池配置、Swing 事件分发线程EDT安全更新、SQL 注入防御哪怕只是用PreparedStatement、甚至日期格式化SimpleDateFormat线程不安全怎么破全塞进一个不到 2000 行的工程里。它适合谁适合刚学完 Java 基础、集合、IO 和 JDBC但还没写过“用户点击后数据真正在数据库里增删改查并实时显示”的人。不是为了做出高并发挂号平台而是为了亲手把“类→对象→界面控件→SQL语句→数据库记录→界面刷新”这条链路一环一环拧紧。2. 从零搭起可运行骨架用 SwingBuilder 快速生成主窗体 MySQL 建库建表最小集2.1 主窗体结构设计用 GroupLayout 避免绝对定位翻车Swing 布局器选型是课设第一道坎。新手常直接setBounds()手动拖控件结果换分辨率就错位、加个新按钮就得重调所有坐标。真实项目中我一律用GroupLayout——它虽学习曲线稍陡但一旦掌握后续增删控件几乎不用改布局代码。核心逻辑是把组件按水平/垂直两条轴线分组用ParallelGroup和SequentialGroup显式声明依赖关系。// MainFrame.java 片段主窗体初始化布局 private void initLayout() { GroupLayout layout new GroupLayout(getContentPane()); getContentPane().setLayout(layout); // 水平轴左侧菜单栏 右侧内容区JTabbedPane layout.setHorizontalGroup(layout.createParallelGroup() .addComponent(menuPanel, GroupLayout.PREFERRED_SIZE, 180, GroupLayout.PREFERRED_SIZE) .addComponent(contentTab, GroupLayout.DEFAULT_SIZE, 600, Short.MAX_VALUE) ); // 垂直轴顶部菜单栏 中间内容区等高 layout.setVerticalGroup(layout.createSequentialGroup() .addComponent(menuPanel, GroupLayout.PREFERRED_SIZE, 500, GroupLayout.PREFERRED_SIZE) .addComponent(contentTab, GroupLayout.PREFERRED_SIZE, 500, GroupLayout.PREFERRED_SIZE) ); }提示GroupLayout不支持可视化设计器自动生成必须手写。但好处是——所有尺寸约束都在代码里版本控制友好协作时别人一眼看懂布局意图。2.2 MySQL 数据库初始化四张表 外键 初始化测试数据挂号系统本质是状态机患者挂号 → 号源锁定 → 医生接诊 → 号源释放。状态流转靠数据库约束兜底。课设最容易被忽略的是外键和初始数据——没有INSERT INTO doctor VALUES (1,张医生,内科,1);这类语句界面 ComboBox 会空着学生以为代码错了其实是数据库没填数据。-- 创建数据库UTF8MB4 防止中文乱码 CREATE DATABASE IF NOT EXISTS hospital_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE hospital_db; -- 科室表主键dept_id CREATE TABLE department ( dept_id INT PRIMARY KEY AUTO_INCREMENT, dept_name VARCHAR(50) NOT NULL UNIQUE ); -- 医生表外键 dept_id 关联科室 CREATE TABLE doctor ( doc_id INT PRIMARY KEY AUTO_INCREMENT, doc_name VARCHAR(50) NOT NULL, dept_id INT NOT NULL, FOREIGN KEY (dept_id) REFERENCES department(dept_id) ON DELETE CASCADE ); -- 患者表无外键独立实体 CREATE TABLE patient ( pat_id INT PRIMARY KEY AUTO_INCREMENT, pat_name VARCHAR(50) NOT NULL, id_card VARCHAR(18) UNIQUE, phone VARCHAR(11) ); -- 号源表核心status 字段标识 available/booked/used CREATE TABLE registration ( reg_id INT PRIMARY KEY AUTO_INCREMENT, pat_id INT, doc_id INT, reg_date DATE NOT NULL, reg_time TIME NOT NULL, status ENUM(available,booked,used) DEFAULT available, FOREIGN KEY (pat_id) REFERENCES patient(pat_id) ON DELETE SET NULL, FOREIGN KEY (doc_id) REFERENCES doctor(doc_id) ON DELETE CASCADE );参数说明ON DELETE CASCADE表示删除医生时自动清空其名下号源ON DELETE SET NULL表示患者注销后已挂号记录保留但pat_id设为 NULL便于审计。ENUM类型比VARCHAR更安全避免插入非法状态值。2.3 JDBC 连接封装用 Properties 文件解耦配置避免硬编码密码把数据库地址、用户名、密码写死在new Connection(jdbc:mysql://..., root, 123456)里是课设答辩时老师必问的扣分点。真实做法是抽离到db.properties文件并通过ClassLoader.getResourceAsStream()加载# src/db.properties db.urljdbc:mysql://localhost:3306/hospital_db?useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue db.usernameroot db.passwordyour_secure_password db.drivercom.mysql.cj.jdbc.Driver// DBUtil.java单例连接工具类 public class DBUtil { private static Properties props; private static DataSource dataSource; static { props new Properties(); try (InputStream is DBUtil.class.getClassLoader().getResourceAsStream(db.properties)) { props.load(is); // 使用 HikariCP 连接池轻量级课设够用 HikariConfig config new HikariConfig(); config.setJdbcUrl(props.getProperty(db.url)); config.setUsername(props.getProperty(db.username)); config.setPassword(props.getProperty(db.password)); config.setDriverClassName(props.getProperty(db.driver)); config.setMaximumPoolSize(10); config.setMinimumIdle(2); config.setConnectionTimeout(30000); dataSource new HikariDataSource(config); } catch (Exception e) { throw new RuntimeException(加载数据库配置失败, e); } } public static Connection getConnection() throws SQLException { return dataSource.getConnection(); } }注意serverTimezoneAsia/Shanghai是 MySQL 8.0 必加参数否则java.sql.Date插入会偏移 8 小时allowPublicKeyRetrievaltrue解决 SSL 认证兼容问题。这两个参数不加getConnection()会直接抛异常且错误信息极不友好。3. 核心业务模块实现挂号、退号、号源查询三连击的 Swing 事件链3.1 号源查询面板JTable 动态刷新 自定义 TableModelSwing 中JTable不是“绑定数据”而是通过TableModel接口桥接。课设常见错误是直接table.setModel(new DefaultTableModel(data, cols))导致无法响应数据库变更。正确做法是继承AbstractTableModel重写getRowCount()、getValueAt()并在数据变更后调用fireTableDataChanged()。// RegistrationTableModel.java可响应数据库变化的模型 public class RegistrationTableModel extends AbstractTableModel { private ListRegistration data new ArrayList(); private final String[] columnNames {ID, 患者姓名, 医生, 科室, 日期, 时间, 状态}; Override public int getRowCount() { return data.size(); } Override public int getColumnCount() { return columnNames.length; } Override public Object getValueAt(int rowIndex, int columnIndex) { Registration reg data.get(rowIndex); switch (columnIndex) { case 0: return reg.getRegId(); case 1: return reg.getPatName(); // 从 patient 表 JOIN 查询得到 case 2: return reg.getDocName(); case 3: return reg.getDeptName(); case 4: return reg.getRegDate(); case 5: return reg.getRegTime(); case 6: return reg.getStatus(); default: return null; } } Override public String getColumnName(int column) { return columnNames[column]; } // 外部调用此方法刷新数据如点击“刷新”按钮后 public void setData(ListRegistration newData) { this.data newData; fireTableDataChanged(); // 关键通知 JTable 重绘 } }// 在查询按钮事件中 JButton btnRefresh new JButton(刷新号源); btnRefresh.addActionListener(e - { try { ListRegistration list RegistrationDAO.findAllAvailable(); // DAO 层查询 SQL tableModel.setData(list); // 触发表格刷新 } catch (SQLException ex) { JOptionPane.showMessageDialog(null, 查询失败 ex.getMessage()); } });逻辑说明fireTableDataChanged()是 Swing 线程安全的关键。它向 EDT事件分发线程发送重绘请求确保getValueAt()被在正确线程调用。若在非 EDT 线程如数据库查询线程中直接修改data列表却不触发fireXXX表格将永远显示旧数据。3.2 挂号功能PreparedStatement 防注入 事务保证号源不超卖挂号本质是检查某医生某时段statusavailable的号源是否存在 → 若存在将其UPDATE为booked→ 同时插入patient表若新患者→ 最后插入registration关联记录。四个操作必须原子执行否则出现“号卖了但患者没录”或“号源被重复抢注”。// RegistrationService.java挂号业务方法 public boolean bookRegistration(int patId, int docId, LocalDate date, LocalTime time) { String sql INSERT INTO registration (pat_id, doc_id, reg_date, reg_time, status) SELECT ?, ?, ?, ?, booked FROM dual WHERE EXISTS ( SELECT 1 FROM registration WHERE doc_id ? AND reg_date ? AND reg_time ? AND status available LIMIT 1 ) ; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql, Statement.RETURN_GENERATED_KEYS)) { conn.setAutoCommit(false); // 开启事务 // 参数patId, docId, date, time, docId, date, timeWHERE 子句需重复 ps.setInt(1, patId); ps.setInt(2, docId); ps.setDate(3, Date.valueOf(date)); ps.setTime(4, Time.valueOf(time)); ps.setInt(5, docId); ps.setDate(6, Date.valueOf(date)); ps.setTime(7, Time.valueOf(time)); int affected ps.executeUpdate(); if (affected 0) { conn.rollback(); // 无可用号源回滚 return false; } // 获取生成的 reg_id用于日志或返回 try (ResultSet rs ps.getGeneratedKeys()) { if (rs.next()) { System.out.println(挂号成功reg_id rs.getLong(1)); } } conn.commit(); // 提交事务 return true; } catch (SQLException e) { try { if (conn ! null) conn.rollback(); } catch (SQLException rollbackEx) { System.err.println(回滚失败 rollbackEx.getMessage()); } return false; } }参数说明dual是 MySQL 虚拟表用于INSERT ... SELECT无源表场景EXISTS子查询确保只插入当且仅当存在可用号源Statement.RETURN_GENERATED_KEYS允许获取自增主键。此处未用乐观锁如 version 字段因课设并发量低EXISTS 事务已足够防超卖。3.3 退号功能状态回滚 级联清理逻辑退号不是简单DELETE FROM registration而是将status改回available以便其他患者可再预约。但需注意若患者是本次挂号才新增的即pat_id在本次挂号前不存在退号时应同步删除该患者记录避免垃圾数据堆积。// RegistrationService.java退号方法 public boolean cancelRegistration(long regId) { String sql UPDATE registration SET status available, pat_id NULL WHERE reg_id ? AND status booked ; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setLong(1, regId); int updated ps.executeUpdate(); if (updated 0) return false; // 未找到可退的号源 // 检查该挂号关联的患者是否为“仅此一条挂号记录” String checkSql SELECT COUNT(*) FROM registration WHERE pat_id (SELECT pat_id FROM registration WHERE reg_id ?) AND status ! available ; try (PreparedStatement checkPs conn.prepareStatement(checkSql)) { checkPs.setLong(1, regId); try (ResultSet rs checkPs.executeQuery()) { if (rs.next() rs.getInt(1) 0) { // 该患者无其他有效挂号可删除 String deletePatSql DELETE FROM patient WHERE pat_id ?; try (PreparedStatement delPs conn.prepareStatement(deletePatSql)) { delPs.setInt(1, getPatientIdByRegId(regId)); // 辅助方法 delPs.executeUpdate(); } } } } return true; } catch (SQLException e) { e.printStackTrace(); return false; } }逻辑说明先UPDATE号源状态再通过子查询判断患者是否“闲置”。这种“查-判-删”模式在高并发下有竞态风险但课设场景下完全可接受。真实系统会用SELECT FOR UPDATE加行锁课设无需过度复杂化。4. 避坑指南课设答辩老师最爱问的 4 个致命细节与血泪修复方案4.1 现象JTable 点击某行后getValueAt()返回 null但数据库里明明有数据原因TableModel的data列表被外部代码直接clear()或add()但未调用fireTableRowsInserted()/fireTableRowsDeleted()。Swing 的JTable缓存了行数getRowCount()返回旧值导致getValueAt(rowIndex, col)的rowIndex超出实际列表大小返回 null。解决所有对data列表的修改必须封装在setData()方法内并统一调用fireTableDataChanged()。禁止在 DAO 层或 Service 层直接操作TableModel的私有列表。4.2 现象输入中文患者姓名数据库存成乱码????但 Navicat 查看表结构显示 charset 是 utf8mb4原因JDBC URL 缺少characterEncodingutf8mb4参数或 MySQL 服务端my.cnf中collation-server未设为utf8mb4_unicode_ci。即使数据库和表是 utf8mb4连接层未声明编码Java 发送的 UTF-8 字节流会被 MySQL 当作 latin1 解析。解决在db.properties的db.url后追加characterEncodingutf8mb4并确认 MySQL 服务端配置# my.cnf [mysqld] collation-server utf8mb4_unicode_ci init-connectSET NAMES utf8mb4 character-set-server utf8mb44.3 现象点击“挂号”按钮后界面假死 5 秒期间无法点击任何按钮最后弹出成功提示原因数据库操作bookRegistration()在 EDT事件分发线程中同步执行。Swing 所有 UI 更新和事件处理都在 EDT阻塞它等于冻结整个界面。解决用SwingWorker将耗时操作移出 EDTnew SwingWorkerBoolean, Void() { Override protected Boolean doInBackground() throws Exception { return RegistrationService.bookRegistration(patId, docId, date, time); } Override protected void done() { try { if (get()) { JOptionPane.showMessageDialog(null, 挂号成功); refreshTable(); // 在 EDT 中刷新表格 } else { JOptionPane.showMessageDialog(null, 挂号失败号源已满); } } catch (Exception e) { JOptionPane.showMessageDialog(null, 系统错误 e.getMessage()); } } }.execute();4.4 现象同一医生同一天同一时间两个学生同时点击“挂号”结果数据库插入了两条statusbooked的记录原因EXISTS子查询在事务中未加锁两个并发请求同时查到statusavailable然后都执行INSERT。这是典型的“检查后执行”check-then-act竞态条件。解决课设级别用SELECT ... FOR UPDATE锁定待更新行需 InnoDB 引擎-- 在挂号前先锁定该医生该时段的可用号源行 SELECT reg_id FROM registration WHERE doc_id ? AND reg_date ? AND reg_time ? AND status available LIMIT 1 FOR UPDATE;然后在同一个事务中执行INSERT。注意FOR UPDATE必须在INSERT之前且在同一事务内。课设若不想改 SQL可加synchronized块仅限单 JVM 进程但FOR UPDATE是更标准的解法。5. 界面体验强化日期选择器、医生科室联动、号源余量高亮的三个实操技巧5.1 用 JCalendar 替代 JTextField 手输日期避免格式错误与非法日期让学生手动输入2023-13-01或2023-02-30是灾难。课设必须集成JCalendar开源 Swing 日历组件它提供图形化选择自动校验闰年、大小月且返回Date对象省去SimpleDateFormat解析步骤。!-- Maven 依赖pom.xml -- dependency groupIdcom.toedter/groupId artifactIdjcalendar/artifactId version1.4/version /dependency// 在挂号面板中 JDateChooser dateChooser new JDateChooser(); dateChooser.setDateFormatString(yyyy-MM-dd); // 显示格式 dateChooser.setDate(new Date()); // 默认设为今天 // 获取选中的日期java.util.Date Date selectedDate dateChooser.getDate(); if (selectedDate ! null) { LocalDate localDate selectedDate.toInstant() .atZone(ZoneId.systemDefault()).toLocalDate(); // 传给 service 层 }技巧JDateChooser的getDate()返回java.util.Date需转为LocalDate以匹配PreparedStatement.setDate()。toInstant().atZone().toLocalDate()是线程安全转换法比SimpleDateFormat安全得多。5.2 科室 → 医生二级联动用 ItemListener 实现 ComboBox 实时过滤挂号界面通常有“科室”和“医生”两个下拉框选科室后医生列表动态更新。新手常犯错在actionPerformed中清空医生 ComboBox 再addItem()导致每次选择都触发两次事件清空 添加。正确做法是用ItemListener监听“科室”选择变化并在itemStateChanged中区分ItemEvent.SELECTED。JComboBoxString deptCombo new JComboBox(); JComboBoxString docCombo new JComboBox(); // 科室选择监听 deptCombo.addItemListener(new ItemListener() { Override public void itemStateChanged(ItemEvent e) { if (e.getStateChange() ItemEvent.SELECTED) { String selectedDept (String) e.getItem(); try { ListString doctors DoctorDAO.findByDepartment(selectedDept); docCombo.removeAllItems(); doctors.forEach(docCombo::addItem); docCombo.setSelectedIndex(0); // 选第一个医生 } catch (SQLException ex) { JOptionPane.showMessageDialog(null, 加载医生失败); } } } });注意ItemListener比ActionListener更精准它明确区分“选中”和“取消选中”事件避免重复加载。5.3 号源余量高亮用 JTable 渲染器TableCellRenderer标记紧缺号源挂号系统核心指标是“余量”。在JTable中用不同背景色直观显示号源紧张程度绿色≥5、黄色1~4、红色0。这需要自定义TableCellRenderer。// AvailabilityRenderer.java余量列渲染器 public class AvailabilityRenderer extends DefaultTableCellRenderer { Override public Component getTableCellRendererComponent(JTable table, Object value, boolean isSelected, boolean hasFocus, int row, int column) { Component c super.getTableCellRendererComponent( table, value, isSelected, hasFocus, row, column); int availableCount (int) value; if (availableCount 5) { c.setBackground(Color.GREEN); } else if (availableCount 0) { c.setBackground(Color.YELLOW); } else { c.setBackground(Color.RED); } c.setForeground(Color.BLACK); return c; } } // 在表格初始化时设置 table.getColumnModel().getColumn(6).setCellRenderer(new AvailabilityRenderer()); // 第7列是余量逻辑说明TableCellRenderer是“画布”它不改变数据只决定如何绘制。value是TableModel.getValueAt(row, column)返回的值此处为整数余量。渲染器在每次重绘时调用性能开销极小。6. 课设交付前的终极 checklist从代码规范、文档到答辩话术的实战收尾课设不是写完代码就结束交付物包含代码、文档、演示视频、答辩 PPT 四部分。我带过的某高校课程设计中80% 的不及格案例败在“能跑但看不懂”——代码无注释、数据库无 ER 图、PPT 全是截图没逻辑。以下是我在模拟项目 X 中强制执行的收尾清单帮你避开所有隐形扣分点。6.1 代码层面三处必须存在的注释与结构每个.java文件头部用 JavaDoc 注释说明文件作用、作者可写“某开发者”、创建日期、关键类职责。例如/** * RegistrationDAO.java * 作者某开发者 * 创建日期2023-10-01 * 职责封装挂号相关数据库操作包括查询可用号源、挂号、退号。 * 注意所有方法均使用 PreparedStatement 防 SQL 注入。 */每个public方法内部用// TODO:标记待优化点如“TODO: 添加日志记录”体现工程思维用// HACK:标记临时绕过方案如“HACK: 日期格式化暂用 SimpleDateFormat后续改用 DateTimeFormatter”展示问题意识。SQL 文件分离将建表、初始化数据、常用查询语句单独存为sql/init.sql、sql/sample_data.sql而非硬编码在 Java 中。答辩时老师可直接mysql -u root -p init.sql验证。6.2 文档层面一份能讲清“为什么这么设计”的说明书课设文档不是代码说明书而是设计决策说明书。必须包含以下三张表文档章节必含内容示例数据库设计说明ER 图用 draw.io 导出 PNG、每张表的主外键说明、status字段取值含义“registration.statusavailable可约、booked已约未就诊、used已就诊不使用deleted状态避免逻辑删除污染统计”界面流程图用 Mermaid 语法或手绘拍照描述核心路径登录 → 选科室 → 选医生 → 选时段 → 确认挂号 → 成功页“挂号成功页包含生成的挂号 ID、医生姓名、就诊时间、‘打印凭证’按钮调用PrintJob”异常处理清单列出所有try-catch的异常类型、捕获原因、用户提示文案“SQLException捕获数据库连接失败或语句错误提示‘系统繁忙请稍后重试’不暴露 SQL 详情”提示ER 图不必用 PowerDesignerdraw.io 免费在线版足够。重点不是工具多高级而是你能说清“为什么科室和医生是一对多而挂号和患者是多对一”。6.3 答辩话术用“问题驱动”代替“功能罗列”老师不会关心你用了多少个JButton而是想听你如何解决问题。准备三句话覆盖所有高频问题问“为什么用 Swing 不用 JavaFX”答“课程要求基于 AWT/Swing 体系且 Swing 的事件模型EDT和 MVC 分离更利于理解 GUI 底层机制JavaFX 组件丰富但抽象层更高不利于调试数据库交互细节。”问“号源超卖怎么解决”答“采用数据库层面的SELECT ... FOR UPDATE行锁配合事务原子性。在挂号前锁定目标号源行确保同一时刻只有一个请求能修改其状态从根源上杜绝超卖。”问“如果要支持 1000 人同时挂号现在架构哪里会崩”答“当前单机 Swing 客户端 MySQL 单实例瓶颈在数据库连接数和 Swing 的 EDT 阻塞。升级方向是前端改 WebVue REST API后端用 Spring Boot 连接池 Redis 缓存号源余量数据库读写分离。”最后我的习惯是在src/main/resources下放一个README.md用 3 行写清运行步骤1. 确保 MySQL 5.7 运行执行 sql/init.sql 创建库表 2. 修改 db.properties 中的数据库密码 3. 运行 Main.java主窗体自动启动不写“请先安装 JDK”因为课设默认环境已配好不写“点击按钮即可”因为老师要看你是否理解每一步的意义。希望帮到你。本文还有配套的精品资源点击获取