Java图书管理系统实战：从数据库设计到JDBC编程完整指南

📅 发布时间：2026/8/12 15:52:47
Java图书管理系统实战：从数据库设计到JDBC编程完整指南 1. 项目概述与核心价值最近在整理过去的项目翻到了这个“图书管理系统”。这几乎是每个Java初学者在掌握了基础语法和数据库操作后第一个会尝试去做的综合性练手项目。它麻雀虽小五脏俱全涵盖了从数据建模、业务逻辑处理到用户交互的完整流程。今天我就把这个项目的完整实现思路、代码结构以及我踩过的那些“坑”系统地梳理一遍并附上完整的、可直接运行的代码。无论你是正在寻找课程设计素材的学生还是想通过一个完整项目巩固Java SE和数据库知识的自学者这篇文章都能给你提供一个清晰的、可复现的蓝本。这个系统本质上是一个控制台Console应用程序它模拟了图书馆的核心管理功能图书的录入、查询、借阅、归还以及读者信息的管理。我们不会使用任何图形界面如Swing或JavaFX而是专注于用最纯粹的Java代码和MySQL数据库来构建业务逻辑。这样做的好处是能让你剥离掉复杂UI的干扰真正理解数据是如何在程序与数据库之间流动的业务规则是如何被代码所定义的。这也是为什么它成为经典入门项目的原因——它强迫你去思考如何组织类Class、如何设计方法Method、如何处理异常Exception以及如何编写高效的SQL语句。2. 系统整体设计与技术选型2.1 核心需求与功能模块拆解在动手写第一行代码之前我们必须明确这个系统要做什么。基于常见的图书馆管理场景我将其核心功能拆解为以下几个模块图书信息管理模块这是系统的基石。需要能对图书进行增录入新书、删下架旧书、改更新信息如价格、状态、查按书名、作者、ISBN等条件检索操作。每本书的关键属性包括图书ID主键、ISBN号、书名、作者、出版社、价格、总数量、在馆数量、入库日期等。读者信息管理模块管理图书馆的会员或读者。功能同样包括增删改查。读者属性包括读者ID主键、姓名、性别、联系方式、办卡日期、可借阅数量上限、已借数量等。借阅与归还管理模块这是系统的业务核心。它连接了“图书”和“读者”两个实体。借阅功能检查读者是否存在、是否超过借阅上限检查图书是否存在、在馆数量是否大于0。满足条件后生成一条借阅记录并更新图书的“在馆数量”和读者的“已借数量”。归还功能根据借阅记录ID或图书读者信息找到对应的借阅记录。检查是否超期这里我们引入“借阅天数”和“应还日期”的概念如果超期则计算罚金。然后更新借阅记录状态为“已归还”并同步更新图书的“在馆数量”和读者的“已借数量”。借阅记录查询模块用于查询历史借阅记录可以按读者、按图书、按时间范围进行筛选特别是能方便地查看当前未归还的借阅记录。系统管理与统计模块进阶例如简单的用户登录区分管理员和普通读者、数据备份/导出、借阅排行榜、图书流通率统计等。作为基础版本我们可以先实现一个简单的控制台菜单和权限判断。2.2 技术栈与工具选型解析为什么选择这些技术每一个选择背后都有其考量。Java SE 8这是我们的编程语言和运行环境。选择8或以上版本是为了能使用LocalDate等现代日期时间API来处理日期这比老的Date和Calendar类要直观和稳定得多。MySQL 5.7关系型数据库的首选。它免费、流行、资料丰富非常适合学习JDBC。数据库的设计是整个项目的灵魂表结构设计得好后续编码会事半功倍。JDBC (Java Database Connectivity)Java连接数据库的标准API。我们不会使用任何ORM框架如MyBatis, Hibernate因为对于初学者亲手编写SQL语句、处理ResultSet是理解数据库操作原理的必经之路。这能让你深刻体会到SQL注入的风险以及使用PreparedStatement的重要性。Maven/Gradle项目管理工具。我强烈建议使用Maven哪怕项目很小。它帮你管理依赖如MySQL驱动包统一项目结构一键打包。pom.xml文件是项目的“配料表”。IDE: IntelliJ IDEA社区版就完全够用。它的智能提示、代码重构、数据库工具插件对开发效率提升巨大。注意在正式编码前请确保你的开发环境已就绪安装好JDK并配置好JAVA_HOME环境变量安装好MySQL并创建好数据库和用户IDE中配置好Maven。这些是前置步骤网上教程很多这里不再赘述。2.3 数据库表结构设计数据库设计是重中之重。一个糟糕的设计会让代码变得极其复杂。这里我采用三张核心表的设计表1:book(图书表)CREATE TABLE book ( id int(11) NOT NULL AUTO_INCREMENT COMMENT 主键ID, isbn varchar(20) NOT NULL UNIQUE COMMENT ISBN号唯一标识, name varchar(100) NOT NULL COMMENT 书名, author varchar(50) NOT NULL COMMENT 作者, publisher varchar(100) DEFAULT NULL COMMENT 出版社, price decimal(10,2) DEFAULT NULL COMMENT 价格, total_quantity int(11) NOT NULL DEFAULT 0 COMMENT 总数量, available_quantity int(11) NOT NULL DEFAULT 0 COMMENT 在馆可借数量, create_time datetime DEFAULT CURRENT_TIMESTAMP COMMENT 入库时间, PRIMARY KEY (id), KEY idx_isbn (isbn), KEY idx_name (name) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT图书信息表;设计思路id是自增主键用于内部关联。isbn具有业务唯一性所以设为UNIQUE键并加索引方便精确查询。total_quantity和available_quantity分开存储是关键前者是图书馆拥有该书的副本总数后者是当前在馆可借的数量。每次借阅available_quantity减1归还时加1。total_quantity一般只在购入新书或旧书报废时变更。表2:reader(读者表)CREATE TABLE reader ( id int(11) NOT NULL AUTO_INCREMENT COMMENT 主键ID, card_number varchar(20) NOT NULL UNIQUE COMMENT 借书卡号, name varchar(50) NOT NULL COMMENT 姓名, gender char(1) DEFAULT NULL COMMENT 性别M/F, phone varchar(20) DEFAULT NULL COMMENT 电话, max_borrow_limit int(11) NOT NULL DEFAULT 5 COMMENT 最大借阅数量限制, current_borrowed int(11) NOT NULL DEFAULT 0 COMMENT 当前已借数量, register_date date DEFAULT NULL COMMENT 注册日期, PRIMARY KEY (id), KEY idx_card_number (card_number) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT读者信息表;设计思路card_number借书卡号是读者的业务标识唯一。max_borrow_limit和current_borrowed用于控制借阅上限。每次借阅前需要判断current_borrowed max_borrow_limit。表3:borrow_record(借阅记录表)CREATE TABLE borrow_record ( id int(11) NOT NULL AUTO_INCREMENT COMMENT 主键ID, book_id int(11) NOT NULL COMMENT 图书ID, reader_id int(11) NOT NULL COMMENT 读者ID, borrow_date date NOT NULL COMMENT 借阅日期, due_date date NOT NULL COMMENT 应还日期, return_date date DEFAULT NULL COMMENT 实际归还日期, status tinyint(4) NOT NULL DEFAULT 0 COMMENT 状态0-借出未还1-已归还, fine_amount decimal(10,2) DEFAULT 0.00 COMMENT 超期罚金, PRIMARY KEY (id), KEY idx_book_id (book_id), KEY idx_reader_id (reader_id), KEY idx_status (status), KEY idx_due_date (due_date), CONSTRAINT fk_borrow_book FOREIGN KEY (book_id) REFERENCES book (id) ON DELETE CASCADE, CONSTRAINT fk_borrow_reader FOREIGN KEY (reader_id) REFERENCES reader (id) ON DELETE CASCADE ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT借阅记录表;设计思路这是系统的“流水账”。book_id和reader_id是外键关联到另外两张表并设置了ON DELETE CASCADE意味着当图书或读者被删除时其关联的借阅记录也会自动删除根据实际业务你可能想改为ON DELETE RESTRICT禁止删除这里仅为示例。borrow_date是借出当天due_date是根据规则计算出的应还日期例如借阅周期30天。return_date为空表示未还。status是一个状态标志方便查询。fine_amount记录罚金。为reader_id,book_id,status,due_date都建立了索引因为这些都是高频查询条件。3. 项目架构与核心代码实现3.1 项目工程结构Maven一个清晰的项目结构能让代码维护性大增。我们的项目结构如下book-management-system/ ├── pom.xml # Maven配置文件 ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/ │ │ │ └── library/ │ │ │ ├── MainApp.java # 程序主入口控制台菜单 │ │ │ ├── dao/ # 数据访问层 │ │ │ │ ├── BaseDao.java # 数据库连接和通用关闭方法 │ │ │ │ ├── BookDao.java │ │ │ │ ├── ReaderDao.java │ │ │ │ └── BorrowRecordDao.java │ │ │ ├── entity/ # 实体类对应数据库表 │ │ │ │ ├── Book.java │ │ │ │ ├── Reader.java │ │ │ │ └── BorrowRecord.java │ │ │ ├── service/ # 业务逻辑层 │ │ │ │ ├── BookService.java │ │ │ │ ├── ReaderService.java │ │ │ │ └── BorrowService.java │ │ │ └── util/ # 工具类 │ │ │ ├── DBUtil.java # 数据库连接池简化版 │ │ │ ├── DateUtil.java # 日期处理工具 │ │ │ └── InputUtil.java # 控制台输入工具 │ │ └── resources/ │ │ └── db.properties # 数据库配置文件 │ └── test/ # 测试目录可选 └── target/ # 编译输出目录分层架构解析entity纯数据类只有属性和getter/setter方法与数据库表字段一一对应。这是ORM思想的雏形。dao(Data Access Object)数据访问对象。这一层只负责和数据库打交道执行最原始的CRUD SQL操作。它接收和返回的都是entity对象。这里隐藏了所有JDBC的细节。service业务逻辑层。这是核心它调用一个或多个dao的方法组合成完整的业务操作。例如“借书”这个业务需要在BorrowService中先后调用ReaderDao查询读者、BookDao查询图书、检查条件、调用BorrowRecordDao插入记录并更新读者和图书的数量。事务控制也应该在这一层考虑。MainApp表示层虽然很简陋。它展示菜单接收用户输入调用对应的service完成功能并输出结果。3.2 核心实体类Entity定义以Book类为例展示如何用Java类映射数据库表package com.library.entity; import java.math.BigDecimal; import java.time.LocalDateTime; public class Book { private Integer id; private String isbn; private String name; private String author; private String publisher; private BigDecimal price; // 使用BigDecimal处理金额避免精度丢失 private Integer totalQuantity; private Integer availableQuantity; private LocalDateTime createTime; // 无参构造、全参构造、getter和setter方法省略... // 务必使用IDE生成保证准确性。 }关键点数据类型匹配price使用BigDecimalcreateTime使用LocalDateTime这与数据库的decimal和datetime类型对应。封装性所有属性私有通过公共的getter和setter方法访问。这是JavaBean的规范。Reader和BorrowRecord实体类依此类推。BorrowRecord中的日期字段建议使用LocalDate。3.3 数据库连接与工具类直接在每个DAO里写连接代码是灾难。我们需要一个集中管理数据库连接的地方。这里实现一个简易的DBUtil使用DBCP或HikariCP等连接池是生产级做法但为了简化我们先使用传统的DriverManager但将其单例化。package com.library.util; import java.io.IOException; import java.io.InputStream; import java.sql.Connection; import java.sql.DriverManager; import java.sql.SQLException; import java.util.Properties; public class DBUtil { private static String url; private static String user; private static String password; // 静态代码块在类加载时读取配置文件 static { try (InputStream is DBUtil.class.getClassLoader().getResourceAsStream(db.properties)) { Properties props new Properties(); props.load(is); url props.getProperty(db.url); user props.getProperty(db.user); password props.getProperty(db.password); // 加载驱动MySQL 6.0 可以省略但写上更稳妥 Class.forName(props.getProperty(db.driver)); } catch (IOException | ClassNotFoundException e) { throw new ExceptionInInitializerError(Failed to load database configuration, e); } } // 获取数据库连接 public static Connection getConnection() throws SQLException { return DriverManager.getConnection(url, user, password); } // 关闭连接的方法重载用于关闭Connection, Statement, ResultSet public static void close(AutoCloseable... closeables) { for (AutoCloseable closeable : closeables) { if (closeable ! null) { try { closeable.close(); } catch (Exception e) { // 日志记录这里简单打印 System.err.println(Error closing resource: e.getMessage()); } } } } }对应的src/main/resources/db.properties文件db.drivercom.mysql.cj.jdbc.Driver db.urljdbc:mysql://localhost:3306/library_db?useUnicodetruecharacterEncodingUTF-8serverTimezoneAsia/ShanghaiuseSSLfalse db.useryour_username db.passwordyour_password实操心得serverTimezoneAsia/Shanghai这个参数至关重要尤其是在使用高版本MySQL驱动和Java 8的日期API时不设置可能导致时间错误。useSSLfalse在本地开发环境通常需要否则可能连接失败。3.4 数据访问层DAO实现详解DAO层是JDBC操作的核心。我们以BookDao为例展示如何实现增删改查。最重要的一点使用PreparedStatement防止SQL注入并确保资源被正确关闭。package com.library.dao; import com.library.entity.Book; import com.library.util.DBUtil; import java.sql.*; import java.util.ArrayList; import java.util.List; public class BookDao { // 新增图书 public boolean addBook(Book book) { String sql INSERT INTO book (isbn, name, author, publisher, price, total_quantity, available_quantity) VALUES (?, ?, ?, ?, ?, ?, ?); Connection conn null; PreparedStatement pstmt null; try { conn DBUtil.getConnection(); pstmt conn.prepareStatement(sql); pstmt.setString(1, book.getIsbn()); pstmt.setString(2, book.getName()); pstmt.setString(3, book.getAuthor()); pstmt.setString(4, book.getPublisher()); pstmt.setBigDecimal(5, book.getPrice()); pstmt.setInt(6, book.getTotalQuantity()); pstmt.setInt(7, book.getAvailableQuantity()); // 新书在馆数量等于总数量 int affectedRows pstmt.executeUpdate(); return affectedRows 0; } catch (SQLException e) { e.printStackTrace(); return false; } finally { DBUtil.close(pstmt, conn); // 使用工具类关闭资源 } } // 根据ID查询图书 public Book getBookById(int id) { String sql SELECT * FROM book WHERE id ?; Connection conn null; PreparedStatement pstmt null; ResultSet rs null; Book book null; try { conn DBUtil.getConnection(); pstmt conn.prepareStatement(sql); pstmt.setInt(1, id); rs pstmt.executeQuery(); if (rs.next()) { book extractBookFromResultSet(rs); } } catch (SQLException e) { e.printStackTrace(); } finally { DBUtil.close(rs, pstmt, conn); } return book; } // 根据书名模糊查询 public ListBook getBooksByName(String nameKeyword) { ListBook bookList new ArrayList(); String sql SELECT * FROM book WHERE name LIKE ?; Connection conn null; PreparedStatement pstmt null; ResultSet rs null; try { conn DBUtil.getConnection(); pstmt conn.prepareStatement(sql); pstmt.setString(1, % nameKeyword %); // 模糊查询 rs pstmt.executeQuery(); while (rs.next()) { bookList.add(extractBookFromResultSet(rs)); } } catch (SQLException e) { e.printStackTrace(); } finally { DBUtil.close(rs, pstmt, conn); } return bookList; } // 更新图书信息例如修改价格或数量 public boolean updateBook(Book book) { // 注意这里通常不会更新isbn因为它是业务唯一标识。 String sql UPDATE book SET name?, author?, publisher?, price?, total_quantity?, available_quantity? WHERE id?; Connection conn null; PreparedStatement pstmt null; try { conn DBUtil.getConnection(); pstmt conn.prepareStatement(sql); pstmt.setString(1, book.getName()); pstmt.setString(2, book.getAuthor()); pstmt.setString(3, book.getPublisher()); pstmt.setBigDecimal(4, book.getPrice()); pstmt.setInt(5, book.getTotalQuantity()); pstmt.setInt(6, book.getAvailableQuantity()); pstmt.setInt(7, book.getId()); int affectedRows pstmt.executeUpdate(); return affectedRows 0; } catch (SQLException e) { e.printStackTrace(); return false; } finally { DBUtil.close(pstmt, conn); } } // 删除图书根据ID public boolean deleteBookById(int id) { String sql DELETE FROM book WHERE id ?; Connection conn null; PreparedStatement pstmt null; try { conn DBUtil.getConnection(); pstmt conn.prepareStatement(sql); pstmt.setInt(1, id); int affectedRows pstmt.executeUpdate(); return affectedRows 0; } catch (SQLException e) { e.printStackTrace(); return false; } finally { DBUtil.close(pstmt, conn); } } // 一个内部方法用于从ResultSet中提取Book对象避免代码重复 private Book extractBookFromResultSet(ResultSet rs) throws SQLException { Book book new Book(); book.setId(rs.getInt(id)); book.setIsbn(rs.getString(isbn)); book.setName(rs.getString(name)); book.setAuthor(rs.getString(author)); book.setPublisher(rs.getString(publisher)); book.setPrice(rs.getBigDecimal(price)); book.setTotalQuantity(rs.getInt(total_quantity)); book.setAvailableQuantity(rs.getInt(available_quantity)); // 处理时间戳转换 Timestamp timestamp rs.getTimestamp(create_time); if (timestamp ! null) { book.setCreateTime(timestamp.toLocalDateTime()); } return book; } }代码解析与避坑指南PreparedStatement的使用所有SQL语句中的变量都用?占位然后通过setXxx方法赋值。这能有效防止SQL注入攻击也是JDBC编程的铁律。资源关闭Connection,Statement(包括PreparedStatement),ResultSet都是需要关闭的资源。必须在finally块中关闭确保即使发生异常资源也能被释放。我们将其封装在DBUtil.close()中。结果集处理ResultSet使用前必须调用next()方法移动光标。extractBookFromResultSet方法是一个好实践它把从ResultSet到Entity对象的映射逻辑集中在一处便于维护。异常处理这里只是简单打印了堆栈信息。在实际项目中应该记录日志并根据业务需要向上层抛出更明确的业务异常。ReaderDao和BorrowRecordDao的实现逻辑类似主要区别在于SQL语句和实体映射。3.5 业务逻辑层Service实现与事务控制Service层是业务规则的落脚点。我们以最复杂的BorrowService.borrowBook借书方法为例。package com.library.service; import com.library.dao.*; import com.library.entity.Book; import com.library.entity.BorrowRecord; import com.library.entity.Reader; import com.library.util.DateUtil; import java.sql.Connection; import java.sql.SQLException; import java.time.LocalDate; public class BorrowService { private BookDao bookDao new BookDao(); private ReaderDao readerDao new ReaderDao(); private BorrowRecordDao borrowRecordDao new BorrowRecordDao(); /** * 借阅图书 * param bookId 图书ID * param readerId 读者ID * param borrowDays 借阅天数 * return 成功返回true失败返回false */ public boolean borrowBook(int bookId, int readerId, int borrowDays) { // 1. 验证图书是否存在且可借 Book book bookDao.getBookById(bookId); if (book null) { System.out.println(错误图书不存在。); return false; } if (book.getAvailableQuantity() 0) { System.out.println(错误该图书已全部借出。); return false; } // 2. 验证读者是否存在且未超借阅上限 Reader reader readerDao.getReaderById(readerId); if (reader null) { System.out.println(错误读者不存在。); return false; } if (reader.getCurrentBorrowed() reader.getMaxBorrowLimit()) { System.out.println(错误该读者借阅数量已达上限。); return false; } // 3. 核心业务逻辑需要在一个数据库事务中完成 // 模拟事务管理简化版实际应用应使用Spring等框架管理事务 Connection conn null; try { // 假设我们有一个能获取同一连接的方法需改造DBUtil和Dao层支持事务 // conn TransactionManager.getConnection(); // conn.setAutoCommit(false); // 开启事务 // 3.1 插入借阅记录 BorrowRecord record new BorrowRecord(); record.setBookId(bookId); record.setReaderId(readerId); record.setBorrowDate(LocalDate.now()); record.setDueDate(LocalDate.now().plusDays(borrowDays)); record.setStatus(0); // 0-未还 boolean recordSaved borrowRecordDao.save(record); // save方法需要接收Connection参数 // 3.2 更新图书在馆数量 (-1) book.setAvailableQuantity(book.getAvailableQuantity() - 1); boolean bookUpdated bookDao.updateBook(book); // update方法需要接收Connection参数 // 3.3 更新读者已借数量 (1) reader.setCurrentBorrowed(reader.getCurrentBorrowed() 1); boolean readerUpdated readerDao.updateReader(reader); // update方法需要接收Connection参数 if (recordSaved bookUpdated readerUpdated) { // conn.commit(); // 提交事务 System.out.println(借阅成功借阅记录ID: record.getId()); return true; } else { // conn.rollback(); // 回滚事务 System.out.println(借阅失败数据操作异常。); return false; } } catch (Exception e) { // if (conn ! null) try { conn.rollback(); } catch (SQLException ex) {} e.printStackTrace(); System.out.println(借阅过程发生异常操作已回滚。); return false; } finally { // DBUtil.close(conn); } } }业务逻辑与事务要点原子性操作借书不是一个简单的插入操作它涉及三个表的更新borrow_record插入book和reader更新。这三个操作必须全部成功或全部失败这就是事务Transaction。上面的代码注释展示了事务的雏形。在真正的项目中你会使用像Spring的Transactional注解来优雅地管理事务。业务规则校验在操作数据库前先进行业务规则校验图书可借、读者未超限这能提前避免无效的数据库操作。状态与数量同步book.available_quantity和reader.current_borrowed必须与borrow_record的状态严格同步。这是业务一致性的关键。returnBook还书方法的逻辑类似但需要检查是否超期并计算罚金然后更新borrow_record的return_date、status和fine_amount并反向更新book和reader的数量。3.6 主程序与控制台交互MainApp类负责提供用户界面。这里展示一个简单的控制台菜单驱动程序。package com.library; import com.library.service.BookService; import com.library.service.BorrowService; import com.library.service.ReaderService; import com.library.util.InputUtil; import java.util.Scanner; public class MainApp { private static Scanner scanner new Scanner(System.in); private static BookService bookService new BookService(); private static ReaderService readerService new ReaderService(); private static BorrowService borrowService new BorrowService(); public static void main(String[] args) { while (true) { showMainMenu(); int choice InputUtil.readInt(请选择操作); switch (choice) { case 1: manageBooks(); break; case 2: manageReaders(); break; case 3: borrowBook(); break; case 4: returnBook(); break; case 5: queryRecords(); break; case 0: System.out.println(感谢使用图书管理系统再见); scanner.close(); System.exit(0); default: System.out.println(输入无效请重新选择。); } } } private static void showMainMenu() { System.out.println(\n 图书管理系统 ); System.out.println(1. 图书管理); System.out.println(2. 读者管理); System.out.println(3. 借阅图书); System.out.println(4. 归还图书); System.out.println(5. 借阅记录查询); System.out.println(0. 退出系统); System.out.println(); } private static void manageBooks() { // 子菜单新增、查询、修改、删除图书 // 调用对应的 BookService 方法 System.out.println(\n--- 图书管理 ---); System.out.println(1. 新增图书); System.out.println(2. 查询图书); System.out.println(3. 修改图书信息); System.out.println(4. 删除图书); System.out.println(0. 返回上级); int choice InputUtil.readInt(请选择); switch (choice) { case 1: // 收集图书信息调用bookService.addBook(...) break; case 2: // 输入书名关键字调用bookService.getBooksByName(...)并打印结果 break; // ... 其他case } } // manageReaders, borrowBook, returnBook, queryRecords 方法类似需要调用相应的Service }InputUtil是一个工具类用于安全地读取控制台输入处理nextInt()后残留的换行符等问题提升用户体验。4. 项目运行、测试与常见问题4.1 如何运行本项目环境准备确保安装JDK 8MySQL 5.7Maven 3.6以及IntelliJ IDEA。创建数据库在MySQL中执行前面提供的SQL语句创建library_db数据库及三张表。修改配置将db.properties文件中的your_username和your_password改为你自己的MySQL凭据。导入项目在IDEA中直接打开pom.xml文件将其作为Maven项目导入。下载依赖Maven会自动下载mysql-connector-java驱动包。运行找到MainApp.java右键运行main方法。4.2 核心功能测试用例在编写代码时或完成后应对核心流程进行测试。你可以编写简单的JUnit测试或者在main方法中写一段测试代码。测试借书流程// 这是一个在MainApp中临时测试的方法 private static void testBorrowFlow() { // 1. 先确保有数据和读者 Book book new Book(); book.setIsbn(978-7-121-12345-6); book.setName(Java编程思想); book.setAuthor(Bruce Eckel); book.setTotalQuantity(5); book.setAvailableQuantity(5); bookService.addBook(book); // 假设已实现 Reader reader new Reader(); reader.setCardNumber(R20240001); reader.setName(张三); reader.setMaxBorrowLimit(5); readerService.addReader(reader); // 假设已实现 // 2. 执行借阅 boolean success borrowService.borrowBook(book.getId(), reader.getId(), 30); System.out.println(借阅测试结果 (success ? 成功 : 失败)); // 3. 验证数据 Book updatedBook bookService.getBookById(book.getId()); Reader updatedReader readerService.getReaderById(reader.getId()); System.out.println(图书在馆数量 updatedBook.getAvailableQuantity()); // 应为4 System.out.println(读者已借数量 updatedReader.getCurrentBorrowed()); // 应为1 }4.3 常见问题与排查技巧实录在开发过程中你几乎一定会遇到以下问题ClassNotFoundException: com.mysql.cj.jdbc.Driver原因MySQL驱动包未正确引入。解决检查pom.xml中是否有mysql-connector-java依赖版本是否合适如8.0.x。然后检查IDEA的Maven面板点击Reimport。确保依赖包已下载到本地仓库。Communications link failure或Access denied for user原因数据库连接失败。可能是URL、用户名、密码错误或者MySQL服务未启动或者网络问题。解决检查db.properties配置文件。在命令行或MySQL客户端用相同信息尝试连接。确认MySQL服务已运行sudo systemctl status mysql或netstat -an | grep 3306。检查防火墙是否屏蔽了3306端口。时间错误插入的日期比实际少8小时原因经典的时区问题。数据库服务器时区、连接字符串时区、Java应用时区不一致。解决在JDBC连接URL中强制指定时区如serverTimezoneAsia/Shanghai。同时确保数据库和操作系统的时区设置正确。PreparedStatement设置参数时索引错误原因pstmt.setString(1, ...)中的索引1对应SQL中第一个?如果顺序弄错会导致数据类型不匹配或值错位。解决仔细核对SQL语句中?的顺序与setXxx方法的索引。建议将SQL字符串和设置参数的代码对齐书写。事务问题部分操作成功部分失败导致数据不一致原因如借书时借阅记录插入成功但更新图书数量失败。解决这就是为什么需要事务。在当前的简化DAO中每个方法自己获取和关闭连接无法实现跨方法的事务。改进方案可以引入一个TransactionManager类在Service层开始时获取一个连接并将其通过参数传递给所有需要在这个事务中执行的DAO方法最后在Service层统一提交或回滚。这是向Spring等框架的事务管理迈进的第一步。内存泄漏数据库连接未关闭原因在复杂的异常处理路径中Connection,Statement,ResultSet可能没有被正确关闭。解决严格遵守“在finally块中关闭资源”的原则。使用DBUtil.close()这样的工具方法可以简化代码并减少遗漏。Java 7的try-with-resources语法是更优雅的解决方案。这个“图书管理系统”项目虽然基础但它像一块敲门砖敲开了Java企业级应用开发的大门。通过它你实践了MVC或分层架构的思想理解了数据库连接、SQL操作、事务控制等核心概念。你可以在此基础上无限扩展增加Web界面使用Spring Boot、添加缓存Redis、引入消息队列处理借阅超时提醒、实现更复杂的权限管理等等。希望这份详细的拆解和完整的代码能成为你Java学习路上一个扎实的起点。代码仓库的链接我会放在文末你可以克隆下来对照着文章一步步理解和修改。编程最好的学习方式就是动手遇到问题就解决它每一个踩过的坑都会让你变得更强大。

相关新闻