[TOC]

BookSystem 是一个基于 Java Swing 的现代化图书管理系统，支持图书的搜索、借阅、归还、用户管理等功能，界面美观，交互友好，适合高校、图书馆等场景使用。

本系统采用典型的三层架构设计，结构清晰，易于维护和扩展：

1. 表示层（GUI）

   • 基于 Java Swing 实现，负责与用户的交互，包含自定义UI组件和多种视图界面。
   • 主要目录：src/gui/
     • components/：自定义UI组件（如按钮、输入框、对话框等）
     • views/：各功能页面（如图书管理、借阅、用户管理等）

2. 业务逻辑层（Controller）

   • 负责处理具体的业务逻辑，如图书借阅、归还、用户验证等。
   • 主要目录：src/sql/
     • 例如：Book.java、BorrowController.java、UserController.java 等

3. 数据访问层（DAO）

   • 负责与数据库的交互，包括数据的增删改查。
   • 主要目录：src/sql/
     • 例如：MySQLConnection.java、ConnectionPool.java、MySQLCMD.java 等

4. 工具与资源层

   • 工具类：src/utils/，如常量定义、通用方法等
   • 资源文件：resource/，如图片、图标等

• 图书的添加、删除、修改
• 图书信息展示（卡片式/列表式）
• 图书库存管理（借出/归还自动更新库存）

• 支持书名、作者、ISBN 的模糊与实时搜索
• 搜索结果高亮与状态保持

• 用户注册、登录、信息维护
• 普通用户与管理员权限分离
• 用户借阅历史查询

• 借阅操作（防止重复借阅、借阅上限控制）
• 归还操作（自动更新库存与借阅记录）
• 借阅记录统计与展示

• 登录状态管理
• 统一风格UI与响应式设计
• 友好的错误与空状态提示
• 数据库连接池管理，提升访问效率

• 🔍 图书搜索：支持书名、作者、ISBN 的模糊与实时搜索，结果统计与状态保持
• 📚 图书管理：卡片式展示，支持添加、删除、借阅、归还，防止重复借阅，借阅上限控制
• 👤 用户管理：普通用户与管理员分权，登录、借阅状态实时显示
• 🖥️ 现代UI：自定义组件，统一风格，响应式设计，空状态友好提示
• 🗃️ 数据库支持：MySQL 持久化存储，JDBC 连接池高效管理

• 前端：Java Swing，自定义 UI 组件
• 后端：MySQL、JDBC
• 其他：自定义工具类、连接池、资源管理

• Java 8 及以上
• MySQL 数据库

CREATE DATABASE rental;
source database/database.sql;

本系统数据库主要包含以下表：

用于联合查询图书与借阅信息，便于统计和展示。

• borrow_record.book_id 外键关联 book.id
• borrow_record.user_id 外键关联 user.id
• 通过视图 v_book_borrow 可方便获取每本书的借阅情况及借阅人信息

• database/database.sql 文件已包含部分图书、用户和借阅记录的初始化数据，可直接导入。

javac -cp "src;src/lib/*" src/Main.java
java -cp "src;src/lib/*" Main

bookSystem/
├── src/                  # 源码目录
│   ├── gui/              # 图形界面相关代码
│   │   ├── components/   # 自定义UI组件（如按钮、输入框、对话框等）
│   │   └── views/        # 各功能页面视图（如图书管理、借阅、用户管理等）
│   ├── sql/              # 数据库操作与业务逻辑（如图书、用户、借阅控制器等）
│   ├── utils/            # 工具类（如常量定义、通用方法等）
│   └── lib/              # 第三方库（如MySQL驱动）
│   └── Main.java         # 程序主入口
├── database/             # 数据库脚本
│   └── database.sql      # 数据库结构及初始化数据
├── resource/             # 静态资源文件
│   ├── icon/             # 图标资源
│   ├── img/              # 图片资源
│   └── META-INF/         # Java元数据（如MANIFEST.MF）
├── README.md             # 项目说明文档
└── bookSystem.iml        # IDEA项目文件

• src/
  源代码主目录，包含所有Java源文件和依赖库。
  • gui/
    图形界面相关代码，负责用户交互和界面展示。
    • components/
      存放自定义UI组件，如按钮（iButton）、输入框（iField）、对话框（iDialog）、标签（iLabel）等，便于界面复用和统一风格。
    • views/
      各功能页面的实现，如用户管理（UserView）、图书借阅（BorrowView）、图书管理（BookChangeView）等。
    • 其他如Sys.java、actions.java等为界面控制和全局事件处理类。
  • sql/
    负责与数据库的交互和业务逻辑处理。包括：
    • 数据库连接与配置（MySQLConnection、ConnectionPool、MySQLConfig等）
    • 业务控制器（Book、UserController、BorrowController等）
    • 数据模型（UserItem、BorrowRecord等）
  • utils/
    工具类目录，包含常量定义（Constants.java）、通用方法（u.java）等，提升代码复用性。
  • lib/
    存放第三方依赖库，如MySQL JDBC驱动（mysql-connector-j-8.0.33.jar）。
  • Main.java
    程序主入口，负责启动整个应用。
• database/
  数据库相关文件，主要为数据库结构和初始化数据脚本（database.sql）。
• resource/
  静态资源文件目录。
  • icon/
    存放系统所用的图标文件（如add.png、search.png等）。
  • img/
    存放界面图片（如404页面、封面等）。
  • META-INF/
    Java应用的元数据文件（如MANIFEST.MF）。
• README.md
  项目说明文档，包含系统介绍、安装使用方法、架构与模块说明等。
• bookSystem.iml
  IntelliJ IDEA项目配置文件。

1. 登录系统
2. 搜索图书（支持实时、模糊搜索）
3. 借阅/归还图书
4. 查看"我的借阅"记录

1. 管理员账号登录
2. 添加/删除图书
3. 管理所有用户借阅记录

# 用户界面测试
java -cp "src;src/lib/*" test.UserViewTest

# 搜索组件演示
java -cp "src;src/lib/*" test.SearchDemo

• 确保 MySQL 服务已启动，数据库用户有权限
• 推荐使用 UTF-8 编码，避免中文乱码
• 数据库需包含项目所需的所有表结构和初始数据，建议直接通过 database/database.sql 脚本进行初始化，避免缺表或字段缺失导致运行异常

• 自动日志记录：系统运行状态、数据库连接、用户操作等自动记录
• 分级日志：支持 DEBUG、INFO、WARN、ERROR 四个级别
• 文件管理：按日期自动分割日志文件，自动清理7天前的旧日志
• 详细记录：包含时间戳、操作类型、错误堆栈等详细信息

• 日志文件保存在项目根目录的 logs/ 文件夹下
• 文件名格式：bookSystem_YYYY-MM-DD.log
• 例如：bookSystem_2024-01-15.log

1. 系统启动信息

   • Java版本、操作系统信息
   • 数据库配置和连接状态
   • GUI系统启动状态

2. 数据库操作日志

   • 连接成功/失败状态
   • SQL执行情况（查询、插入、更新、删除）
   • 错误代码和SQL状态

3. 用户操作日志

   • 用户注册、登录、密码修改
   • 图书借阅、归还操作
   • 管理员操作记录

4. 错误和异常

   • 详细的错误信息和堆栈跟踪
   • 数据库连接异常
   • 系统运行异常

• 直接用文本编辑器（如记事本、Notepad++、VSCode等）打开 logs/ 文件夹下对应日期的日志文件即可。

• 日志级别：默认记录所有级别
• 文件大小：无限制，建议定期清理
• 保留时间：自动清理7天前的日志文件

当系统出现问题时，请按以下步骤排查：

1. 查看最新的日志文件
2. 查找 ERROR 级别的日志信息
3. 检查数据库连接相关的日志
4. 根据错误信息进行相应的修复

欢迎提交 Issue 或 Pull Request 参与改进！

MIT License

1. 进入 out/artifacts/bookSystem_jar/ 目录（或你实际的jar包输出目录）。
2. 确保已安装 Java 8 及以上版本。
3. 确保 logs/ 文件夹和 resource/ 资源文件夹与 jar 包在同一目录下，或在 jar 包运行目录下存在。
4. 启动命令示例：

   java -jar bookSystem.jar

   其中 bookSystem.jar 为实际生成的 jar 包文件名。

• 运行前请确保 MySQL 数据库已启动，且数据库配置正确。
• 第一次运行会自动在当前目录下生成 logs/ 日志文件夹。
• 日志文件和资源文件需与 jar 包在同一目录，或通过参数指定。
• 如遇数据库连接失败、资源找不到等问题，请先查看 logs/ 文件夹下的日志文件，按日志内容排查。
• 若需更换数据库配置，请修改源码中的 src/Main.java 或提供外部配置支持。