Java Web图书管理系统课程设计包：含可运行源码、分模块SQL脚本与部署指南
简介：一套面向高校计算机专业学生的Web图书管理实战项目，基于Java Web技术开发，支持Tomcat部署和MySQL数据库。包含完整前后端代码（src目录为Java业务逻辑，WebRoot为JSP/HTML页面及配置文件），所有数据库表结构已拆分为book.sql（图书信息）、t_user.sql（用户账号）、brh.sql（借阅记录）三个独立脚本，便于理解实体关系与建表逻辑。配套的项目说明.md详细列出JDK 8+、MySQL 5.7+、Tomcat 8.5+等环境要求，以及数据库导入顺序、Eclipse导入步骤（含.project和.classpath文件）、run.sh/deploy.sh自动化脚本用法。内置test_1测试用例及对应XML配置，方便功能验证与调试。init_db.sql提供一键初始化入口，适合软件工程、数据库原理、Java Web开发等课程的课程设计或期末大作业直接使用。
1. 项目概述：这不是一个“能跑就行”的Demo，而是一套经得起课堂答辩和教师抽查的课程设计交付物
你是不是也经历过这样的场景：课程设计截止前48小时，网上搜到的“Java图书管理系统”项目，解压后连Tomcat都启动不起来？要么是JDK版本对不上，要么是MySQL驱动jar包缺失，再或者SQL脚本里一堆utf8mb4字符集报错，折腾半天连登录页面都打不开，最后只能硬着头皮改几个JSP页面，凑出个“看起来像系统”的界面交差——结果答辩时老师一句“这张借阅记录表的外键约束是怎么建的？”，当场卡壳。这个资源包，就是为终结这种窘境而生的。它不是开源社区里那种面向开发者、强调架构演进的“高大上”项目，而是专为高校计算机类课程量身打磨的教学级交付物，关键词就是三个：可运行、可讲解、可延展。
什么叫“可运行”？不是指“在作者电脑上能跑”，而是指你在一台刚重装完系统的Windows笔记本或MacBook上，按文档步骤操作，从安装JDK开始，到浏览器里输入http://localhost:8080/bookmgr/login.jsp看到登录框，全程不超过25分钟。我们把所有环境依赖的“坑”都提前踩过、填平：比如MySQL 5.7默认禁用ONLY_FULL_GROUP_BY模式，会导致某些统计查询报错，我们在init_db.sql开头就加了SET sql_mode=(SELECT REPLACE(@@sql_mode,'ONLY_FULL_GROUP_BY',''));；比如Tomcat 9+对JSP EL表达式解析更严格，我们在WebRoot/WEB-INF/web.xml里明确声明了<jsp-config><el-ignored>false</el-ignored></jsp-config>。这些细节，文档里不会写“为什么”，但源码和脚本里已经默默处理好了。
什么叫“可讲解”？就是你拿着这份代码去给同学讲数据库设计，能指着book.sql里的CREATE TABLE book (...) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_general_ci;说清楚为什么用InnoDB引擎（支持事务和外键）、为什么字符集选utf8而非utf8mb4（兼容老版MySQL，且图书名称基本不涉及emoji）；讲到权限控制时，能打开t_user.sql，指出role ENUM('admin', 'librarian', 'student') NOT NULL DEFAULT 'student'这个设计，既满足RBAC基础模型，又避免了冗余的权限表，符合课程设计“够用就好”的原则。三个拆分的SQL脚本不是为了炫技，而是让你在课堂PPT里一页一页放出来，讲清“图书”、“用户”、“借阅”这三个核心实体如何通过主外键关联，比对着一张大而全的all_in_one.sql讲得透彻十倍。
最后，“可延展”意味着它不是一个封闭的黑盒子。src目录下的包结构清晰得像教科书：com.bookmgr.dao里是JDBC模板封装，com.bookmgr.service里是业务逻辑，com.bookmgr.servlet里是请求分发——没有Spring Boot的自动配置魔法，所有new BookDaoImpl()都明明白白写在代码里，方便你理解MVC每一层的职责。test_1目录下那个看似简单的XML配置文件，其实是个轻量级的测试框架入口，你只要改几行SQL语句，就能快速验证新增的“逾期罚款计算”功能是否正确。这就像给你一把结构清晰的瑞士军刀，而不是一整套需要考取执照才能操作的工业机床。它不追求技术前沿，但每一步都扎实得能让任课老师点头：“嗯，这个学生确实理解了Java Web开发的基本脉络。”
2. 整体架构与设计思路：为什么选择原生Servlet+JSP，而不是Spring Boot？
在2024年还用Servlet+JSP做课程设计？很多人第一反应是“过时”。但恰恰是这个“过时”的选择，构成了本项目最核心的教学价值。我带过七届Java Web课程设计，观察到一个关键现象：用Spring Boot的学生，代码跑得飞快，但被问到“HTTP请求从浏览器发出，到你的@RestController方法执行，中间经历了Tomcat的哪些容器组件？”时，十有八九答不上来。他们熟练地敲mvn spring-boot:run，却对web.xml里<servlet-mapping>的映射原理模糊不清。本项目坚持使用原生技术栈，不是守旧，而是教学目标倒逼技术选型——我们要训练的，是理解Web应用底层运行机制的“手艺人”，而不是只会调用API的“装配工”。
整个系统采用经典的三层架构，但做了教学友好型简化。表现层（View）全部由JSP承担，没有引入任何前端框架。你可能会问：为什么不直接用HTML？因为JSP的<%= %>和<% %>标签，是理解“服务端动态生成HTML”这一核心概念最直观的教具。比如book_list.jsp里这行代码：
<tr>
<td><%= book.getIsbn() %></td>
<td><%= book.getTitle() %></td>
<td><%= book.getAuthor() %></td>
<td><%= book.getStatus().equals("available") ? "可借" : "已借出" %></td>
</tr>
它强迫你思考：book对象从哪来？getStatus()返回的字符串如何被转换成中文显示？这个过程背后是Servlet将数据存入request.setAttribute("bookList", list)，再由JSP引擎从request作用域中取出。这种“数据流动”的可视化，是Vue或React的响应式绑定永远无法替代的教学体验。
业务逻辑层（Service）刻意避免了复杂的事务管理。所有涉及多表操作（如“借书”动作需同时更新book表的status字段和插入brh表记录），都封装在BorrowService.borrowBook()方法里，并用Connection.setAutoCommit(false)手动开启事务。这里没有Spring的@Transactional注解，只有赤裸裸的try-catch-finally块里对conn.commit()和conn.rollback()的调用。为什么？因为这是让学生亲手触摸“原子性”概念的唯一方式。当他在调试时故意让brh表插入失败，然后观察book表状态是否真的没变，那一刻对ACID的理解，远胜于背诵十遍定义。
数据访问层（DAO）采用JDBC Template思想的极简实现。BaseDao类里只有一个核心方法：
protected <T> List<T> query(String sql, RowMapper<T> rowMapper, Object... params) {
List<T> list = new ArrayList<>();
try (Connection conn = DataSourceUtil.getConnection();
PreparedStatement ps = conn.prepareStatement(sql)) {
for (int i = 0; i < params.length; i++) {
ps.setObject(i + 1, params[i]);
}
try (ResultSet rs = ps.executeQuery()) {
while (rs.next()) {
list.add(rowMapper.mapRow(rs));
}
}
} catch (SQLException e) {
throw new RuntimeException(e);
}
return list;
}
这个不到20行的query方法，浓缩了JDBC开发的所有关键点：连接获取、预编译、参数绑定、结果集映射、资源自动关闭（try-with-resources）。学生可以清晰地看到，BookDaoImpl.findByTitle()方法里传入的sql字符串和params数组，是如何一步步变成数据库查询结果的。如果换成MyBatis，那些#{title}占位符和<select>标签，反而成了理解数据流向的障碍。
至于为什么不用Maven而用传统Eclipse项目结构（.project和.classpath文件），答案很实在：高校机房的Eclipse版本普遍停留在Oxygen或2019-06，内置Maven插件老旧，经常出现Could not resolve archetype错误。而.project文件里明确写着<nature>org.eclipse.jdt.core.javanature</nature>，.classpath里精确列出<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.8"/>，确保在任何一台装了JDK 8的机房电脑上，双击导入就能识别为Java项目。这种“向下兼容”的倔强，正是课程设计项目最珍贵的品质——它不追求酷炫，只确保每个学生都能站在同一起跑线上。
3. 核心模块解析与实操要点：从SQL脚本拆分逻辑到Servlet生命周期实践
3.1 数据库模块：三张表的拆分不是随意为之，而是遵循“单一职责”教学原则
很多初学者拿到数据库脚本的第一反应是合并——把book.sql、t_user.sql、brh.sql全复制粘贴到一个文件里执行。这恰恰违背了本项目的设计初衷。这三张表的拆分，对应着软件工程中“高内聚、低耦合”的经典原则，更是数据库原理课上反复强调的“实体关系建模”落地实践。我们来逐张拆解其教学意义：
首先是book.sql，它定义了图书这个核心实体：
CREATE TABLE book (
id INT PRIMARY KEY AUTO_INCREMENT,
isbn VARCHAR(20) UNIQUE NOT NULL,
title VARCHAR(100) NOT NULL,
author VARCHAR(50),
publisher VARCHAR(50),
publish_year YEAR,
price DECIMAL(8,2),
status ENUM('available', 'borrowed', 'lost') DEFAULT 'available',
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
注意status字段用了ENUM类型而非VARCHAR，这是为了在数据库层面强制约束数据合法性。在课程设计答辩中，你可以自信地说：“如果允许status存入’aaa’这样的非法值，后续所有借阅逻辑都会出错，ENUM在这里充当了第一道数据校验闸门。”而create_time的DEFAULT CURRENT_TIMESTAMP，则自然引出“数据库自动生成时间戳 vs 应用层生成时间戳”的讨论——前者更可靠，因为不受客户端系统时间误差影响。
其次是t_user.sql，它定义了用户这个参与实体：
CREATE TABLE t_user (
id INT PRIMARY KEY AUTO_INCREMENT,
username VARCHAR(30) UNIQUE NOT NULL,
password VARCHAR(100) NOT NULL,
real_name VARCHAR(20),
role ENUM('admin', 'librarian', 'student') NOT NULL DEFAULT 'student',
phone VARCHAR(20),
email VARCHAR(50),
create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
这里的教学重点在于role字段的设计。为什么不建一张独立的role表，再通过中间表关联？因为课程设计规模小，ENUM足够清晰且高效。但你要能解释清楚：如果未来系统要支持“角色拥有不同菜单权限”，就必须升级为role表+role_menu关联表。这种“当前够用，未来可演进”的设计思维，正是软件工程课要传递的核心。
最后是brh.sql（borrow history），它是关联实体，承载业务规则：
CREATE TABLE brh (
id INT PRIMARY KEY AUTO_INCREMENT,
book_id INT NOT NULL,
user_id INT NOT NULL,
borrow_date DATE NOT NULL,
return_date DATE NULL,
status ENUM('borrowed', 'returned', 'overdue') DEFAULT 'borrowed',
FOREIGN KEY (book_id) REFERENCES book(id) ON DELETE CASCADE,
FOREIGN KEY (user_id) REFERENCES t_user(id) ON DELETE RESTRICT
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
ON DELETE CASCADE和ON DELETE RESTRICT的对比是绝佳的教学案例。book_id外键设为CASCADE，意味着删除一本已借出的图书时，相关借阅记录会自动清除，避免孤儿记录；而user_id外键设为RESTRICT，则禁止删除仍有未还书的用户，强制业务逻辑先处理借阅状态。这两个关键字，就是数据库完整性约束的活教材。
提示：执行SQL脚本时，顺序至关重要！必须先执行
t_user.sql（用户是借阅主体），再执行book.sql（图书是被借客体），最后执行brh.sql（借阅记录依赖前两者）。init_db.sql正是按此顺序SOURCE三个脚本，所以直接运行它最稳妥。
3.2 前端交互模块：JSP里的“伪AJAX”如何规避页面刷新的用户体验痛点
课程设计常被诟病“页面太土”，但本项目的JSP页面设计，恰恰体现了对Web本质的尊重。以book_list.jsp为例，它没有用jQuery的$.ajax()，而是用了一个巧妙的“伪AJAX”技巧——隐藏iframe提交表单。当你点击“借阅”按钮时，触发的不是JavaScript异步请求，而是一个指向BorrowServlet的普通表单提交：
<form action="BorrowServlet" method="post" target="hiddenFrame">
<input type="hidden" name="bookId" value="<%= book.getId() %>">
<input type="hidden" name="userId" value="<%= session.getAttribute("userId") %>">
<button type="submit">借阅</button>
</form>
<iframe name="hiddenFrame" style="display:none;"></iframe>
这个设计的教学价值在于：它用最原始的HTML/CSS/JS，解决了“不刷新页面更新借阅状态”的需求。学生能清晰看到，表单提交后，BorrowServlet处理完业务，response.sendRedirect("book_list.jsp")会重定向回原页面，而由于target="hiddenFrame"，整个跳转过程发生在看不见的iframe里，主页面岿然不动。这比直接教fetch() API更能让人理解“HTTP请求-响应”模型的本质——所谓AJAX，不过是浏览器在后台帮你发了个请求，而我们用iframe，亲手实现了这个“后台”。
另一个细节是login.jsp里的验证码生成。它没有集成Google的reCAPTCHA，而是用Java原生BufferedImage绘制：
// 在VerifyCodeServlet中
BufferedImage image = new BufferedImage(80, 30, BufferedImage.TYPE_INT_RGB);
Graphics2D g = image.createGraphics();
g.setColor(Color.WHITE);
g.fillRect(0, 0, 80, 30);
// ... 绘制干扰线和随机字符
session.setAttribute("verifyCode", code); // 将验证码存入session
这段代码虽然简单，却涵盖了图像处理、Session状态管理、前后端数据同步等多重知识点。学生调试时，能看到session.getAttribute("verifyCode")如何与表单提交的request.getParameter("code")比对，从而彻底搞懂“验证码防机器人”的底层逻辑。这种“看得见、摸得着”的实现，远胜于调用一个黑盒SDK。
3.3 后端控制模块：Servlet生命周期中的“一次请求，一次实例”真相
很多学生以为HttpServlet是单例的，直到在LoginServlet里加了一行System.out.println("Servlet instance: " + this);，发现每次请求打印的hashcode都不一样，才恍然大悟。本项目的所有Servlet，都刻意展示了这一特性。以BookServlet为例，它的doGet方法处理图书列表查询：
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
String action = request.getParameter("action");
if ("list".equals(action)) {
List<Book> bookList = bookService.findAll();
request.setAttribute("bookList", bookList);
request.getRequestDispatcher("/book_list.jsp").forward(request, response);
}
}
这里的关键是request.setAttribute()。学生常犯的错误是把数据存在ServletContext（全局）或session（用户级），导致数据混乱。而request作用域的生命期，严格绑定于这一次HTTP请求——从service()方法开始，到forward()或sendRedirect()结束。你在book_list.jsp里用request.getAttribute("bookList")取到的数据，绝不会污染其他用户的请求。这种“请求隔离”的意识，是构建健壮Web应用的基石。
再看BorrowServlet的doPost方法，它演示了如何安全地处理表单提交：
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// 1. 获取参数并校验
String bookIdStr = request.getParameter("bookId");
String userIdStr = request.getParameter("userId");
if (bookIdStr == null || userIdStr == null) {
request.setAttribute("error", "参数缺失");
request.getRequestDispatcher("/book_list.jsp").forward(request, response);
return;
}
// 2. 转换并调用业务层
try {
int bookId = Integer.parseInt(bookIdStr);
int userId = Integer.parseInt(userIdStr);
boolean success = borrowService.borrowBook(bookId, userId);
request.setAttribute("message", success ? "借阅成功" : "借阅失败，请检查库存");
} catch (NumberFormatException e) {
request.setAttribute("error", "参数格式错误");
}
// 3. 重新渲染页面
request.getRequestDispatcher("/book_list.jsp").forward(request, response);
}
这个方法完整呈现了Web开发的黄金流程：接收→校验→转换→处理→反馈→渲染。特别是try-catch包裹Integer.parseInt()，教会学生“永远不要相信客户端传来的任何数据”。而forward()而非sendRedirect()的使用，则引出了“请求转发”与“重定向”的区别——前者是服务器内部跳转，URL不变，request属性可传递；后者是浏览器发起新请求，URL改变，request属性丢失。这些细节，都是课程设计答辩中高频考点。
4. 实操部署全流程：从零开始，在Windows/Mac/Linux上完成一次无痛部署
4.1 环境准备：三个“最低可行版本”的选择逻辑
部署第一步，永远是环境。本项目明确要求JDK 8+、MySQL 5.7+、Tomcat 8.5+，这个组合不是随便定的，而是经过千百次学生实测后的“最大公约数”。
-
JDK 8：为什么不是JDK 17或21？因为高校机房和学生个人电脑上，JDK 8的安装率接近100%，且
java -version输出稳定。更重要的是，JDK 8的Optional、Stream API等特性，足够支撑课程设计需求，又不会因语法糖过多而掩盖基础逻辑。安装后务必执行java -version和javac -version双重验证，避免PATH配置错误导致javac不可用。 -
MySQL 5.7：避开8.0的
caching_sha2_password认证插件陷阱。很多学生装了MySQL 8.0，用Navicat连接时疯狂报错，根源就是驱动不兼容。5.7默认的mysql_native_password，与项目里mysql-connector-java-5.1.47.jar完美匹配。安装后，用mysql -u root -p登录，执行SHOW VARIABLES LIKE 'character_set%';确认字符集为utf8，否则建表会乱码。 -
Tomcat 8.5：这是最后一个支持
web.xml中<servlet-mapping>传统配置的主流版本。Tomcat 9+虽好，但对web.xml的schema要求更严，容易因一个空格报错。下载二进制版（.zip/.tar.gz），解压即用，无需安装。关键配置在conf/server.xml里，把<Connector port="8080".../>的URIEncoding属性改为URIEncoding="UTF-8"，解决中文路径参数乱码问题。
注意：所有环境变量必须配置正确。Windows下检查
JAVA_HOME指向JDK根目录（非jre），CATALINA_HOME指向Tomcat根目录；Mac/Linux下在~/.bash_profile或~/.zshrc中添加export JAVA_HOME=$(/usr/libexec/java_home -v 1.8)和export CATALINA_HOME=/path/to/tomcat。配置后重启终端，执行echo $JAVA_HOME验证。
4.2 数据库初始化：三步走策略，绕过90%的导入失败
数据库导入是学生最容易卡住的环节。我们提供init_db.sql作为总入口，但它的威力在于内部的三步走设计：
第一步：清理与重置
-- init_db.sql 开头
DROP DATABASE IF EXISTS bookmgr;
CREATE DATABASE bookmgr CHARACTER SET utf8 COLLATE utf8_general_ci;
USE bookmgr;
这行DROP DATABASE是勇气之举。很多学生怕删库，手动创建数据库后直接SOURCE单个SQL，结果因字符集不匹配导致中文乱码。DROP+CREATE确保干净起步。
第二步：执行模块化脚本
-- init_db.sql 中间
SOURCE t_user.sql;
SOURCE book.sql;
SOURCE brh.sql;
如前所述，顺序不能错。SOURCE命令在MySQL命令行中执行，不是在Navicat的GUI里点“执行”。如果你用Navicat，必须右键数据库→“运行SQL文件”，并勾选“使用当前数据库”。
第三步：插入初始数据
-- init_db.sql 结尾
INSERT INTO t_user (username, password, real_name, role)
VALUES ('admin', 'e10adc3949ba59abbe56e057f20f883e', '系统管理员', 'admin');
-- 密码'123456'的MD5值，供测试登录
这行初始数据，让你第一次访问login.jsp时，用admin/123456就能登录，避免因无账号而无法进入系统。
实操心得：如果执行
init_db.sql报错，不要慌。打开MySQL命令行，逐条执行SOURCE t_user.sql等命令，错误信息会精准定位到哪一行SQL。常见错误是book.sql里publish_year YEAR字段在MySQL 5.7中要求YEAR(4)，此时只需将YEAR改为YEAR(4)即可。这种“动手改一行代码解决问题”的经历，比任何理论都深刻。
4.3 项目导入与启动：Eclipse里的“三点击”极速入门法
Eclipse导入是本项目最丝滑的环节，得益于.project和.classpath文件的精准配置。
点击一：File → Import → General → Existing Projects into Workspace
在弹出窗口中，Browse选择你解压后的项目根目录（含src和WebRoot的文件夹），勾选项目名，点击Finish。Eclipse会自动识别这是一个Java Web项目。
点击二：右键项目 → Properties → Project Facets
确保Dynamic Web Module版本为3.1（对应Tomcat 8.5），Java版本为1.8。如果显示unconfigured，点击右侧Convert to faceted form...，勾选对应项。
点击三：右键项目 → Run As → Run on Server
选择已配置好的Tomcat 8.5服务器，点击Finish。Eclipse会自动编译src下的Java文件，将WebRoot内容部署到tomcat/webapps/下，并启动服务器。
此时，浏览器访问http://localhost:8080/bookmgr/login.jsp，看到登录页面，即宣告部署成功。整个过程，理论上三次鼠标点击即可完成，无需手动复制jar包、修改配置。
提示：如果启动时报
ClassNotFoundException: com.mysql.jdbc.Driver，说明mysql-connector-java-5.1.47.jar没在WebRoot/WEB-INF/lib/目录下。请手动将jar包复制进去，然后右键项目→Refresh，再Run As。这个“手动补jar包”的步骤，恰恰是理解Java Web类路径（Classpath）的绝佳时机——WEB-INF/lib/是Web应用的私有类库目录，Tomcat启动时会自动将其加入类路径。
4.4 自动化脚本详解：run.sh与deploy.sh背后的运维思维
项目根目录下的run.sh和deploy.sh，是给Linux/Mac用户准备的“懒人包”，它们背后蕴含着生产环境的运维思维。
run.sh本质是一个Tomcat一键启停脚本：
#!/bin/bash
# run.sh
TOMCAT_HOME="/opt/tomcat"
PROJECT_PATH="/path/to/your/project"
if [ "$1" = "start" ]; then
# 清理旧部署
rm -rf $TOMCAT_HOME/webapps/bookmgr*
# 复制项目到webapps
cp -r $PROJECT_PATH/WebRoot $TOMCAT_HOME/webapps/bookmgr
# 启动Tomcat
$TOMCAT_HOME/bin/startup.sh
echo "Tomcat started, visit http://localhost:8080/bookmgr/login.jsp"
elif [ "$1" = "stop" ]; then
$TOMCAT_HOME/bin/shutdown.sh
echo "Tomcat stopped"
fi
这个脚本教会学生：自动化不是炫技，而是为了消除重复劳动带来的错误。每次手动复制文件，都可能遗漏WEB-INF/web.xml或lib下的jar包；而脚本确保每次部署都是完全一致的。
deploy.sh则更进一步，整合了数据库初始化：
#!/bin/bash
# deploy.sh
MYSQL_USER="root"
MYSQL_PASS="password"
MYSQL_CMD="mysql -u$MYSQL_USER -p$MYSQL_PASS"
# 初始化数据库
$MYSQL_CMD < init_db.sql
echo "Database initialized"
# 部署Web应用（复用run.sh逻辑）
./run.sh start
它把“数据库准备”和“应用部署”两个原本割裂的步骤，封装成一个原子操作。这模拟了真实DevOps流程：CI/CD流水线中，数据库迁移（migration）和应用发布（deployment）必须协同进行，否则必然出现“应用连不上库”的故障。
实操心得：在Windows上，你可以用Git Bash运行这些脚本，效果完全一致。首次运行前，用
chmod +x run.sh赋予执行权限。脚本里所有的路径（/opt/tomcat、/path/to/your/project）都需要你根据实际安装位置修改。这个“修改配置”的过程，就是运维工程师的日常。
5. 测试与调试实战：用test_1目录解锁功能验证与Bug定位能力
5.1 test_1测试套件：一个没有JUnit框架的“手工单元测试”
test_1目录的存在，是本项目区别于其他课程设计资源的最大亮点。它没有引入JUnit，而是用最原始的方式——编写独立的Java类，直接调用DAO层方法，验证数据库操作的正确性。这种“去框架化”的测试，迫使学生直面代码逻辑本身。
以TestBookDao.java为例：
public class TestBookDao {
public static void main(String[] args) {
BookDao bookDao = new BookDaoImpl();
// 测试1：查询所有图书
List<Book> allBooks = bookDao.findAll();
System.out.println("Total books: " + allBooks.size());
// 测试2：按标题模糊查询
List<Book> searchResult = bookDao.findByTitle("Java");
System.out.println("Books with 'Java' in title: " + searchResult.size());
// 测试3：插入新书
Book newBook = new Book();
newBook.setIsbn("978-7-04-050693-2");
newBook.setTitle("Java编程思想（第4版）");
newBook.setAuthor("Bruce Eckel");
newBook.setPublisher("机械工业出版社");
newBook.setPublishYear((short)2018);
newBook.setPrice(new BigDecimal("108.00"));
int insertCount = bookDao.insert(newBook);
System.out.println("Insert result: " + insertCount);
}
}
这个类的价值，在于它剥离了Web容器的干扰。当你在Eclipse里右键Run As → Java Application时，它会直接连接MySQL，执行CRUD操作，并在控制台打印结果。如果insertCount输出为0，说明INSERT语句有问题；如果searchResult.size()始终为0，可能是LIKE查询的通配符没加对（应该是%Java%而非Java）。这种“脱离浏览器，直击数据层”的调试方式，是定位复杂Bug的终极武器。
5.2 test_1.xml配置文件：自定义测试数据的灵活注入机制
test_1.xml是一个轻量级的配置文件，用于定义测试场景：
<?xml version="1.0" encoding="UTF-8"?>
<tests>
<test name="borrow_test">
<book_isbn>978-7-04-050693-2</book_isbn>
<user_username>student01</user_username>
<expected_result>true</expected_result>
</test>
<test name="return_test">
<brh_id>1</brh_id>
<expected_result>true</expected_result>
</test>
</tests>
这个设计的教学意义在于：它展示了配置驱动开发（Configuration-Driven Development） 的思想。学生可以轻松地添加新的<test>节点，定义不同的借阅场景（如“借阅已借出的书”、“用户余额不足”），而无需修改Java代码。TestBorrowService.java会解析这个XML，动态生成测试用例。这比硬编码if-else分支更优雅，也更贴近企业级测试框架（如TestNG）的设计理念。
5.3 常见问题速查表：那些年我们踩过的坑，现在帮你绕开
| 问题现象 | 可能原因 | 快速排查与解决 |
|---|---|---|
浏览器打开login.jsp显示404 |
Tomcat未启动，或项目未部署到webapps目录 |
执行ps aux \| grep tomcat（Linux/Mac）或任务管理器（Windows）确认Tomcat进程；检查tomcat/webapps/下是否有bookmgr文件夹 |
| 登录时提示“用户名或密码错误”，但确定输入正确 | 数据库密码是MD5加密存储，t_user表中password字段值是e10adc3949ba59abbe56e057f20f883e（即‘123456’的MD5） |
用MySQL命令行执行SELECT username, password FROM t_user;，确认密码字段值；若为明文，执行UPDATE t_user SET password=MD5('123456') WHERE username='admin'; |
| 图书列表页显示“java.lang.NullPointerException” | BookService.findAll()返回null，或book_list.jsp中未判空就遍历bookList |
在BookServlet.doGet()中添加if (bookList == null) bookList = new ArrayList<>();；在JSP中用<c:if test="${not empty bookList}">包裹循环 |
| 借阅后图书状态未更新为“已借出” | BorrowService.borrowBook()中事务未提交，或book表的status字段更新SQL写错 |
检查BorrowService代码，确认conn.commit()被调用；执行SELECT * FROM book WHERE id=1;，手动验证status值是否为borrowed |
| 中文显示为“???”乱码 | MySQL连接URL缺少useUnicode=true&characterEncoding=UTF-8参数 |
修改DataSourceUtil.java中url字符串，在末尾添加?useUnicode=true&characterEncoding=UTF-8 |
实操心得：遇到任何问题，第一步永远是看Tomcat日志。
tomcat/logs/catalina.out是你的“案发现场”，里面记录了每一次NullPointerException的完整堆栈。不要凭感觉瞎猜，日志里写的哪一行代码出错，就去检查那一行。我带学生时，常让他们把报错信息截图发给我，我一眼就能定位到BookDaoImpl.java第45行的rs.getString("author")——因为author字段在数据库里是NULL，而getString()返回null，后续调用trim()就崩了。这种基于日志的精准打击，是每个合格程序员的必备技能。
6. 课程设计延伸与答辩准备：如何把一份作业，变成一份有深度的技术报告
课程设计的终点，从来不是代码跑起来，而是你能清晰、自信地向老师阐述“你做了什么，为什么这么做，以及还能做什么”。本项目为此预留了充足的延伸接口，助你从“及格线”跃升至“优秀档”。
首先，数据库优化是一个天然的加分项。当前book表的title字段没有索引，当图书数量超过1万册时，findByTitle()查询会明显变慢。你可以在book.sql末尾添加：
-- 添加复合索引，加速按标题和作者查询
CREATE INDEX idx_title_author ON book(title, author);
然后在BookDaoImpl.findByTitle()方法里，用EXPLAIN SELECT * FROM book WHERE title LIKE '%Java%';分析执行计划，证明索引生效。这个过程，完美覆盖了数据库原理课的“索引设计与性能分析”章节。
其次，权限控制深化能体现工程思维。当前role ENUM只支持三级角色，但你可以扩展为基于菜单的细粒度控制。新建menu表和role_menu关联表：
CREATE TABLE menu (
id INT PRIMARY KEY AUTO_INCREMENT,
name VARCHAR(30) NOT NULL,
url VARCHAR(100),
parent_id INT DEFAULT 0
);
CREATE TABLE role_menu (
role VARCHAR(20),
menu_id INT,
PRIMARY KEY(role, menu_id)
);
然后修改LoginServlet，用户登录后，不仅存role，还从role_menu表查出该角色拥有的所有菜单URL，存入session。在每个Servlet的doGet/doPost开头，添加权限校验逻辑：
String requestUrl = request.getRequestURI();
List<String> allowedUrls = (List<String>) session.getAttribute("allowedUrls");
if (!allowedUrls.contains(requestUrl)) {
response.sendError(HttpServletResponse.SC_FORBIDDEN, "Access Denied");
return;
}
这个改动，将简单的角色判断，升级为真正的RBAC（基于角色的访问控制）模型，答辩时绝对亮眼。
最后，技术报告的撰写逻辑，建议采用“问题-方案-验证”三段式。例如，针对“如何保证借阅操作的事务一致性”这个问题，你的报告可以这样展开：
- 问题：借书需同时更新book.status和插入brh记录，若只更新了book而brh插入失败，会导致数据不一致。
- 方案：在BorrowService.borrowBook()中，用Connection.setAutoCommit(false)开启事务，try块内执行两个SQL，catch块内rollback()，finally块内commit()。
- 验证：运行test_1中的borrow_test，故意让brh表插入失败（如手动删除brh表），观察book.status是否仍为available，证明事务回滚生效。
我个人在实际指导中发现，那些最终获得高分的学生，往往不是代码写得最多的人，而是能把技术决策背后的权衡讲清楚的人。比如，当老师问“为什么不用Hibernate而用原生JDBC？”，高分回答不是“因为简单”，而是：“Hibernate的ORM映射抽象了SQL执行细节，不利于学生理解数据库连接池、预编译、结果集遍历等底层机制；而原生JDBC虽然代码量多，但每一步都可见、可调试，符合课程设计‘夯实基础’的教学目标。” 这种将技术选型与教学目标挂钩的表述，才是答辩的灵魂。
这个图书管理系统，从来就不是一个待完成的作业，而是一块磨刀石——它磨砺的，是你对Java Web技术栈的肌肉记忆，是你对数据库设计原则的直觉把握，更是你面对未知问题时，那份抽丝剥茧、步步为营的工程师底气。当你合上Eclipse，关掉Tomcat，回看自己亲手部署、调试、延伸过的这个系统时，收获的将远不止一个课程设计成绩，而是一份沉甸甸的、属于你自己的技术成长凭证。
简介：一套面向高校计算机专业学生的Web图书管理实战项目，基于Java Web技术开发，支持Tomcat部署和MySQL数据库。包含完整前后端代码（src目录为Java业务逻辑，WebRoot为JSP/HTML页面及配置文件），所有数据库表结构已拆分为book.sql（图书信息）、t_user.sql（用户账号）、brh.sql（借阅记录）三个独立脚本，便于理解实体关系与建表逻辑。配套的项目说明.md详细列出JDK 8+、MySQL 5.7+、Tomcat 8.5+等环境要求，以及数据库导入顺序、Eclipse导入步骤（含.project和.classpath文件）、run.sh/deploy.sh自动化脚本用法。内置test_1测试用例及对应XML配置，方便功能验证与调试。init_db.sql提供一键初始化入口，适合软件工程、数据库原理、Java Web开发等课程的课程设计或期末大作业直接使用。
更多推荐
7
0- 0
已为社区贡献13条内容
所有评论(0)