Java Swing图书管理系统实战：从零搭建教学级数据库应用

简介这是一套基于Java Swing与MySQL开发的GUI图书管理系统实战项目面向计算机专业本科生及Java初学者适用于课程设计、毕业设计参考与Swing桌面应用入门实践。系统采用双角色架构学生/管理员完整覆盖登录、图书借还、读者管理、库存维护等核心业务流程技术栈清晰代码注释详实并附带配套课程报告。资源包共184个文件含35个Java源码、101个编译后Class文件、18张PNG与15张JPG界面资源图、3个MySQL建表与初始化SQL脚本以及Jar依赖、Docx报告和Eclipse工程配置文件整体24.47MB结构规范便于逐模块学习调试。目前已有601人下载学习开发者可直接导入Eclipse运行快速掌握Swing事件驱动编程、JDBC数据库连接、多角色权限控制及GUI布局设计等关键技能。1. 为什么还在用 Java Swing MySQL 做图书管理系统——它不是过时而是被低估的「教学级工业快照」你点开 GitHub 搜索 “图书管理系统”Top 20 里至少 12 个是 Java Swing MySQL 的组合在高校计算机课程设计作业提交平台里这个技术栈占比常年超 65%就连今年某省高校软件工程专业毕业设计答辩现场评委老师看到学生用 Spring Boot 写后台、Vue 做前端反而会多问一句“数据库连接池用了 HikariCP 吗事务传播行为怎么配的”——但当他翻到隔壁组用 Swing 表格展示借阅记录、MySQL 存着 3000 条图书数据、所有逻辑写在BookManagerFrame.java里时却点点头说“结构清晰边界明确能跑通及格。”这不是怀旧是现实约束下的精准选型它不追求高并发、不卷微服务、不拼响应速度而是在 200 行核心代码内完成“增删改查简单校验本地持久化”的闭环验证。它适合大二下学期刚学完 JDBC、还没碰过 Tomcat 的学生也适合需要快速交付一个内部科室用的纸质书目登记工具的小单位更关键的是——它把“数据如何从内存进磁盘”“界面事件如何触发 SQL 执行”“异常怎么一层层抛又一层层捕”这些黑匣子全摊开在你眼皮底下。没有 ORM 魔法没有 JSON 自动序列化没有跨域拦截器。你写的每一行executeUpdate()都对应着真实的一次磁盘写入你双击表格某一行触发的actionPerformed()就是整个业务流的起点。如果你正卡在“学了 Java 基础但不知道下一步做什么”或者要带课、出题、验收课程设计又或者只是想找回那种“改一行代码、编译、运行、立刻看到结果”的确定感——那这个看似“老掉牙”的组合恰恰是最短路径。2. 从零搭起骨架JDK、MySQL、IDE 三件套的最小可行配置2.1 JDK 版本选型别碰 JDK 21用 JDK 17 LTS 是血泪经验Swing 在 JDK 17 上已完全稳定Java SE 17 是长期支持版而 JDK 21 虽然更新但部分 Swing 组件如JTable的默认渲染器在某些 Linux 桌面环境GNOME 42下会出现字体模糊或列宽错乱。更重要的是几乎所有高校机房、课程设计服务器预装的都是 JDK 17 或 JDK 11你用 JDK 21 写完导出 JAR 包后在实验室电脑上双击直接报UnsupportedClassVersionError——这种翻车我见过 7 次。安装步骤Windows / macOS / Linux 通用# 1. 下载 OpenJDK 17推荐 Eclipse Temurin # 官网https://adoptium.net/zh-CN/temurin/releases/?version17 # 选择jdk-17.0.112-LTS (x64) # 2. 解压后配置环境变量以 Windows 为例 # JAVA_HOME D:\jdk-17.0.112-LTS # PATH 中追加%JAVA_HOME%\bin # 3. 验证 java -version # 输出应为openjdk version 17.0.1 2021-10-19提示java -version输出里必须含17.开头且不能有18、19、21。如果显示17.0.112-LTS说明成功若显示17.0.1-internal某些国产 JDK请换回 Temurin。2.2 MySQL 安装与初始化跳过 Workbench用命令行建库更可控很多同学卡在“MySQL 安装完连不上”本质是没分清服务进程mysqld和客户端mysql。Workbench 图形界面容易掩盖权限、socket 路径、密码策略等细节问题。我们用最简命令流搞定# 1. 下载 MySQL Community Server 8.0.x非 MySQL Installer # 官网https://dev.mysql.com/downloads/mysql/ → 选 ZIP Archive # 推荐版本mysql-8.0.33-winx64.zipWindows或 mysql-8.0.33-macos12-arm64.dmgM1/M2 Mac # 2. 解压到固定路径例如 D:\mysql-8.0.33-winx64 # 3. 初始化数据目录关键 cd D:\mysql-8.0.33-winx64\bin mysqld --initialize --console # 注意看最后几行输出会生成临时 root 密码形如 # A temporary password is generated for rootlocalhost: iY6sK!pL9qXv # 4. 安装服务Windows mysqld --install MySQL80 net start MySQL80 # 5. 登录并改密用上一步的临时密码 mysql -u root -p # 输入临时密码后执行 ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY your_secure_password; FLUSH PRIVILEGES; EXIT; # 6. 创建图书管理专用库UTF8MB4 兼容中文书名 mysql -u root -p -e CREATE DATABASE bookdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;参数说明--initialize生成 data 目录和初始 root 密码不可重复执行否则重置密码mysql_native_password强制使用传统认证插件避免 JDBC 连接时出现Client does not support authentication protocolutf8mb4_unicode_ci比utf8mb4_general_ci更准的中文排序规则支持 emoji 和生僻字如《蟫史》《龘》。2.3 IDE 选型IntelliJ IDEA Community 版足够别装 NetBeansNetBeans 对 Swing Designer 支持虽好但 2023 年后已停止维护新建项目常报Cannot resolve symbol SwingUtilities。IntelliJ IDEA Community免费配合官方 Swing UI Designer 插件默认启用开发效率更高。配置要点新建 Project → 选择Java→ SDK 选 JDK 17右键src→New → GUI Form→ 选Swing GUI Form→ 命名MainUI自动生成MainUI.form可视化布局文件和MainUI.java绑定逻辑在MainUI.java的构造方法里补上数据库连接初始化稍后第 3 章详述。注意不要勾选 “Create GUI Form in separate class”否则事件监听器无法直接访问JTable实例后期调试成本翻倍。3. 核心模块落地图书、读者、借阅三张表 四个 Swing 窗口的联动实现3.1 数据库建模三张表的字段设计与外键约束图书管理系统本质是一对多关系的具象化一本图书可被多人借阅借阅表是枢纽一个读者可借多本书。我们用最简范式设计不引入冗余字段表名字段名类型约束说明bookidBIGINT PK AI主键自增图书唯一 IDisbnVARCHAR(17)UNIQUE NOT NULLISBN-13 标准格式978-7-04-050694-5titleVARCHAR(200)NOT NULL书名支持 UTF8MB4authorVARCHAR(100)作者允许多作者用“/”分隔publisherVARCHAR(100)出版社pub_yearYEAR出版年份如 2022stockINT DEFAULT 0CHECK(stock 0)库存数借出时减归还时加readeridBIGINT PK AI主键自增读者 IDcard_noVARCHAR(20)UNIQUE NOT NULL借书证号学号/工号nameVARCHAR(50)NOT NULL姓名deptVARCHAR(50)所属院系/部门phoneVARCHAR(20)联系电话borrowidBIGINT PK AI主键自增借阅记录 IDbook_idBIGINTFK → book.id外键关联图书reader_idBIGINTFK → reader.id外键关联读者borrow_dateDATENOT NULL DEFAULT (CURRENT_DATE)借出日期return_dateDATENULL归还日期NULL 表示未还建表 SQL直接在 MySQL 命令行执行USE bookdb; CREATE TABLE book ( id BIGINT PRIMARY KEY AUTO_INCREMENT, isbn VARCHAR(17) UNIQUE NOT NULL, title VARCHAR(200) NOT NULL, author VARCHAR(100), publisher VARCHAR(100), pub_year YEAR, stock INT DEFAULT 0 CHECK (stock 0) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COLLATEutf8mb4_unicode_ci; CREATE TABLE reader ( id BIGINT PRIMARY KEY AUTO_INCREMENT, card_no VARCHAR(20) UNIQUE NOT NULL, name VARCHAR(50) NOT NULL, dept VARCHAR(50), phone VARCHAR(20) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COLLATEutf8mb4_unicode_ci; CREATE TABLE borrow ( id BIGINT PRIMARY KEY AUTO_INCREMENT, book_id BIGINT NOT NULL, reader_id BIGINT NOT NULL, borrow_date DATE NOT NULL DEFAULT (CURRENT_DATE), return_date DATE NULL, FOREIGN KEY (book_id) REFERENCES book(id) ON DELETE CASCADE, FOREIGN KEY (reader_id) REFERENCES reader(id) ON DELETE CASCADE ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COLLATEutf8mb4_unicode_ci;逻辑说明ON DELETE CASCADE是关键删除一本绝版书时自动清除所有历史借阅记录避免孤儿数据stock字段不设NOT NULL允许为 0但用CHECK约束防负数库存borrow_date默认值(CURRENT_DATE)由 MySQL 服务端生成比 Javanew Date()更可靠时区一致。3.2 JDBC 连接封装一个DBUtil类搞定所有 CRUDSwing 是单线程 GUI 框架所有数据库操作必须放在SwingWorker或新线程中否则界面会冻结。我们先写一个线程安全的连接工具类// src/utils/DBUtil.java package utils; import java.sql.*; public class DBUtil { private static final String URL jdbc:mysql://localhost:3306/bookdb?useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue; private static final String USER root; private static final String PASSWORD your_secure_password; // 生产环境请读配置文件 // 获取连接每次调用新建连接不复用 public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } // 关闭资源按 ResultSet → Statement → Connection 顺序 public static void closeQuietly(AutoCloseable... resources) { for (AutoCloseable r : resources) { if (r ! null) { try { r.close(); } catch (Exception ignored) {} } } } }参数说明useSSLfalseMySQL 8.0 默认要求 SSL本地开发关掉更省事生产环境必须开serverTimezoneAsia/Shanghai强制服务端时区避免borrow_date存成 UTC 时间allowPublicKeyRetrievaltrue解决 MySQL 8.0 密码认证兼容性问题closeQuietly方法用ignored吞异常因 Swing 中资源关闭失败不影响主流程。3.3 Swing 窗口拆解四个核心界面的职责与事件绑定整个系统由 4 个JFrame构成采用主窗口导航 子窗口模态对话框模式避免多窗口堆叠失控窗口名类名职责触发方式主菜单MainUI显示系统标题、功能按钮图书管理/读者管理/借阅管理/退出程序启动入口图书管理BookManageDialog查看全部图书、新增/编辑/删除图书MainUI中点击“图书管理”按钮弹出读者管理ReaderManageDialog查看读者列表、新增/编辑/删除读者MainUI中点击“读者管理”按钮弹出借阅管理BorrowManageDialog查询借阅记录、办理借书/还书MainUI中点击“借阅管理”按钮弹出以BookManageDialog为例其核心组件与事件绑定如下// src/ui/BookManageDialog.java简化版 public class BookManageDialog extends JDialog { private JTable table; // 显示图书列表 private DefaultTableModel tableModel; // 表格数据模型 private JTextField isbnField, titleField, authorField; // 输入框 public BookManageDialog(Frame owner) { super(owner, 图书管理, true); // true 表示模态对话框 initUI(); loadData(); // 初始化加载数据到表格 } private void initUI() { // 1. 设置表格模型列名 tableModel new DefaultTableModel( new Object[]{ID, ISBN, 书名, 作者, 出版社, 出版年, 库存}, 0 ); table new JTable(tableModel); // 2. 新增按钮监听 JButton addButton new JButton(新增); addButton.addActionListener(e - onAddBook()); // 3. 删除按钮监听需先选中行 JButton deleteButton new JButton(删除); deleteButton.addActionListener(e - onDeleteBook()); // 4. 布局略用 BorderLayout add(new JScrollPane(table), BorderLayout.CENTER); JPanel buttonPanel new JPanel(); buttonPanel.add(addButton); buttonPanel.add(deleteButton); add(buttonPanel, BorderLayout.SOUTH); } private void onAddBook() { // 获取输入框值 String isbn isbnField.getText().trim(); String title titleField.getText().trim(); String author authorField.getText().trim(); // 简单校验 if (isbn.isEmpty() || title.isEmpty()) { JOptionPane.showMessageDialog(this, ISBN 和书名不能为空); return; } // 异步执行插入避免阻塞 UI new SwingWorkerVoid, Void() { Override protected Void doInBackground() throws Exception { String sql INSERT INTO book(isbn, title, author) VALUES (?, ?, ?); try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql, Statement.RETURN_GENERATED_KEYS)) { ps.setString(1, isbn); ps.setString(2, title); ps.setString(3, author); ps.executeUpdate(); // 获取自增 ID 并刷新表格 try (ResultSet rs ps.getGeneratedKeys()) { if (rs.next()) { long id rs.getLong(1); tableModel.addRow(new Object[]{id, isbn, title, author, , , 0}); } } } return null; } Override protected void done() { JOptionPane.showMessageDialog(BookManageDialog.this, 添加成功); } }.execute(); } private void onDeleteBook() { int selectedRow table.getSelectedRow(); if (selectedRow -1) { JOptionPane.showMessageDialog(this, 请先选中要删除的图书); return; } long bookId (Long) tableModel.getValueAt(selectedRow, 0); int confirm JOptionPane.showConfirmDialog(this, 确认删除图书 ID bookId , 警告, JOptionPane.YES_NO_OPTION); if (confirm ! JOptionPane.YES_OPTION) return; new SwingWorkerVoid, Void() { Override protected Void doInBackground() throws Exception { String sql DELETE FROM book WHERE id ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setLong(1, bookId); ps.executeUpdate(); } return null; } Override protected void done() { tableModel.removeRow(selectedRow); // 刷新表格 JOptionPane.showMessageDialog(BookManageDialog.this, 删除成功); } }.execute(); } private void loadData() { new SwingWorkerVoid, Object[]() { Override protected Void doInBackground() throws Exception { String sql SELECT id, isbn, title, author, publisher, pub_year, stock FROM book ORDER BY id DESC; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql); ResultSet rs ps.executeQuery()) { while (rs.next()) { tableModel.addRow(new Object[]{ rs.getLong(id), rs.getString(isbn), rs.getString(title), rs.getString(author), rs.getString(publisher), rs.getObject(pub_year), // YEAR 类型返回 Integer rs.getInt(stock) }); } } return null; } }.execute(); } }关键设计点所有数据库操作包裹在SwingWorker中doInBackground()跑后台线程done()回 UI 线程刷新DefaultTableModel直接操作不引入额外框架新手一眼看懂数据流向删除前强制JOptionPane.showConfirmDialog防止误操作这是课程设计评分项之一ORDER BY id DESC保证最新添加的图书排在最上面符合用户直觉。4. 避坑指南五个让课程设计挂科的真实错误与修复方案4.1 现象程序启动时报java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver原因MySQL 8.0 驱动类名从com.mysql.jdbc.Driver改为com.mysql.cj.jdbc.Driver但很多教程、GitHub 旧代码仍写老名字或 Maven 依赖未正确引入。解决确认pom.xml中依赖为dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency在代码中显式注册驱动JDBC 4.0 可省略但加了更保险Class.forName(com.mysql.cj.jdbc.Driver); // 放在 getConnection() 前4.2 现象中文书名存进数据库变成???或查询出来是乱码原因JDBC URL 缺少字符集参数或 MySQL 服务端未设utf8mb4。解决JDBC URL 必须包含characterEncodingutf8mb4useUnicodetrue虽然useSSLfalse已隐含但显式写出更稳private static final String URL jdbc:mysql://localhost:3306/bookdb?useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltruecharacterEncodingutf8mb4useUnicodetrue;检查 MySQL 服务端配置my.ini或my.cnf[client] default-character-set utf8mb4 [mysqld] character-set-server utf8mb4 collation-server utf8mb4_unicode_ci4.3 现象点击“新增图书”后界面卡死控制台无报错原因在SwingWorker.doInBackground()中调用了JOptionPane.showMessageDialog()—— 这是 UI 线程方法不能在后台线程调用会导致死锁。解决所有 UI 操作弹窗、刷新表格必须放在done()方法中若需后台线程中提示进度用publish()process()机制Override protected Void doInBackground() throws Exception { publish(正在连接数据库...); Thread.sleep(500); publish(执行插入...); // ...数据库操作 return null; } Override protected void process(ListString chunks) { statusLabel.setText(chunks.get(chunks.size()-1)); // 更新状态栏 }4.4 现象借书时库存没减少还书时库存没增加原因借阅/归还逻辑未开启数据库事务或UPDATE语句未正确关联book_id。解决借书操作必须原子化查库存 → 判断是否 0 → 减库存 → 插入借阅记录。用事务包住try (Connection conn DBUtil.getConnection()) { conn.setAutoCommit(false); // 关闭自动提交 try (PreparedStatement checkPs conn.prepareStatement(SELECT stock FROM book WHERE id ?); PreparedStatement updatePs conn.prepareStatement(UPDATE book SET stock stock - 1 WHERE id ?); PreparedStatement insertPs conn.prepareStatement(INSERT INTO borrow(book_id, reader_id) VALUES (?, ?))) { checkPs.setLong(1, bookId); ResultSet rs checkPs.executeQuery(); if (rs.next() rs.getInt(stock) 0) { updatePs.setLong(1, bookId); updatePs.executeUpdate(); insertPs.setLong(1, bookId); insertPs.setLong(2, readerId); insertPs.executeUpdate(); conn.commit(); // 提交 } else { conn.rollback(); // 回滚 throw new RuntimeException(库存不足); } } }4.5 现象打包成 JAR 后双击运行报Failed to load Main-Class manifest attribute原因未在MANIFEST.MF中指定主类或 IntelliJ 打包时未勾选“Include in Jar”。解决IntelliJ 打包步骤File → Project Structure → Artifacts → → JAR → From modules with dependencies在Main Class下拉框中选ui.MainUI你的启动类点击OK→Build → Build Artifacts → Build生成的 JAR 包位于out/artifacts/xxx_jar/xxx.jar双击即可运行前提是本机已装 JDK 17。5. 进阶技巧让课程设计脱颖而出的三个硬核优化点5.1 用RowFilter实现表格实时搜索替代低效的“查库再刷新”课程设计常见做法是用户在搜索框输关键词 → 点击“查询”按钮 → 执行SELECT * FROM book WHERE title LIKE ?→ 清空表格 → 重新加载 ResultSet。这导致每次搜索都连一次数据库体验卡顿且不符合 Swing 设计哲学。正确做法一次性加载全量数据到内存用TableRowSorterRowFilter做客户端过滤。改造BookManageDialog.loadData()private void loadData() { // 1. 一次性查全量加 LIMIT 防爆内存图书系统一般 1w 条 String sql SELECT id, isbn, title, author, publisher, pub_year, stock FROM book ORDER BY id DESC LIMIT 10000; // ...执行查询填入 tableModel同前 // 2. 绑定排序器和过滤器 TableRowSorterDefaultTableModel sorter new TableRowSorter(tableModel); table.setRowSorter(sorter); // 3. 为搜索框添加实时过滤 JTextField searchField new JTextField(20); searchField.getDocument().addDocumentListener(new DocumentListener() { Override public void insertUpdate(DocumentEvent e) { doFilter(); } Override public void removeUpdate(DocumentEvent e) { doFilter(); } Override public void changedUpdate(DocumentEvent e) { doFilter(); } private void doFilter() { String text searchField.getText().trim(); if (text.isEmpty()) { sorter.setRowFilter(null); } else { // 在书名、作者、ISBN 三列中模糊匹配 sorter.setRowFilter(RowFilter.regexFilter((?i) text, 1, 2, 3)); // 列索引0id, 1isbn, 2title, 3author... } } }); }优势搜索响应毫秒级无网络延迟用户输入时自动过滤无需点击按钮(?i)开启忽略大小写regexFilter支持正则如输java.*spring可匹配《Java 并发编程实战》《Spring Boot 2 权威指南》不影响原有数据库操作纯 UI 层增强。5.2 用JFormattedTextField限制 ISBN 输入格式从源头防脏数据ISBN-13 是 13 位数字常带分隔符978-7-04-050694-5。手动校验易出错用JFormattedTextField可强制格式// 在 BookManageDialog.initUI() 中替换原 isbnField MaskFormatter isbnFormatter; try { isbnFormatter new MaskFormatter(####-#-##-######-#); isbnFormatter.setPlaceholderCharacter( ); isbnField new JFormattedTextField(isbnFormatter); } catch (ParseException e) { isbnField new JTextField(); // 降级为普通文本框 }效果用户输入时自动插入-且只允许数字和-输满 13 位数字后光标自动跳到末尾。提交前再用正则校验String rawIsbn isbnField.getText().replace(-, ); if (!rawIsbn.matches(\\d{13})) { JOptionPane.showMessageDialog(this, ISBN 必须为 13 位数字); return; }5.3 用JXDatePicker替代JTextField录入日期杜绝手输错误借阅日期、出版年份用手输2023-10-05极易输错。Swing 官方无日期选择器但org.jdesktop.swingx.JXDatePicker来自 SwingX 库轻量可靠Maven 依赖dependency groupIdorg.swinglabs.swingx/groupId artifactIdswingx-all/artifactId version1.6.5-1/version /dependency代码中使用JXDatePicker datePicker new JXDatePicker(); datePicker.setDate(Calendar.getInstance().getTime()); // 默认今天 datePicker.setFormats(new SimpleDateFormat(yyyy-MM-dd));价值点击弹出日历选日期比输字符串快 3 倍setFormats确保getDate()返回Date对象直接传给PreparedStatement.setDate()不用SimpleDateFormat.parse()课程设计答辩时老师点开日历选个日期比看你手输2023-02-30顺眼得多。我带过 5 届课程设计每年都有学生问我“老师用 Spring Boot 写是不是显得更高级” 我的回答永远是能用 Swing 把借书流程跑通、库存扣减准确、界面不卡死、异常有提示、代码有注释、答辩时能讲清SwingWorker为什么比Thread安全——这就已经超过 80% 的同龄人。高级框架是放大器不是替代品真正的工程能力藏在你为JTable列宽写table.getColumnModel().getColumn(2).setPreferredWidth(200)这样的细节里在你为stock字段加CHECK(stock 0)这样的约束里在你发现JOptionPane不能在后台线程调用后翻文档、查 Stack Overflow、最终用SwingWorker.done()解决的那一刻里。这个组合不会让你拿到大厂 offer但它会帮你拿下课程设计满分、建立对“数据-逻辑-界面”链路的肌肉记忆、攒下第一个能向家人演示的完整作品。当你某天真去写 Spring Cloud 微服务时你会感谢当年那个在DBUtil.java里逐行调试SQLException的自己。希望帮到你。本文还有配套的精品资源点击获取