Java SWT 桌面图书管理系统实战：从登录到借还的完整实现

简介这份资源是一套基于SWT构建的Java图书管理系统图形化界面项目面向已掌握Java基础、希望借助原生控件开发桌面应用的开发者与课程设计学生可用于解决图书信息管理、借阅归还与查询等典型业务场景的界面搭建问题。压缩包共259个文件约10.07MB包含45个java源码、107个class编译文件、80个ico图标、12张jpg图片及7个jar依赖库另附sql建库脚本、doc说明文档与exe可执行程序覆盖源码、资源与部署产物。已有484人学习下载。项目按主窗口、图书与读者数据访问、增删改分组界面等职责拆分多个类配合SWT布局管理、Table表格展示与对话框交互读者可从中理解事件驱动编程、JDBC数据库操作与模块化界面组织方式并参考资源加载与JAR打包思路快速搭建可运行的桌面端图书管理原型。1. 桌面端图书管理用 SWT 把 Java 图形界面做成能交付的样子接手一个图书管理系统的维护任务时很多人第一反应是打开浏览器写 Vue但真实场景里不少单位的内网机器根本不允许装现代浏览器或者业务方就认一个双击即开的桌面程序。这个项目走的是另一条路用 Java 加 SWT 做原生图形界面把图书录入、查询、借还、读者管理这些日常操作塞进一个不依赖 Web 容器的桌面客户端里。SWT 的特点是直接调用操作系统的原生控件窗口、表格、按钮长得跟系统自带程序一致启动快、内存占用低对老机器友好。适合谁适合要交课程设计的学生、要给内网做轻量工具的开发以及想找一个能跑起来的 Java 桌面 CRUD 骨架做二次开发的人。下面按「它长什么样、怎么跑、核心代码怎么写、哪里容易翻车、怎么改」的顺序拆。2. 项目结构与技术选型SWT 桌面客户端的骨架长什么样2.1 为什么是 SWT 而不是 Swing先把选型说清楚因为这决定了后面所有代码的写法。Swing 是 Java 自绘控件跨平台一致但观感偏旧SWT 走的是 JNI 调用本地控件库Windows 上就是 Win32 控件Linux 上是 GTK所以界面跟系统原生程序一个味道。代价是 SWT 依赖平台相关的本地库打包分发时要把对应平台的 jar 带上这是后面避坑章节要重点讲的地方。项目里常见的依赖就三块SWT 本体、JDBC 驱动、以及可选的日志或工具库。用 Maven 的话SWT 的坐标要带平台分类器比如 Windows 64 位是org.eclipse.swt.win32.win32.x86_64这一点新手最容易漏。!-- pom.xml 片段SWT 依赖必须带平台分类器 -- dependency groupIdorg.eclipse.platform/groupId artifactIdorg.eclipse.swt.win32.win32.x86_64/artifactId version3.124.0/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency上面这段的关键在classifier隐含在 artifactId 里不同平台换 artifactId 即可版本号按你本地仓库实际有的填。JDBC 驱动版本要和数据库服务端匹配MySQL 8 用 8.x 驱动5.7 用 5.1.x混用会报时区或认证插件错误。2.2 目录结构按职责分层别把 SQL 写进按钮回调一个能维护的桌面项目目录不该是「一个 Main 类加一堆监听器」。这个项目合理的组织方式是按职责分层界面层只负责收集输入和展示结果业务逻辑和数据访问各自独立。下面是我拆这类项目时常见的结构读者拿到源码可以对照着看book-manager/ ├── src/main/java/ │ ├── app/ # 程序入口Display/Shell 生命周期 │ │ └── MainApp.java │ ├── ui/ # 界面层窗口、表格、对话框 │ │ ├── LoginWindow.java │ │ ├── MainWindow.java │ │ └── BookEditDialog.java │ ├── service/ # 业务层借还规则、库存校验 │ │ ├── BookService.java │ │ └── BorrowService.java │ ├── dao/ # 数据访问层JDBC 增删改查 │ │ ├── BookDao.java │ │ └── ReaderDao.java │ ├── model/ # 实体类Book、Reader、BorrowRecord │ └── util/ # 连接池、日期格式化、弹窗封装 ├── src/main/resources/ │ └── db.properties # 数据库连接配置 └── lib/ # 非 Maven 方式下的 swt.jar、驱动 jar这个分层不是摆设。界面层拿到用户输入后调 serviceservice 做校验再调 daodao 只认 SQL 和实体对象。好处是换数据库只动 dao改界面只动 ui测试 service 不用起窗口。很多学生项目把SELECT * FROM book直接写在按钮的addSelectionListener里功能能跑但一改需求就牵一发动全身这是血泪经验。2.3 入口与窗口生命周期SWT 程序的骨架跟 Swing 不一样它有一个Display代表与操作系统的连接所有Shell窗口都挂在它下面事件循环靠readAndDispatch驱动。入口类通常长这样public class MainApp { public static void main(String[] args) { Display display new Display(); // 建立与本地窗口系统的连接 Shell shell new Shell(display); // 主窗口 shell.setText(图书管理系统); shell.setSize(900, 600); // 这里挂载主界面内容通常是 new MainWindow(shell).build(); shell.open(); while (!shell.isDisposed()) { // 事件循环窗口没关就一直转 if (!display.readAndDispatch()) { display.sleep(); // 没事件时让出 CPU } } display.dispose(); // 释放本地资源 } }Display和Shell必须成对释放display.dispose()漏掉在 Windows 上可能看不出问题但在 Linux 上会残留句柄。readAndDispatch返回 false 表示当前没有待处理事件此时sleep让线程挂起避免空转吃满一个核。这个循环是所有 SWT 程序的命脉后面任何弹窗、表格刷新都跑在这个线程里所以耗时操作比如大批量导入不能直接写在监听器里否则界面直接假死这是桌面开发跟 Web 最大的体感差异。3. 核心模块拆解从登录到借还的一条完整链路3.1 登录窗口与数据库连接登录是第一个能验证环境是否搭对的界面。它要做的事很朴素拿用户名密码去reader或admin表里比对成功就关掉登录窗、开主窗。SWT 里文本框用Text密码框加SWT.PASSWORD样式按钮用Button。关键代码在事件监听里Button loginBtn new Button(shell, SWT.PUSH); loginBtn.setText(登录); loginBtn.addSelectionListener(new SelectionAdapter() { Override public void widgetSelected(SelectionEvent e) { String user userText.getText().trim(); String pwd pwdText.getText(); if (user.isEmpty() || pwd.isEmpty()) { MessageBox box new MessageBox(shell, SWT.ICON_WARNING); box.setMessage(用户名和密码不能为空); box.open(); return; } // 交给 service 校验界面层不碰 SQL boolean ok new UserService().login(user, pwd); if (ok) { shell.dispose(); // 关闭登录窗 openMainWindow(); // 打开主界面 } else { MessageBox box new MessageBox(shell, SWT.ICON_ERROR); box.setMessage(账号或密码错误); box.open(); } } });SelectionAdapter是 SWT 提供的适配器只重写你关心的方法比实现整个SelectionListener干净。MessageBox是原生弹窗样式位SWT.ICON_WARNING、SWT.ICON_ERROR决定图标。注意shell.dispose()之后不能再操作这个 shell 的控件否则抛SWTException: Widget is disposed这是新手高频翻车点。数据库连接建议在util里封装一个DBUtil从db.properties读 url、用户名、密码用静态方法返回Connection别在每个 dao 里重复写驱动加载。3.2 图书列表TableViewer 与数据绑定主界面最核心的控件是图书列表。SWT 原生的Table要手动一行行TableItem塞数据代码又臭又长项目里更常见的做法是用 JFace 的TableViewer它支持内容提供器和标签提供器数据源直接给ListBook刷新时调viewer.setInput(list)即可。下面是一个最小可用的表格搭建TableViewer viewer new TableViewer(parent, SWT.BORDER | SWT.FULL_SELECTION); TableViewerColumn colId new TableViewerColumn(viewer, SWT.NONE); colId.getColumn().setText(编号); colId.getColumn().setWidth(80); // 其余列书名、作者、出版社、库存、状态写法同上 viewer.setContentProvider(ArrayContentProvider.getInstance()); viewer.setLabelProvider(new ITableLabelProvider() { public String getColumnText(Object element, int index) { Book b (Book) element; switch (index) { case 0: return String.valueOf(b.getId()); case 1: return b.getTitle(); case 2: return b.getAuthor(); case 3: return String.valueOf(b.getStock()); default: return ; } } // getColumnImage 返回 null 即可 }); viewer.getTable().setHeaderVisible(true); viewer.getTable().setLinesVisible(true); viewer.setInput(new BookService().listAll()); // 首次加载ArrayContentProvider把List当数组处理ITableLabelProvider的getColumnText按列索引返回字符串索引顺序必须和建列顺序严格一致错一位整列数据就串了。setInput是刷新入口增删改之后重新查库再setInput一次表格就更新了。数据量上千条时这种全量刷新会卡常见做法是加分页或改用LazyContentProvider但课程设计规模下全量足够。3.3 借还书业务事务与库存校验借书不是简单插一条记录它要同时做两件事写借阅记录、扣减库存这两步必须在一个事务里否则出现「记录写了库存没扣」的脏数据。service 层的写法public boolean borrow(int bookId, int readerId) { Connection conn null; try { conn DBUtil.getConnection(); conn.setAutoCommit(false); // 开启事务 BookDao bookDao new BookDao(conn); Book book bookDao.findById(bookId); if (book null || book.getStock() 0) { conn.rollback(); return false; // 库存不足回滚 } bookDao.decreaseStock(bookId); // 库存 -1 new BorrowDao(conn).insert(bookId, readerId); // 写借阅记录 conn.commit(); // 两步都成功才提交 return true; } catch (SQLException ex) { try { if (conn ! null) conn.rollback(); } catch (SQLException ignore) {} return false; } finally { DBUtil.close(conn); // 归还连接 } }setAutoCommit(false)是事务开关commit和rollback必须成对出现finally里关连接保证异常路径也不泄漏。dao 构造函数接收Connection而不是自己新建这样多个 dao 共享同一个事务连接这是事务能生效的前提。还书逻辑对称更新记录状态为已还、库存 1同样包在一个事务里。库存校验放在扣减之前且最好用UPDATE book SET stock stock - 1 WHERE id ? AND stock 0这种带条件的 SQL靠数据库行锁兜底比先查后改更抗并发。4. 跑起来与打包分发环境、命令和踩坑排查4.1 环境准备与启动步骤跑这个项目需要 JDK建议 8 或 11SWT 新版本对高版本 JDK 也支持但要注意模块化限制、数据库MySQL 常见、以及 SWT 本地库。步骤按顺序来先建库建表把项目里的schema.sql或建表语句执行一遍至少要有book、reader、borrow_record三张表再改db.properties里的连接信息然后确认 SWT jar 的平台版本跟你的系统一致最后从MainApp启动。用 Maven 的话一条命令编译运行# 编译并运行注意 SWT 依赖已按平台引入 mvn clean compile mvn exec:java -Dexec.mainClassapp.MainApp不用 Maven 的老项目就把swt.jar和驱动 jar 放进lib/编译时-cp lib/*运行时同样带上 classpath。启动后如果窗口一闪而过多半是main里抛了异常但没打印检查控制台堆栈。4.2 常见问题排查五条踩坑记录现象一启动报UnsatisfiedLinkError: no swt-win32-... in java.library.path。原因是用错了平台的 SWT jar比如在 Windows 上放了 Linux 版。解决是换对应平台的 artifactId 或 jar 文件64 位系统必须用 x86_64 版本32 位 JDK 配 32 位 SWT混用必炸。现象二界面能开但点查询按钮整个窗口卡住不动。原因是把耗时查询或大批量导入直接写在了widgetSelected里占住了 UI 线程。解决是把耗时逻辑丢到后台线程查完用display.asyncExec回到 UI 线程更新控件SWT 控件只能在创建它的线程里操作跨线程直接改会抛Invalid thread access。现象三中文显示成方块或乱码。原因是源码编码、数据库连接编码、控件字体三者不一致。解决是编译加-encoding UTF-8JDBC url 带useUnicodetruecharacterEncodingutf8建库时字符集用 utf8mb4三处对齐基本就正常了。现象四打包成 jar 后双击没反应命令行运行报找不到 SWT 本地库。原因是 SWT 的本地 dll/so 在 jar 里普通java -jar不会自动解压加载。解决是用mvn shade或assembly打 fat jar 时把本地库一并处理或者干脆用jar-in-jar方式更省事的做法是导出时把swt.jar放同级目录并用脚本指定 classpath。现象五借书成功但库存没变或者库存变了记录没写。原因是两步操作没包在同一个事务里或者 dao 各自拿了不同连接。解决是按 3.3 的写法共享一个ConnectionsetAutoCommit(false)后统一commit异常路径rollback。提示SWT 的Widget is disposed和Invalid thread access是这类项目里出现频率最高的两个异常前者查控件生命周期后者查线程归属基本能覆盖大半界面崩溃。5. 二次开发改造把课程设计级代码推到能用的程度拿到这套代码想继续改我一般从三个方向下手按投入产出排序。第一是数据访问层换连接池现在每个操作新建连接并发一高就顶不住引入 HikariCP 或 Druid把DBUtil.getConnection改成从池里取改动集中在一个类风险低收益明显。第二是界面与业务解耦把MainWindow里散落的校验逻辑抽到 service界面只做展示这样加「预约」「续借」这类新功能时不用动界面代码。第三是加一层简单的权限控制登录时把用户角色放进会话对象主界面按角色隐藏「图书维护」菜单SWT 里就是menuItem.setEnabled(false)或直接不创建。改造时验证方法要跟上。我的习惯是每改一个 dao 方法先在main里写个临时调用跑一遍确认 SQL 和事务没问题再接到界面上界面改动则固定走「登录 → 查询 → 借书 → 还书 → 关闭」这条主链路手动过一遍因为桌面程序没有浏览器那种刷新即恢复的后悔药状态残留很容易骗过眼睛。下面这张表是我改这类项目时常用的对照供参考改造点改动位置验证方式连接池util/DBUtil连续借还 50 次看连接是否泄漏业务抽离service 层主链路手动回归权限菜单MainWindow不同角色登录对比菜单分页查询BookDao TableViewer造 2000 条数据看滚动流畅度有个教训值得说早期我图省事在表格的setInput之后直接改TableItem的背景色标记逾期记录结果每次刷新颜色错位查了半天才发现TableViewer的刷新会重建 item得用LabelProvider的update方法或者viewer.refresh()配合列标记来做。从那以后我每次动表格展示逻辑都强制先造一批边界数据空值、超长书名、逾期记录跑一遍再提交。希望这些能帮你在拆这套 SWT 图书管理系统时少走点弯路。本文还有配套的精品资源点击获取