1. 项目概述与核心价值最近在整理硬盘翻出来一个大学时期做的“图书管理系统”一个纯控制台、JavaMySQL的版本。现在看代码虽然稚嫩但麻雀虽小五脏俱全从数据库设计到业务逻辑再到异常处理和用户交互该有的环节一个不少。很多刚入门Java和数据库的朋友总想找个能串起知识点的实战项目这个控制台版的图书管理系统恰恰是一个绝佳的练手选择。它避开了复杂的前端框架和网络通信让你能专注于核心的业务流程、面向对象设计、数据库CRUD操作以及程序健壮性的打磨。无论你是正在学习Java SE和MySQL的学生还是想巩固基础、梳理开发流程的初级开发者通过亲手实现这样一个系统都能对“数据如何流动”、“业务如何编码”有一个非常直观和深刻的理解。接下来我就以这个老项目为蓝本拆解一下从零构建一个控制台版图书管理系统的完整思路、关键技术与那些容易踩坑的细节。2. 系统整体设计与架构思路2.1 需求分析与功能模块划分一个最基本的图书管理系统核心角色是“管理员”核心实体是“图书”和“借阅记录”。因此我们需要实现以下核心功能图书管理包括图书信息的添加、删除、修改、查询按编号、书名、作者等。借阅管理用户这里简化为读者借书、还书操作并记录借阅时间、应还时间。信息查询查询图书详情、查询某本书的借阅状态、查询所有借阅记录等。基于控制台的特点我们采用“菜单驱动”的交互模式。程序启动后展示一个文本菜单用户输入数字选择要执行的功能然后根据提示输入相应信息程序处理并反馈结果。这种模式逻辑清晰非常适合初学者理解程序的状态流转。在架构上我们采用经典的三层模型虽然控制台项目小但养成好的分层习惯至关重要表示层 (View)负责控制台的菜单显示、接收用户输入、输出结果信息。所有与System.out.println和Scanner相关的代码都应集中于此。业务逻辑层 (Service)负责处理具体的业务规则。例如借书前要检查图书是否存在且是否可借还书时要计算是否超期。这一层是系统的“大脑”。数据访问层 (DAO - Data Access Object)负责所有与MySQL数据库的交互操作包括增删改查。这一层将业务逻辑与具体的数据库操作解耦。2.2 技术选型与工具准备Java SE使用标准JDK版本8或11均可确保掌握基础语法、集合框架、JDBC。MySQL关系型数据库用于持久化存储图书、借阅记录等数据。建议使用5.7或8.0版本。JDBC DriverMySQL官方提供的Java数据库连接驱动 (mysql-connector-java)这是Java程序连接MySQL的桥梁。开发工具IntelliJ IDEA或Eclipse。IDEA在代码提示、数据库工具集成方面更友好。数据库管理工具MySQL Workbench或Navicat用于直观地创建库、表和执行SQL语句。注意在开始编码前务必确保你的开发环境已正确配置Java和MySQL。特别是MySQL需要记住安装时设置的root密码并确保MySQL服务已启动。很多新手卡在第一步就是因为数据库连不上。2.3 数据库表结构设计数据库设计是整个系统的基石设计的好坏直接影响后续开发的复杂度。我们至少需要两张核心表1. 图书表 (book)这张表存储图书的基本信息。CREATE TABLE book ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT 图书ID主键自增, isbn VARCHAR(20) UNIQUE NOT NULL COMMENT 国际标准书号具有唯一性, name VARCHAR(100) NOT NULL COMMENT 图书名称, author VARCHAR(50) NOT NULL COMMENT 作者, publisher VARCHAR(50) COMMENT 出版社, price DECIMAL(10, 2) COMMENT 价格, total_count INT NOT NULL DEFAULT 0 COMMENT 总库存数量, available_count INT NOT NULL DEFAULT 0 COMMENT 可借阅数量, status TINYINT DEFAULT 1 COMMENT 状态1-可借0-不可借如下架 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT图书信息表;设计解析id是代理主键用于内部关联通常自增。isbn具有业务唯一性用UNIQUE约束防止重复录入。total_count和available_count是关键字段。借书时available_count减1还书时加1。total_count代表物理总数通常不变除非采购或报废。这种设计避免了频繁的联表查询用空间换时间是常见的性能优化手段。status作为一个软删除或状态控制字段比直接物理删除记录更安全。2. 借阅记录表 (borrow_record)这张表记录每一次借阅行为。CREATE TABLE borrow_record ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT 记录ID, book_id INT NOT NULL COMMENT 图书ID外键关联book.id, reader_id VARCHAR(20) NOT NULL COMMENT 读者ID这里简化为学号/工号, reader_name VARCHAR(50) NOT NULL COMMENT 读者姓名, borrow_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 借阅时间, due_time DATETIME NOT NULL COMMENT 应还时间, return_time DATETIME COMMENT 实际归还时间, status TINYINT NOT NULL DEFAULT 0 COMMENT 状态0-借阅中1-已归还2-超期归还 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT借阅记录表;设计解析book_id是外键理论上应关联book.id。在实际操作中我们会在业务层保证有效性也可以在数据库层建立外键约束FOREIGN KEY (book_id) REFERENCES book(id)。将reader_name冗余存储在这里而不是只存reader_id再去关联一个用户表是为了在查询历史借阅记录时避免不必要的联表提高查询效率。这是一种典型的反范式设计用空间换时间。borrow_time默认取当前时间。due_time由系统根据规则计算如借期30天必须由程序传入。return_time初始为NULL还书时更新为当前时间。status用于快速判断记录状态比如筛选出所有“借阅中”的记录。3. 核心模块实现与代码解析3.1 数据库连接与工具类封装频繁地创建和关闭数据库连接是极其消耗资源的操作。因此我们第一个要封装的就是数据库连接工具类通常采用Druid或HikariCP等连接池。但对于初学者我们可以先实现一个简单的静态工具类来理解原理。import java.sql.Connection; import java.sql.DriverManager; import java.sql.SQLException; public class DBUtil { // 数据库配置信息 private static final String URL jdbc:mysql://localhost:3306/library_db?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai; private static final String USER root; private static final String PASSWORD your_password; // 替换为你的密码 static { try { // 加载驱动 (MySQL 8.0 可以省略但显式加载更稳妥) Class.forName(com.mysql.cj.jdbc.Driver); } catch (ClassNotFoundException e) { e.printStackTrace(); throw new RuntimeException(找不到MySQL JDBC驱动); } } // 获取数据库连接 public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } // 关闭连接重载方法用于关闭Connection, Statement, ResultSet public static void close(AutoCloseable... closables) { for (AutoCloseable closable : closables) { if (closable ! null) { try { closable.close(); } catch (Exception e) { e.printStackTrace(); // 生产环境应使用日志记录而非打印 } } } } }实操要点URL中的参数很重要useUnicode和characterEncoding保证中文不乱码useSSLfalse在本地开发环境通常关闭serverTimezone必须设置否则可能报时区错误。close方法使用了可变参数和AutoCloseable接口可以优雅地关闭多种资源避免重复代码。重要经验在实际项目中数据库配置URL、用户名、密码绝不应该硬编码在代码里而应该放在配置文件如.properties或.yml中。这里为了演示简化了。3.2 数据访问层(DAO)实现以BookDao为例DAO层是纯技术层只关心如何执行SQL。我们以BookDao为例展示如何实现增删改查。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_count, available_count) 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.getTotalCount()); pstmt.setInt(7, book.getAvailableCount()); // 新增时可借数通常等于总数 return pstmt.executeUpdate() 0; } catch (SQLException e) { e.printStackTrace(); // 处理重复ISBN等异常 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 name) { ListBook bookList new ArrayList(); String sql SELECT * FROM book WHERE name LIKE ?; // ... 实现类似 getBookById使用 while(rs.next()) 遍历结果集 return bookList; } // 更新图书信息例如修改库存 public boolean updateBook(Book book) { String sql UPDATE book SET name?, author?, publisher?, price?, total_count?, available_count? WHERE id?; // ... 使用 PreparedStatement 设置参数并执行 } // 删除图书逻辑删除将status置为0 public boolean deleteBook(int id) { String sql UPDATE book SET status0 WHERE id?; // ... 实现 } // 从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.setTotalCount(rs.getInt(total_count)); book.setAvailableCount(rs.getInt(available_count)); book.setStatus(rs.getInt(status)); return book; } }注意事项必须使用PreparedStatement它能够预编译SQL防止SQL注入攻击比Statement更安全、高效。所有动态参数都必须用?占位并通过setXXX方法设置。资源关闭顺序遵循ResultSet - Statement - Connection的顺序关闭且必须在finally块中执行确保异常发生时资源也能被释放。异常处理DAO层通常只抛出SQLException或者捕获后转换为自定义的业务异常由上层处理。这里简单打印了堆栈实际项目应用日志框架记录。实体类(Book)需要有一个对应的Book类属性与数据库字段一一对应并配备getter/setter方法。3.3 业务逻辑层(Service)实现借书还书业务Service层包含核心业务规则。我们实现一个BorrowService它需要依赖BookDao和BorrowRecordDao。public class BorrowService { private BookDao bookDao new BookDao(); private BorrowRecordDao recordDao new BorrowRecordDao(); /** * 借书业务逻辑 * param bookId 图书ID * param readerId 读者ID * param readerName 读者姓名 * param borrowDays 借阅天数 * return 借阅是否成功 */ public boolean borrowBook(int bookId, String readerId, String readerName, int borrowDays) { // 1. 检查图书是否存在且可借 Book book bookDao.getBookById(bookId); if (book null) { System.out.println(错误图书不存在); return false; } if (book.getStatus() ! 1) { System.out.println(错误图书状态不可借); return false; } if (book.getAvailableCount() 0) { System.out.println(错误图书库存不足); return false; } // 2. 检查读者是否已有超期未还记录简易版实际可能更复杂 // 这里可以调用 recordDao 查询该读者的超期记录略过。 // 3. 开启事务简易版先不考虑 try { // 4. 创建借阅记录 BorrowRecord record new BorrowRecord(); record.setBookId(bookId); record.setReaderId(readerId); record.setReaderName(readerName); record.setBorrowTime(new Timestamp(System.currentTimeMillis())); // 计算应还时间 long dueTimeMillis System.currentTimeMillis() (borrowDays * 24L * 60 * 60 * 1000); record.setDueTime(new Timestamp(dueTimeMillis)); record.setStatus(0); // 借阅中 boolean recordSuccess recordDao.addRecord(record); if (!recordSuccess) { System.out.println(错误创建借阅记录失败); return false; } // 5. 更新图书可借数量 book.setAvailableCount(book.getAvailableCount() - 1); boolean updateSuccess bookDao.updateBook(book); if (!updateSuccess) { System.out.println(错误更新图书库存失败); // 这里应该回滚上一步的借阅记录需要事务支持 return false; } System.out.println(借书成功应还日期 record.getDueTime()); return true; } catch (Exception e) { e.printStackTrace(); return false; } } /** * 还书业务逻辑 * param recordId 借阅记录ID * return 归还是否成功 */ public boolean returnBook(int recordId) { // 1. 查询借阅记录 BorrowRecord record recordDao.getRecordById(recordId); if (record null || record.getStatus() ! 0) { System.out.println(错误借阅记录不存在或已归还); return false; } // 2. 更新记录状态和归还时间 record.setReturnTime(new Timestamp(System.currentTimeMillis())); long currentTime System.currentTimeMillis(); long dueTime record.getDueTime().getTime(); if (currentTime dueTime) { record.setStatus(2); // 超期归还 System.out.println(提示已超期归还请处理相关事宜。); } else { record.setStatus(1); // 正常归还 } // 3. 更新图书可借数量 Book book bookDao.getBookById(record.getBookId()); if (book ! null) { book.setAvailableCount(book.getAvailableCount() 1); bookDao.updateBook(book); } // 4. 更新借阅记录 boolean success recordDao.updateRecord(record); if (success) { System.out.println(还书成功); } return success; } }业务逻辑解析借书这是一个典型的“先查后改”业务。核心是保证“检查库存”和“减少库存”这两个操作在逻辑上的原子性。在并发情况下多个用户同时借同一本最后一本书可能会造成超借。这里简易版的实现存在并发问题真正的解决方案是使用数据库事务和行级锁SELECT ... FOR UPDATE或者使用乐观锁版本号。还书相对简单主要是状态更新。计算是否超期的逻辑是关键。事务上面的代码在借书时插入记录和更新库存是两个独立操作如果更新库存失败系统会留下一条无效的借阅记录。在实际项目中必须将这两个操作放在同一个数据库事务中保证要么都成功要么都失败。可以使用Connection的setAutoCommit(false)、commit()和rollback()手动控制或使用Spring的Transactional注解。3.4 表示层(View)与控制台菜单驱动表示层是用户交互的入口需要设计清晰的菜单和友好的提示。import java.util.Scanner; public class LibraryConsoleApp { private static Scanner scanner new Scanner(System.in); private static BookService bookService new BookService(); private static BorrowService borrowService new BorrowService(); public static void main(String[] args) { while (true) { showMainMenu(); int choice getIntInput(请选择操作); switch (choice) { case 1: addBookMenu(); break; case 2: queryBookMenu(); break; case 3: borrowBookMenu(); break; case 4: returnBookMenu(); break; case 5: System.out.println(感谢使用再见); scanner.close(); return; default: System.out.println(输入错误请重新选择); } System.out.println(\n按回车键继续...); scanner.nextLine(); // 等待用户回车 } } 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(); } private static void addBookMenu() { System.out.println(\n--- 新增图书 ---); System.out.print(请输入ISBN: ); String isbn scanner.nextLine(); System.out.print(请输入书名: ); String name scanner.nextLine(); // ... 获取其他信息 Book book new Book(isbn, name, ...); boolean success bookService.addBook(book); if (success) { System.out.println(新增图书成功); } else { System.out.println(新增图书失败请检查ISBN是否重复或信息是否正确。); } } private static void borrowBookMenu() { System.out.println(\n--- 借阅图书 ---); int bookId getIntInput(请输入要借阅的图书ID: ); System.out.print(请输入读者ID: ); String readerId scanner.nextLine(); System.out.print(请输入读者姓名: ); String readerName scanner.nextLine(); int days getIntInput(请输入借阅天数: ); boolean success borrowService.borrowBook(bookId, readerId, readerName, days); // 结果已在service中输出 } // 一个安全的获取整数输入的方法防止用户输入非数字导致程序崩溃 private static int getIntInput(String prompt) { while (true) { System.out.print(prompt); try { return Integer.parseInt(scanner.nextLine().trim()); } catch (NumberFormatException e) { System.out.println(输入错误请输入一个有效的数字); } } } }交互设计心得输入验证getIntInput方法展示了如何处理非数字输入避免InputMismatchException。对于其他输入如日期也应做类似校验。用户体验菜单循环、操作后的暂停scanner.nextLine()让用户有足够时间看清结果。清晰的提示信息至关重要。职责分离控制台类只负责输入输出和菜单调度具体的业务逻辑全部委托给Service层。这使得代码结构清晰易于维护和测试。4. 项目进阶与优化思考完成基础版本后这个项目还有巨大的优化和扩展空间这也是从“能跑”到“好用”的关键。4.1 引入数据库连接池我们之前的DBUtil每次操作都新建连接性能极差。引入Druid连接池是生产级应用的标配。添加Druid依赖Maven项目在pom.xml中添加。创建druid.properties配置文件配置连接池参数初始连接数、最大连接数、超时时间等。改造DBUtil在静态块中初始化DruidDataSource并从getConnection()方法中获取连接。4.2 使用DAO模式与接口抽象目前的BookDao是具体类。更好的做法是定义一个IBookDao接口然后提供BookDaoImpl实现。这样便于后续切换数据源比如换成别的数据库或进行单元测试可以创建Mock实现。4.3 处理并发问题如前所述借书操作存在并发超借风险。解决方案悲观锁在Service层的借书方法中先SELECT ... FOR UPDATE锁定图书记录然后再进行后续操作。这需要将多个数据库操作放在一个事务中。// 伪代码在事务中 Book book bookDao.getBookByIdForUpdate(bookId); // 这个方法执行 SELECT ... FOR UPDATE if (book.getAvailableCount() 0) { // 执行借阅逻辑 }乐观锁在book表增加一个version字段。更新时除了条件id?还要加上AND version?并将version1。如果更新行数为0说明版本号不对被其他事务修改过操作失败需要重试或提示用户。4.4 加入日志记录使用Log4j2或SLF4J替换掉代码中所有的System.out.println和e.printStackTrace()。日志可以分级DEBUG, INFO, WARN, ERROR输出到文件或控制台便于线上问题排查。4.5 实现更复杂的查询与分页目前的查询很简单。可以增加组合查询按书名和作者同时查、分页查询LIMIT ?, ?。在控制台实现分页交互比如显示“第1页/共5页”并提供“上一页/下一页”选项。4.6 数据校验与异常处理对用户输入进行严格校验ISBN格式、日期格式、非空等。定义自定义的业务异常如BookNotFoundException,StockNotEnoughException在Service层抛出在表示层统一捕获并给出友好提示而不是在DAO层简单返回false。5. 常见问题与调试技巧实录在开发过程中你几乎一定会遇到下面这些问题问题1连接MySQL失败报错“Public Key Retrieval is not allowed”或“时区错误”。排查检查JDBC URL。对于MySQL 8.0通常需要添加参数?useUnicodetruecharacterEncodingutf8useSSLfalseallowPublicKeyRetrievaltrueserverTimezoneAsia/Shanghai。serverTimezone必须设置为你所在时区。问题2插入或查询中文时数据库显示乱码。排查确保数据库、表、字段的字符集是utf8mb4支持所有Unicode字符包括emoji。确保JDBC URL中包含了characterEncodingutf8。确保你的Java源文件编码是UTF-8在IDEA中File - Settings - Editor - File Encodings。问题3程序运行一段时间后报“Too many connections”错误。原因数据库连接没有正确关闭导致连接耗尽。解决严格检查所有DAO方法确保Connection、PreparedStatement、ResultSet在finally块中被关闭。使用我们封装的DBUtil.close()方法。终极方案是尽快引入连接池。问题4借书时明明看到有库存但程序提示库存不足或操作失败。排查首先直接登录MySQL查询该图书的available_count字段确认数据状态。在Service层的borrowBook方法开始和关键步骤后打印日志查看逻辑执行到哪一步失败。最可能的原因是并发问题。可以尝试快速连续执行两次借书操作来复现。这引出了上面讨论的加锁或乐观锁方案。问题5控制台输入数字后下一个nextLine()直接跳过了。原因Scanner的nextInt()或next()方法不会消耗输入流中的换行符\n导致紧随其后的nextLine()直接读到了这个空行。解决统一使用nextLine()读取所有输入然后进行类型转换如我们的getIntInput方法。或者在调用nextInt()后额外调用一次nextLine()来“吞掉”换行符。调试技巧“先查后码”在写DAO层代码前先用数据库工具把SQL语句写好、跑通再翻译成JDBC代码。单元测试为Service层和DAO层编写JUnit单元测试。特别是BorrowService的借还书逻辑通过测试可以提前发现很多业务逻辑缺陷。SQL日志在开发阶段可以配置JDBC或使用p6spy这样的工具打印出程序执行的所有SQL语句及其参数这是定位数据库问题最有效的手段。这个项目虽然界面简陋但它涵盖了后端开发最核心的数据处理流程。当你能够流畅地实现它并且理解其中每一个设计选择和潜在问题时你对Java和MySQL的掌握就已经迈过了入门阶段具备了向更复杂Web项目或框架学习的基础。动手做一遍比看十遍理论都管用。
)
