JavaEE图书借阅系统：Servlet+JSP+MySQL完整闭环实现

简介：本资源是一份面向高校计算机专业本科生的JavaEE期末综合实践项目，聚焦图书管理网站开发，助力学生系统掌握企业级Web应用开发全流程。项目覆盖需求分析、系统设计、Servlet/JSP后端开发、MySQL数据库操作、JPA对象关系映射及MVC架构实现等核心能力，特别适合作为期末大作业参考或课程设计实战范例。压缩包含356个文件，总计26.39MB，其中52个JSP文件构成前端视图层，52个Java类与53个Class文件支撑业务逻辑与控制器，40个JS和19个CSS实现交互与样式，另含1个SQL数据库脚本、78个GIF操作示意图及配套文档（如docx、pptx），结构完整、开箱即用。已有6666人学习下载，提供从需求文档到可运行代码的全链路素材，包含管理员与借阅管理等典型模块的完整类结构（如Admin.class、BorrowTable.class、ReturnTable.class），便于理解分层设计与实际部署。

1. 大学生JavaEE期末大作业：不是堆功能，而是用标准组件跑通一个可验证的图书借阅闭环

很多同学拿到“JavaEE期末大作业”这个题目，第一反应是去GitHub搜“JavaEE图书管理系统”，下载一个带Admin后台、Book列表、Borrow操作的完整项目，改个包名就交差。结果部署时报错ORA-28547: connection to server failed, probable oracle net admin error，查半天发现是Oracle JDBC驱动没配对；或者在VSCode里反复调试admin登录逻辑，却卡在c:\users\admin\appdata\local\nvidia\dxcache这类路径干扰上——这根本不是JavaEE的问题，而是没厘清JavaEE作为规范体系的落地边界。真正的JavaEE期末作业，核心不是实现多少功能，而是用Servlet+JSP+JDBC（或轻量级EJB替代）+MySQL/PostgreSQL，在Tomcat容器中跑通“用户登录→图书检索→借阅提交→状态更新”这一完整事务流，并能通过URL路径、HTTP状态码、数据库记录三者交叉验证每一步是否真实生效。它面向的是刚学完《Java Web程序设计》课程、熟悉Java基础但尚未接触Spring Boot的本科生，目标是让TA亲手把课本第5章的Servlet生命周期、第7章的JDBC连接池、第9章的JSP EL表达式，串成一条可调试、可断点、可截图演示的执行链。

2. 用Servlet+JSP+MySQL构建图书借阅核心流程：从零初始化Web应用结构

2.1 为什么不用Spring Boot而坚持原生JavaEE技术栈？

当前网络热词中频繁出现vscode配置javaee语言环境、javaee课程设计，恰恰说明高校教学仍以JavaEE规范为纲，而非直接切入Spring生态。Spring Boot虽简化了配置，但会掩盖web.xml部署描述符的作用、ServletContext的生命周期管理、HttpSession与Cookie的底层绑定机制——这些正是期末答辩时老师必问的考点。例如admin账户的权限校验，若用Spring Security，学生可能只写@PreAuthorize("hasRole('ADMIN')")，却答不出HttpServletRequest.getRemoteUser()和HttpSession.getAttribute("userRole")的区别；而原生Servlet中手动实现Filter拦截、RequestDispatcher.forward()跳转，能强制暴露HTTP请求流转的每个环节。此外，Illegal类名（如IllegalStateException）在Servlet中高频出现，正是理解容器线程模型的关键入口——比如在doPost()中调用response.getWriter()后又试图forward()，就会触发该异常，这比任何PPT讲解都更直观。

提示：不要用IDE自动创建的“Dynamic Web Project”模板直接开干。必须手动验证WEB-INF/web.xml是否存在且被Tomcat加载——这是判断是否真走JavaEE规范路径的黄金标准。

2.2 创建最小可运行Web应用：目录结构与关键配置文件

按JavaEE 7规范要求，项目根目录下必须包含WEB-INF/子目录，其内需有web.xml和lib/。以下是经VSCode+Tomcat 9实测的最小结构（无任何框架jar）：

book-borrow-system/ ├── index.jsp ├── login.jsp ├── admin/ │ └── book-list.jsp ├── WEB-INF/ │ ├── web.xml │ └── lib/ │ └── mysql-connector-java-8.0.33.jar ← 必须与MySQL版本匹配 └── src/ └── servlet/ ├── LoginServlet.java ├── BorrowServlet.java └── AdminBookListServlet.java

WEB-INF/web.xml必须声明Servlet映射，这是Tomcat识别业务逻辑的唯一依据：

<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd" version="4.0"> <servlet> <servlet-name>LoginServlet</servlet-name> <servlet-class>servlet.LoginServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>LoginServlet</servlet-name> <url-pattern>/login</url-pattern> </servlet-mapping> <servlet> <servlet-name>BorrowServlet</servlet-name> <servlet-class>servlet.BorrowServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>BorrowServlet</servlet-name> <url-pattern>/borrow</url-pattern> </servlet-mapping> </web-app>

这段XML定义了两个关键契约：

• 所有发往/login路径的POST请求，由LoginServlet类处理；
• /borrow路径的请求交由BorrowServlet响应。
  没有这个映射，即使Java类编译成功，Tomcat也完全无法路由请求——这也是ORA-28547类错误常被误判为数据库问题的根源：实际是Servlet未注册导致请求根本未到达JDBC层。

2.3 实现图书借阅核心Servlet：用try-with-resources确保资源释放

BorrowServlet.java必须体现JavaEE对资源管理的强约束。以下代码片段展示了如何避免常见内存泄漏：

@WebServlet("/borrow") public class BorrowServlet extends HttpServlet { @Override protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { String bookId = req.getParameter("bookId"); String userId = (String) req.getSession().getAttribute("userId"); String sql = "UPDATE books SET status='borrowed' WHERE id=? AND status='available'"; try (Connection conn = DriverManager.getConnection( "jdbc:mysql://localhost:3306/library?useSSL=false&serverTimezone=UTC", "root", "password"); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setString(1, bookId); int rowsAffected = ps.executeUpdate(); if (rowsAffected == 1) { // 借阅成功，记录日志到borrow_records表 String logSql = "INSERT INTO borrow_records (book_id, user_id, borrow_time) VALUES (?, ?, NOW())"; try (PreparedStatement logPs = conn.prepareStatement(logSql)) { logPs.setString(1, bookId); logPs.setString(2, userId); logPs.executeUpdate(); } req.setAttribute("message", "借阅成功"); } else { req.setAttribute("message", "图书已被借出或不存在"); } } catch (SQLException e) { // 关键：不能吞掉SQLException！必须记录并转为用户可见提示 e.printStackTrace(); // 开发期保留，上线应写入log4j req.setAttribute("message", "系统繁忙，请稍后再试"); } req.getRequestDispatcher("result.jsp").forward(req, resp); } }

参数说明：

• useSSL=false：本地开发环境禁用SSL可避免证书配置问题，生产环境必须启用；
• serverTimezone=UTC：强制统一时区，防止NOW()函数返回值与JavaLocalDateTime不一致；
• try-with-resources：自动关闭Connection和PreparedStatement，避免连接池耗尽——这是IllegalStateException高发场景；
• rowsAffected == 1：用SQL层面的原子更新代替先SELECT再UPDATE，规避并发借阅冲突。

3. 数据库设计与JDBC连接池配置：解决ORA-28547类连接失败的根本方法

3.1 图书借阅场景的最小化MySQL表结构

针对Book、Borrow、Admin三大热词，设计三张表即可覆盖全部业务：

建表SQL必须显式指定字符集，否则JSP中文显示为乱码：

CREATE DATABASE library CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE library; CREATE TABLE users ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, role VARCHAR(20) NOT NULL DEFAULT 'user' ); CREATE TABLE books ( id INT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(100) NOT NULL, author VARCHAR(50), status ENUM('available','borrowed') DEFAULT 'available' ); CREATE TABLE borrow_records ( id INT PRIMARY KEY AUTO_INCREMENT, book_id INT NOT NULL, user_id INT NOT NULL, borrow_time DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (book_id) REFERENCES books(id), FOREIGN KEY (user_id) REFERENCES users(id) );

注意：ENUM类型比VARCHAR更安全——status字段只能存'available'或'borrowed'，杜绝status='avilable'这类拼写错误导致的逻辑漏洞，这正是Illegal状态的预防性设计。

3.2 Tomcat内置连接池配置：绕过Oracle Net Admin错误的务实方案

网络热词ora-28547: connection to server failed, probable oracle net admin error本质是Oracle客户端配置错误，而大学生作业必须用MySQL。Tomcat 9默认使用DBCP2连接池，需在context.xml中配置：

<!-- conf/context.xml --> <?xml version="1.0" encoding="UTF-8"?> <Context> <Resource name="jdbc/BookDB" auth="Container" type="javax.sql.DataSource" factory="org.apache.tomcat.dbcp.dbcp2.BasicDataSourceFactory" maxTotal="20" maxIdle="10" minIdle="5" initialSize="5" maxWaitMillis="10000" username="root" password="password" driverClassName="com.mysql.cj.jdbc.Driver" url="jdbc:mysql://localhost:3306/library?useSSL=false&amp;serverTimezone=UTC&amp;allowPublicKeyRetrieval=true"/> </Context>

关键参数解析：

• maxTotal="20"：最大连接数，避免高并发时抛出SQLException；
• allowPublicKeyRetrieval=true：MySQL 8.0+必需参数，否则连接被拒绝；
• url中&是XML实体转义，若写成&会导致Tomcat启动失败；
• factory指向DBCP2工厂类，Tomcat 9自带，无需额外jar。

在Servlet中获取连接的代码必须使用JNDI查找：

Context ctx = new InitialContext(); DataSource ds = (DataSource) ctx.lookup("java:comp/env/jdbc/BookDB"); Connection conn = ds.getConnection(); // 此处不再硬编码URL

这种解耦方式使数据库配置与Java代码分离，修改密码只需改context.xml，无需重编译——这才是JavaEE“配置即代码”的精髓。

3.3 验证连接池是否生效：用JMX监控连接数

Tomcat Manager界面（http://localhost:8080/manager/html）提供实时连接池监控。登录后点击应用名进入详情页，查看JDBC Data Sources链接，可看到jdbc/BookDB的Active Connections和Idle Connections数值。当执行借阅操作时，Active Connections应瞬时增加再回落，证明连接池正常复用。若始终为0，则检查：

• context.xml是否放在conf/目录而非WEB-INF/；
• web.xml中是否遗漏<resource-ref>声明；
• MySQL服务是否真正运行（netstat -an | findstr :3306）。

4. Admin后台与安全加固：用Filter实现角色拦截而非硬编码if-else

4.1 构建Admin专属页面：JSP EL表达式驱动动态内容

admin/book-list.jsp不应是静态HTML，而要利用JSP EL展示实时数据：

<%@ page contentType="text/html;charset=UTF-8" language="java" %> <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <!DOCTYPE html> <html> <head><title>管理员图书管理</title></head> <body> <h2>图书列表（共${fn:length(books)}本）</h2> <table border="1"> <tr><th>ID</th><th>书名</th><th>作者</th><th>状态</th><th>操作</th></tr> <c:forEach items="${books}" var="book"> <tr> <td>${book.id}</td> <td>${book.title}</td> <td>${book.author}</td> <td><c:out value="${book.status}"/></td> <td> <c:choose> <c:when test="${book.status == 'available'}"> <a href="borrow?bookId=${book.id}">借阅</a> </c:when> <c:otherwise> <span style="color:red">已借出</span> </c:otherwise> </c:choose> </td> </tr> </c:forEach> </table> </body> </html>

<c:out value="${book.status}"/>自动转义HTML特殊字符，防止XSS攻击；<c:choose>实现状态分支，比Java脚本片段更符合JSP最佳实践。此处books由AdminBookListServlet通过req.setAttribute("books", bookList)传入，体现MVC分层。

4.2 用Filter拦截未授权访问：替代admin密码修改电脑账户的粗暴做法

网络热词admin密码修改电脑账户暴露了常见误区——把Web应用admin账户与操作系统账户混淆。正确做法是用Filter统一校验：

@WebFilter("/admin/*") public class AdminAuthFilter implements Filter { @Override public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request = (HttpServletRequest) req; HttpServletResponse response = (HttpServletResponse) resp; HttpSession session = request.getSession(false); String role = session != null ? (String) session.getAttribute("role") : null; if ("admin".equals(role)) { chain.doFilter(req, resp); // 放行 } else { response.sendRedirect(request.getContextPath() + "/login.jsp?error=admin_required"); } } }

此Filter拦截所有/admin/*路径请求，检查Session中的role属性。若用户登录时已将role存入Session（req.getSession().setAttribute("role", "admin")），则放行；否则重定向到登录页。相比在每个Servlet里写if(!"admin".equals(role)) return;，Filter实现了横切关注点的集中管理。

提示：@WebFilter("/admin/*")注解需配合web.xml中<filter>声明才能在Tomcat 8+生效，否则会静默失效。

4.3 密码安全存储：用BCrypt替代明文存储

LoginServlet中密码校验必须使用强哈希：

// 用户注册时（非作业必需，但体现工程素养） String hashedPassword = BCrypt.hashpw(rawPassword, BCrypt.gensalt(12)); // 登录校验时 if (BCrypt.checkpw(inputPassword, storedHash)) { // 密码正确 }

BCrypt.gensalt(12)生成12轮哈希，足够抵御暴力破解。若作业要求简单实现，至少用MessageDigest.getInstance("SHA-256")加盐（salt），绝不可存明文密码——这是admin账户安全的底线。

5. VSCode调试与Docker部署：让作业成果可演示、可复现、可验证

5.1 VSCode配置JavaEE开发环境：解决vscode配置javaee语言环境痛点

在VSCode中安装以下扩展：

• Extension Pack for Java（微软官方）
• Tomcat for Java（提供一键部署按钮）
• Language Support for Java™ by Red Hat（智能补全）

关键配置settings.json：

{ "java.configuration.updateBuildConfiguration": "interactive", "tomcat.javaHome": "C:\\Program Files\\Java\\jdk-11.0.12", "tomcat.serverPath": "C:\\apache-tomcat-9.0.50", "tomcat.contextPath": "/book-borrow-system" }

启动调试时，右键web.xml选择Deploy to Tomcat，VSCode自动编译、打包、部署。断点打在LoginServlet.java的doPost()方法首行，输入http://localhost:8080/book-borrow-system/login.jsp提交表单，即可单步跟踪request.getParameter("username")获取过程——这才是javaee课程设计应有的调试深度。

5.2 Docker容器化部署：用docker 安装 spring ai alibaba admin思路反推JavaEE最小镜像

虽然作业不强制Docker，但用它可彻底解决环境差异问题。编写Dockerfile：

FROM tomcat:9.0-jre11-openjdk-slim COPY ./target/book-borrow-system.war /usr/local/tomcat/webapps/ COPY ./mysql-connector-java-8.0.33.jar /usr/local/tomcat/lib/ EXPOSE 8080 CMD ["catalina.sh", "run"]

构建命令：

docker build -t book-borrow-app . docker run -d -p 8080:8080 --name book-app book-borrow-app

此时访问http://localhost:8080/book-borrow-system即为完整环境。对比spring ai alibaba admin等复杂方案，此镜像仅280MB，启动秒级完成——证明JavaEE原生方案的轻量优势。

5.3 验证作业完成度的三个黄金指标

不要依赖“页面能打开”这种模糊标准，用以下可量化指标验收：

1. URL路径验证：访问/login返回HTTP 200，访问/admin/book-list.jsp返回HTTP 302（重定向到登录页）证明Filter生效；
2. 数据库记录验证：执行一次借阅后，borrow_records表新增一行，且books.status变为borrowed；
3. 日志交叉验证：Tomcatcatalina.out中出现BorrowServlet: 借阅成功，同时MySQL慢查询日志记录对应UPDATE语句。

这三个指标缺一不可。当答辩老师问“你怎么证明借阅功能真实有效？”，直接打开浏览器开发者工具Network面板、MySQL命令行、Tomcat日志文件三窗口并排展示，比任何PPT都更有说服力。

本文还有配套的精品资源，点击获取