# 智能图书管理系统 (SLMS) ## 项目概述 本项目是一个基于Java的智能图书管理系统(SLMS)，展示了多种设计模式的应用。系统遵循SOLID原则，实现了图书管理、借阅记录、通知系统等功能。 ## 设计模式应用 ### 1. 单一职责原则 (Single Responsibility Principle) - **实现类**: `Book` 和 `Loan` - **职责分离**: - `Book` 类仅负责封装图书信息（书名、作者、ISBN等） - `Loan` 类仅负责管理借阅记录（借阅人、借阅时间、归还时间等） ### 2. 开闭原则 (Open/Closed Principle) - **实现类**: `Notification` 接口及其实现类 - **设计特点**: - 通过接口设计支持多种通知方式 - 新增通知方式时无需修改现有代码 - 实现类: `EmailNotification`, `SMSNotification`, `InAppNotification` ### 3. 单例模式 (Singleton Pattern) - **实现类**: `DatabaseConnection` - **设计特点**: - 确保系统运行期间仅存在一个数据库连接实例 - 使用双重检查锁定实现线程安全 - 提供全局访问点 ### 4. 观察者模式 (Observer Pattern) - **实现类**: `BookStatusObserver` 接口, `BookStatusSubject` 接口, `BookStatusManager`, `BookNotificationObserver` - **设计特点**: - 实现图书状态变更通知机制 - 支持多种事件类型（图书上架、借出、归还、逾期等） - 解耦被观察者和观察者之间的关系 ### 5. 工厂模式 (Factory Pattern) - **实现类**: `BookFactory` 接口, `PhysicalBookFactory`, `EBookFactory`, `JournalFactory`, `BookFactoryProvider` - **设计特点**: - 创建不同类型图书对象（实体书、电子书、期刊） - 支持动态注册新的图书类型 - 提供统一的图书创建接口 ## 项目结构 ``` SLMS/ ├── src/ │ └── main/ │ └── java/ │ └── com/ │ └── smartlibrary/ │ ├── SLMS.java # 主程序入口 │ ├── database/ │ │ └── DatabaseConnection.java # 数据库连接管理（单例模式） │ ├── factory/ │ │ ├── BookFactory.java # 图书工厂接口 │ │ ├── BookFactoryProvider.java # 工厂提供者 │ │ ├── EBookFactory.java # 电子书工厂 │ │ ├── JournalFactory.java # 期刊工厂 │ │ └── PhysicalBookFactory.java # 实体书工厂 │ ├── model/ │ │ ├── Book.java # 图书模型（单一职责原则） │ │ └── Loan.java # 借阅记录模型（单一职责原则） │ ├── notification/ │ │ ├── EmailNotification.java # 邮件通知（开闭原则） │ │ ├── InAppNotification.java # 应用内通知（开闭原则） │ │ ├── Notification.java # 通知接口（开闭原则） │ │ └── SMSNotification.java # 短信通知（开闭原则） │ └── observer/ │ ├── BookEventType.java # 图书事件类型枚举 │ ├── BookNotificationObserver.java # 图书状态通知观察者 │ ├── BookStatusManager.java # 图书状态管理器 │ ├── BookStatusObserver.java # 图书状态观察者接口 │ └── BookStatusSubject.java # 图书状态被观察者接口 └── src/ └── test/ └── java/ └── com/ └── smartlibrary/ └── test/ └── DesignPatternsTest.java # 设计模式测试类 └── docs/ ├── factory_pattern.puml # 工厂模式类图 ├── observer_pattern.puml # 观察者模式类图 ├── open_closed_principle.puml # 开闭原则类图 ├── single_responsibility_principle.puml # 单一职责原则类图 ├── singleton_pattern.puml # 单例模式类图 └── smart_library_system.puml # 系统综合类图 ``` ## 如何运行 ### 前置要求 - Java 8 或更高版本 - Maven 3.6 或更高版本（可选） - JDK 14+ （用于生成 GUI 安装包） - WiX Toolset v3.11 （用于生成 MSI 安装包） ### Android环境配置 本项目包含Android应用模块，需要以下环境配置： - **Android SDK**: `D:\development\Android` - **JDK**: `E:\2025-2026\GitAIOps\jdk` - **模拟器**: 已配置在Android SDK目录中 #### 环境变量设置 ```bash # 设置ANDROID_HOME环境变量 set ANDROID_HOME=D:\development\Android # 设置JAVA_HOME环境变量 set JAVA_HOME=E:\2025-2026\GitAIOps\jdk # 添加到PATH set PATH=%JAVA_HOME%\bin;%ANDROID_HOME%\platform-tools;%ANDROID_HOME%\tools;%PATH% ``` #### 构建Android APK 1. **清理项目**: ```bash gradlew clean ``` 2. **编译项目**: ```bash gradlew build ``` 3. **运行测试**: ```bash gradlew test gradlew connectedAndroidTest ``` 4. **构建Debug APK**: ```bash gradlew assembleDebug ``` 生成的APK位置: `android/build/outputs/apk/debug/android-debug.apk` 5. **构建Release APK**: ```bash gradlew assembleRelease ``` 生成的APK位置: `android/build/outputs/apk/release/android-release-unsigned.apk` 6. **安装到设备/模拟器**: ```bash gradlew installDebug ``` ### 方式一：使用Maven（推荐） 1. 运行PowerShell脚本（Windows）: ``` .\run_maven.ps1 ``` 2. 运行批处理脚本（Windows）: ``` .\run_maven_en.bat ``` 3. 或者手动执行以下命令: ``` # 编译项目 mvn compile # 运行主程序 mvn exec:java -Dexec.mainClass="com.smartlibrary.SLMS" ``` 4. 运行测试: ``` # 使用PowerShell脚本 .\test_maven.ps1 # 使用批处理脚本 .\test_maven_en.bat # 或者手动执行命令 java -cp "target/classes;target/test-classes;lib/*" com.smartlibrary.test.DesignPatternsTest ``` ### 方式二：不使用Maven 1. 运行PowerShell脚本（Windows）: ``` .\run.ps1 ``` 2. 运行批处理脚本（Windows）: ``` run.bat ``` 3. 或者手动执行以下命令: ``` # 创建编译输出目录 mkdir build # 编译主代码 $files = Get-ChildItem -Path "src\main\java" -Recurse -Filter "*.java"; javac -d build -cp "lib/*;src" -encoding UTF-8 $files.FullName # 编译测试代码 $files = Get-ChildItem -Path "src\test\java" -Recurse -Filter "*.java"; javac -d build -cp "lib/*;build" -encoding UTF-8 $files.FullName # 运行主程序 java -cp "build;lib/*" com.smartlibrary.SLMS ``` ### 运行测试 有以下几种方式运行测试： 1. 标准Maven命令（推荐）： ```bash mvn test ``` 2. PowerShell脚本：`. est_maven.ps1` 3. 批处理脚本（英文系统）：`. est_maven_en.bat` 4. 手动命令： ```bash java -cp "target/classes;target/test-classes;lib/*" com.smartlibrary.test.DesignPatternsTest ``` ### 生成 GUI 安装包（EXE 和 MSI） 本项目支持生成 Windows 平台的 GUI 应用安装包，包括独立可执行文件（EXE）和标准安装程序（MSI）。 #### 快速开始 1. **使用快速启动脚本**（推荐）: ```bash build-installers.bat ``` 2. **使用完整脚本**: ```bash scripts\build-gui-installers.bat ``` 3. **测试生成的安装包**: ```bash scripts\test-installers.bat ``` #### 生成的文件 构建完成后，在 `target` 目录会生成以下文件： - `slms-gui.exe` (约 50-80 MB) - 独立可执行文件，包含 JRE，无需安装 Java - `slms-gui-installer.msi` (约 50-80 MB) - Windows 标准安装程序，支持开始菜单快捷方式 - `README-GUI-EXE.txt` - EXE 版本使用说明 - `README-GUI-MSI.txt` - MSI 版本安装说明 #### 详细文档 - [GUI 安装包构建指南](GUI_INSTALLER_BUILD_GUIDE.md) - 详细的构建步骤和说明 - [GUI 安装包快速参考](GUI_INSTALLER_QUICK_REFERENCE.md) - 常用命令和故障排除 #### 使用场景 **EXE 版本**适用于： - 便携式使用（U盘运行） - 无需安装的快速测试 - 单用户环境 **MSI 版本**适用于： ## 设计模式图示 项目包含以下PlantUML类图，展示了各种设计模式的实现: - `single_responsibility_principle.puml`: 单一职责原则类图 - `open_closed_principle.puml`: 开闭原则类图 - `singleton_pattern.puml`: 单例模式类图 - `observer_pattern.puml`: 观察者模式类图 - `factory_pattern.puml`: 工厂模式类图 - `smart_library_system.puml`: 系统综合类图 可以使用PlantUML工具将这些文件转换为图片格式。 ## 系统功能 1. **图书管理**: 添加、查询、更新图书信息 2. **借阅管理**: 创建借阅记录、计算逾期罚款、管理归还 3. **通知系统**: 支持邮件、短信、应用内通知 4. **状态监控**: 实时监控图书状态变更并通知相关人员 ## 扩展性 系统设计具有良好的扩展性: 1. **新增通知方式**: 实现`Notification`接口即可 2. **新增图书类型**: 实现`BookFactory`接口并注册到`BookFactoryProvider` 3. **新增观察者**: 实现`BookStatusObserver`接口并注册到`BookStatusManager` ## 总结 本项目通过实现智能图书管理系统，展示了多种设计模式的应用，包括单一职责原则、开闭原则、单例模式、观察者模式和工厂模式。系统遵循SOLID原则，具有良好的可维护性和扩展性。 Gitea中的Webhook触发器： http://localhost:8084/generic-webhook-trigger/invoke?token=gitaiops123 gitaiops123为Jenkins的Webhook Token，Secret text类型的Token，用于Jenkins的Webhook触发器。