|
|
# SLMS GUI Application Guide
|
|
|
|
|
|
## 概述
|
|
|
|
|
|
智能图书管理系统（SLMS）的图形用户界面（GUI）应用，基于JavaFX 17开发，提供直观的图书和借阅管理功能。
|
|
|
|
|
|
---
|
|
|
|
|
|
## 系统要求
|
|
|
|
|
|
- **Java**: JDK 21
|
|
|
- **JavaFX**: 17 (通过Maven自动下载)
|
|
|
- **数据库**: SQLite (library.db)
|
|
|
- **操作系统**: Windows / macOS / Linux
|
|
|
|
|
|
---
|
|
|
|
|
|
## 快速启动
|
|
|
|
|
|
### 方法1: 使用批处理脚本（推荐）
|
|
|
```bash
|
|
|
run_gui.bat
|
|
|
```
|
|
|
|
|
|
### 方法2: 使用Maven命令
|
|
|
```bash
|
|
|
mvn javafx:run
|
|
|
```
|
|
|
|
|
|
### 方法3: 手动编译运行
|
|
|
```bash
|
|
|
# 设置Java环境
|
|
|
set JAVA_HOME=E:\2025-2026\GitAIOps\jdk
|
|
|
|
|
|
# 编译项目
|
|
|
mvn clean compile
|
|
|
|
|
|
# 运行GUI应用
|
|
|
mvn javafx:run
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 功能特性
|
|
|
|
|
|
### 📚 图书管理
|
|
|
- **查看图书列表**: 显示所有图书的详细信息
|
|
|
- **添加图书**: 通过表单添加新图书
|
|
|
- 支持实体书、电子书、期刊三种类型
|
|
|
- 自动生成图书ID
|
|
|
- ISBN唯一性验证
|
|
|
- **搜索图书**: 根据图书ID快速查找
|
|
|
- **刷新列表**: 实时更新图书数据
|
|
|
|
|
|
### 📖 借阅管理
|
|
|
- **借阅图书**:
|
|
|
- 输入图书ID和用户ID
|
|
|
- 自动检查图书可用性
|
|
|
- 设置30天借阅期限
|
|
|
- 更新图书状态
|
|
|
- **归还图书**:
|
|
|
- 输入图书ID
|
|
|
- 自动更新图书状态
|
|
|
- 记录归还日期
|
|
|
- **查看借阅记录**: 显示所有借阅历史
|
|
|
- 区分已归还和借阅中状态
|
|
|
- 显示借阅日期和应还日期
|
|
|
|
|
|
---
|
|
|
|
|
|
## 界面布局
|
|
|
|
|
|
### 主窗口
|
|
|
```
|
|
|
┌─────────────────────────────────────────────────────────┐
|
|
|
│ 文件 图书 帮助 │
|
|
|
├─────────────────────────────────────────────────────────┤
|
|
|
│ ┌─────────────┬─────────────────────────────────────┐ │
|
|
|
│ │ 图书管理 │ 借阅管理 │ │
|
|
|
│ └─────────────┴─────────────────────────────────────┘ │
|
|
|
│ │
|
|
|
│ [添加图书] [搜索图书] [刷新] │
|
|
|
│ │
|
|
|
│ ┌─────────────────────────────────────────────────────┐│
|
|
|
│ │ ID │ 书名 │ 作者 │ ISBN │ 出版社 │ 状态 │ 类型 ││
|
|
|
│ ├─────┼──────┼──────┼──────┼────────┼──────┼────────┤│
|
|
|
│ │B001 │Java..│Bruce.│978...│机械... │可借 │实体书 ││
|
|
|
│ │B002 │设计..│Erich.│978...│机械... │可借 │实体书 ││
|
|
|
│ │... │... │... │... │... │... │... ││
|
|
|
│ └─────────────────────────────────────────────────────┘│
|
|
|
├─────────────────────────────────────────────────────────┤
|
|
|
│ 就绪 │
|
|
|
└─────────────────────────────────────────────────────────┘
|
|
|
```
|
|
|
|
|
|
### 菜单栏
|
|
|
- **文件**: 退出应用
|
|
|
- **图书**: 快速添加图书
|
|
|
- **帮助**: 关于信息
|
|
|
|
|
|
### 选项卡
|
|
|
1. **图书管理**: 图书的增删改查
|
|
|
2. **借阅管理**: 借阅和归还操作
|
|
|
|
|
|
---
|
|
|
|
|
|
## 使用指南
|
|
|
|
|
|
### 添加图书
|
|
|
1. 点击"添加图书"按钮或菜单"图书 → 添加图书"
|
|
|
2. 在对话框中填写图书信息：
|
|
|
- 图书类型：实体书/电子书/期刊
|
|
|
- 书名
|
|
|
- 作者
|
|
|
- ISBN
|
|
|
- 出版社
|
|
|
- 出版日期
|
|
|
- 分类
|
|
|
3. 点击"添加"按钮
|
|
|
4. 系统自动刷新图书列表
|
|
|
|
|
|
### 搜索图书
|
|
|
1. 点击"搜索图书"按钮
|
|
|
2. 输入图书ID（如：B001）
|
|
|
3. 查看图书详细信息
|
|
|
|
|
|
### 借阅图书
|
|
|
1. 切换到"借阅管理"选项卡
|
|
|
2. 点击"借阅图书"按钮
|
|
|
3. 输入：
|
|
|
- 图书ID（如：B001）
|
|
|
- 用户ID（如：U1001）
|
|
|
4. 点击"确定"
|
|
|
5. 系统自动：
|
|
|
- 更新图书状态为"已借出"
|
|
|
- 创建借阅记录
|
|
|
- 设置30天后的应还日期
|
|
|
|
|
|
### 归还图书
|
|
|
1. 在"借阅管理"选项卡
|
|
|
2. 点击"归还图书"按钮
|
|
|
3. 输入图书ID
|
|
|
4. 点击"确定"
|
|
|
5. 系统自动：
|
|
|
- 更新图书状态为"可借"
|
|
|
- 更新借阅记录为"已归还"
|
|
|
- 记录归还日期
|
|
|
|
|
|
---
|
|
|
|
|
|
## 数据共享
|
|
|
|
|
|
GUI应用与其他三端应用共享同一个SQLite数据库（`library.db`）：
|
|
|
|
|
|
| 应用 | 状态 | 数据访问方式 |
|
|
|
|------|------|--------------|
|
|
|
| CLI应用 | ✅ 已测试 | 直接SQLite访问 |
|
|
|
| GUI应用 | ✅ 已测试 | 直接SQLite访问 |
|
|
|
| Web应用 | 🔄 就绪 | JDBC连接池 |
|
|
|
| Android应用 | 🔄 就绪 | SQLite Android API |
|
|
|
|
|
|
所有应用的数据实时同步，无需手动刷新。
|
|
|
|
|
|
---
|
|
|
|
|
|
## 测试报告
|
|
|
|
|
|
### 运行测试
|
|
|
```bash
|
|
|
run_gui_tests.bat
|
|
|
```
|
|
|
|
|
|
### 测试结果
|
|
|
- ✅ 所有测试通过：17/17 (100%)
|
|
|
- ✅ 图书管理功能正常
|
|
|
- ✅ 借阅管理功能正常
|
|
|
- ✅ 数据库同步正常
|
|
|
- ✅ JavaFX数据绑定正常
|
|
|
|
|
|
详细测试报告：[GUI_TEST_REPORT.md](GUI_TEST_REPORT.md)
|
|
|
|
|
|
---
|
|
|
|
|
|
## 技术架构
|
|
|
|
|
|
### 前端层
|
|
|
- **JavaFX 17**: UI框架
|
|
|
- **FXML**: 界面布局（可选）
|
|
|
- **CSS**: 样式定制（可选）
|
|
|
|
|
|
### 业务层
|
|
|
- **BookService**: 图书业务逻辑
|
|
|
- **工厂模式**: 图书对象创建
|
|
|
- **观察者模式**: 状态变更通知
|
|
|
|
|
|
### 数据层
|
|
|
- **DatabaseConnection**: 单例模式数据库连接
|
|
|
- **SQLite**: 轻量级数据库
|
|
|
- **JDBC**: 数据库访问
|
|
|
|
|
|
### 数据绑定
|
|
|
```java
|
|
|
ObservableList<Book> bookData = FXCollections.observableArrayList();
|
|
|
TableView<Book> bookTable = new TableView<>();
|
|
|
bookTable.setItems(bookData);
|
|
|
```
|
|
|
|
|
|
---
|
|
|
|
|
|
## 常见问题
|
|
|
|
|
|
### Q: 启动时提示找不到JavaFX模块？
|
|
|
**A**: Maven会自动下载JavaFX依赖，确保网络连接正常。
|
|
|
|
|
|
### Q: 窗口显示乱码？
|
|
|
**A**: 确保系统编码设置为UTF-8：
|
|
|
```bash
|
|
|
set JAVA_TOOL_OPTIONS=-Dfile.encoding=UTF-8
|
|
|
```
|
|
|
|
|
|
### Q: 数据不显示？
|
|
|
**A**:
|
|
|
1. 确保`library.db`文件存在
|
|
|
2. 运行`init_database.bat`初始化数据
|
|
|
3. 点击"刷新"按钮
|
|
|
|
|
|
### Q: 添加图书失败？
|
|
|
**A**: 检查：
|
|
|
1. ISBN是否重复
|
|
|
2. 所有必填字段是否填写
|
|
|
3. 数据库文件是否有写权限
|
|
|
|
|
|
---
|
|
|
|
|
|
## 性能优化
|
|
|
|
|
|
### 已实现
|
|
|
- ✅ 数据库连接池（单例模式）
|
|
|
- ✅ 懒加载数据
|
|
|
- ✅ 异步数据刷新
|
|
|
- ✅ 内存缓存
|
|
|
|
|
|
### 建议优化
|
|
|
- 🔄 分页加载大量数据
|
|
|
- 🔄 虚拟滚动表格
|
|
|
- 🔄 后台线程处理耗时操作
|
|
|
- 🔄 数据预加载
|
|
|
|
|
|
---
|
|
|
|
|
|
## 开发信息
|
|
|
|
|
|
- **开发语言**: Java 21
|
|
|
- **UI框架**: JavaFX 17
|
|
|
- **构建工具**: Maven 3.x
|
|
|
- **数据库**: SQLite 3.36
|
|
|
- **设计模式**: 单例、工厂、观察者、MVC
|
|
|
|
|
|
---
|
|
|
|
|
|
## 相关文档
|
|
|
|
|
|
- [CLI测试报告](CLI_TEST_REPORT.md)
|
|
|
- [GUI测试报告](GUI_TEST_REPORT.md)
|
|
|
- [Android开发总结](Android开发总结文档.md)
|
|
|
- [项目README](README.md)
|
|
|
|
|
|
---
|
|
|
|
|
|
## 联系方式
|
|
|
|
|
|
如有问题或建议，请联系开发团队。
|
|
|
|
|
|
**版本**: 1.0
|
|
|
**更新日期**: 2025-11-19
|
