尧图网页设计 
简介这是一份基于J2EE技术栈的“云工厂-网上书城”完整项目压缩包面向正在学习Java企业级开发或需要课程设计、毕业设计参考的开发者。项目从用户前端到后台服务再到数据库交互均有覆盖集中展示Servlet、JSP、JavaBeans、EJB、JDBC等技术的多层架构写法。压缩包共588个文件约4.09MB主要包含83个Java源码、82个class文件、45个JSP页面及相关CSS样式同时带有SQL/DB数据库脚本和大量GIF/JPG/SWF演示素材便于直接对照运行效果与代码实现。目前已有241人学习下载。解压后可通过数据库脚本建表结合JSP和Servlet理解登录、搜索、购买、购物车等功能模块其清晰的目录划分和完整前后端链路也适合作为J2EE项目实践与课堂讲解的案例。1. 云工厂-网上书城拆一个能跑通下单流程的 J2EE 项目云工厂-网上书城这名字在下载站里不算显眼但它属于那种少见的、能把“注册→浏览→加购物车→下订单→后台发货”整条链路完整串起来的 J2EE 教学型项目。第一次拿到这份源码时我最关心的不是页面好不好看而是它是否还在用那套最经典的 JSP Servlet Service DAO 分工——拆开看确实是这样没有 Spring 全家桶遮挡请求到数据库之间的任何一步。对那些简历里写着“熟悉 Java Web 开发”但只做过增删改查的人来说这份代码能帮你把 Model 2 架构、Session 购物车、事务边界这些概念一次性对齐到真实代码上。如果你正在学 Servlet 生命周期或者准备给毕业设计找一个可靠的底子这团源码比短视频里的“三天做出网上商城”靠谱得多。它适合的读者很明确还停留在框架调用层次、对 J2EE 底层处理流程缺乏实感的初中级 Java 开发者。不需要你懂得分布式带着 IDEA 或 Eclipse配一个本地 MySQL照着下面的步骤就能看到整个请求如何从 index.jsp 出发穿过层层 Java 类最后落到 orders 表里。这也是我写这篇拆解笔记的原因——把我解压、改配置、踩坑、重跑的过程都记下来能省掉你至少一个下午的查错时间。2. 云工厂-网上书城项目拆解从 WAR 包到模块边界2.1 按 J2EE 分层看代码边界Web 层、业务层、持久层J2EE 发展到今天最容易被忽略的其实是“分层纪律”。云工厂-网上书城这点做得比很多培训机构的项目清楚它把 Java 源码按职责塞进几个包而不是把所有逻辑堆在 Servlet 里。拿到的 WAR 包解压后典型的 WebContent 结构通常是下面这个形状cloudbook ├── src │ ├── com/cloudbook.web │ │ ├── servlet │ │ │ ├── UserServlet.java │ │ │ ├── BookServlet.java │ │ │ └── OrderServlet.java │ │ ├── filter │ │ │ ├── EncodingFilter.java │ │ │ └── LoginFilter.java │ ├── com/cloudbook.service │ │ └── BookService.java │ ├── com/cloudbook.dao │ │ └── BookDao.java │ └── com/cloudbook.model │ ├── Book.java │ └── User.java ├── WebContent │ ├── jsp │ │ ├── index.jsp │ │ ├── book_list.jsp │ │ ├── cart.jsp │ │ └── order_confirm.jsp │ ├── WEB-INF │ │ └── web.xml │ └── lib │ └── mysql-connector-java-5.1.49.jar └── sql └── cloudbook.sql这里最值得看的是 Servlet 只负责“接参、调 service、跳转”而 Service 层集中处理库存校验、价格计算这类业务规则DAO 层负责拼 SQL、执行 JDBC、把 ResultSet 转成 Model 对象。这样的边界带来的直接好处理是如果上线后发现某本书下单后库存不减你会直接去翻 BookDao.updateStock()而不是从 index.jsp 开始读代码。对于初学者这比“一个 Servlet 干所有事”的版本更容易追踪请求的数据流。我一般会建议先读 BookService 和 BookDao 这两个类因为它们体量最小、依赖最干净能直观看到 J2EE 项目里控制反转出现之前对象之间是怎么手动 new 出来的。没有注入、没有 AOP所有依赖都在构造方法或 setter 里显示传递这种方式看着啰嗦但对理解调用链非常有帮助。2.2 关键配置文件web.xml 与服务映射Servlet 3.0 之后支持注解但老派 J2EE 项目还是把配置集中在 web.xml 里好处是改路径不用重新编译。我拿到的这份源码在 WEB-INF/web.xml 里维护了所有核心服务映射核心片段类似这样web-app xmlnshttp://xmlns.jcp.org/xml/ns/javaee version3.1 display-nameCloudFactoryBookstore/display-name welcome-file-list welcome-filejsp/index.jsp/welcome-file /welcome-file-list servlet servlet-nameBookListServlet/servlet-name servlet-classcom.cloudbook.web.servlet.BookListServlet/servlet-class /servlet servlet-mapping servlet-nameBookListServlet/servlet-name url-pattern/book/list/url-pattern /servlet-mapping session-config session-timeout30/session-timeout /session-config /web-app这里面有个容易忽略的细节url-pattern用的是/book/list这种扩展名无关的路径而不是老项目里常见的*.do。好处是浏览器地址栏直接暴露真实意图配合代码里的resp.sendRedirect(book/list)不容易产生路径错乱。另一个需要留意的是session-timeout它默认单位是分钟设为 30 表示购物车数据在用户停止操作半小时后失效。这个值如果在线上过小用户选半天书再下单就会因为会话过期而出现“购物车空了”的投诉。请求进来的过滤器也注册在 web.xml 里常见的EncodingFilter会在 servlet 之前强制设置request.setCharacterEncoding(UTF-8)。如果你在本地复现时发现中文参数乱码第一件事不是改 Servlet而是检查这个 Filter 是否被正确挂到了 URL 模式上。它看似不起眼但几乎决定了整个项目的中文友好度。2.3 数据访问设计与 MySQL 初始化脚本数据层是这份源码最传统也最扎实的部分。仓库里通常带一个sql/cloudbook.sql用来初始化库表。建表语句应该符合这么几个特征字段用下划线命名、主键自增、必备created_at。一个可用的最小版本是这样CREATE DATABASE IF NOT EXISTS cloudbook DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE cloudbook; CREATE TABLE user ( user_id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(32) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, created_at DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB; CREATE TABLE book ( book_id INT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(128) NOT NULL, author VARCHAR(64), price DECIMAL(10,2) NOT NULL, stock INT NOT NULL DEFAULT 0, sales INT NOT NULL DEFAULT 0 ) ENGINEInnoDB; CREATE TABLE orders ( order_id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, total_amount DECIMAL(10,2) NOT NULL, status TINYINT NOT NULL DEFAULT 0, create_time DATETIME NOT NULL, CONSTRAINT fk_orders_user FOREIGN KEY (user_id) REFERENCES user(user_id) ) ENGINEInnoDB;建表有几个选择值得展开说。utf8mb4而不是utf8是因为 utf8 在 MySQL 里最多存 3 字节碰上 emoji 或生僻字直接报错网上书城用户昵称里出现表情符号一点都不稀奇。DECIMAL(10,2)是金额字段的正确姿势用 float 会埋下浮点误差等对账时再发现就晚了。ENGINEInnoDB是另一个关键点它是唯一支持事务提交的常用引擎订单创建时必须依赖事务保证“订单表插入成功但库存扣减失败”的情况能整体回滚。MyISAM 在这些老项目里偶尔见到但它不支持行级锁在线书店改库存时很容易把整张表锁住并发稍高就卡。DAO 部分的典型写法是先用Connection拿到连接然后PreparedStatement拼参数再executeUpdate或executeQuery。例如BookDao.findHotBooks()内部可能就是这样一个方法读连接、执行SELECT ... ORDER BY sales DESC LIMIT 10、把每条记录封装成 Book 对象、放进 List 返回。中间没有连接池没有 ORM一切靠自己。看这份源码时别急着嘲笑代码土先想想为什么后来要引入 MyBatis——多半就是因为这种手写 JDBC 样板代码实在太多而不是因为 JDBC 本身不能用。3. 把书城跑起来环境准备、连接配置与部署验证3.1 环境准备对照表版本选不好后面全是泪技术栈确定了接下来就是环境。我复现时第一次就栽在版本组合上系统装了 JDK 17 MySQL 8.0 Tomcat 10结果项目里的 JSP 一编译就报javax.servlet包不存在。后来换成下面的组合全部流程一气呵成组件推荐版本说明JDK1.8兼容性最好老代码的编译参数不用改Tomcat8.5.x支持 Servlet 3.1/JSP 2.3和 J2EE 项目同代MySQL5.7.x驱动名不需要额外处理cj前缀MySQL Connector/J5.1.49已有 jar 或 Maven 依赖均可构建方式Eclipse 直接导入 WAR省去 Maven 坐标对不上的麻烦差一个版本就会出各种诡异问题。比如 MySQL 8.0 需要驱动类改成com.mysql.cj.jdbc.Driver并且要额外带serverTimezone参数Tomcat 10 则把包名换成了jakarta.*旧代码直接没法编译。所以我建议第一步就照这个表把环境逼平不要想着“高版本肯定能向下兼容”。学习型项目的目的是跑通逻辑不是挑战升级路线。3.2 修改数据库连接参数从 DAO 到 JDBC 驱动大多数 J2EE 项目会把数据库连接抽到一个静态类里常见名字是DBUtil或BaseDao。我拿到这份源码时里面是这样一段代码public class DBUtil { private static final String URL jdbc:mysql://localhost:3306/cloudbook ?useUnicodetruecharacterEncodingutf8useSSLfalse; private static final String USER root; private static final String PASSWORD 123456; static { try { Class.forName(com.mysql.jdbc.Driver); } catch (ClassNotFoundException e) { throw new ExceptionInInitializerError(e); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } }这段代码有四个参数要按你的本机情况进行修改数据库 IP、端口、用户名、密码。useUnicodetruecharacterEncodingutf8这两个参数能够让连接层面返回的中文不扭曲useSSLfalse是为了省掉本地环境根本没有的 SSL 证书配置。驱动类com.mysql.jdbc.Driver是 Connector/J 5.x 的花名如果你换成了新版驱动请同步改成com.mysql.cj.jdbc.Driver否则会抛ClassNotFoundException。改完参数后最头疼的情况是明明改了PASSWORD项目启动后仍连库失败。原因多半是编译后的 class 文件没有被重新发布Tomcat 还在用旧的 class。所以改完 DBUtil 之后不要只点保存要在 IDE 里强制重新编译整个项目并把 Tomcat 的temp和work目录清掉再重启。3.3 部署到 Tomcat三种方式与启动日志部署方式没有一步登天的魔法无非是这几种但我会优先推荐第一种因为离命令行最近出问题也最好查。方式一直接打 WAR 包放到webapps目录。Eclipse 里右键项目选 Export → WAR file生成cloudbook.war后复制进 Tomcat 的webapps。然后在命令行启动export CATALINA_HOME/opt/tomcat8 cp cloudbook.war $CATALINA_HOME/webapps/ $CATALINA_HOME/bin/startup.sh tail -f $CATALINA_HOME/logs/catalina.outTomcat 启动时会自动解压 war 包日志出现Deploying web application archive之后紧跟一句Deployment of web application archive ... has finished就说明部署成功。这里解释下catalina.out它是 Tomcat 所有标准输出和异常的汇总日志里只要看到SEVERE或Exception基本就是启动失败根因。方式二在 Eclipse 的 Servers 视图里添加 Tomcat 8.5右键项目 Run As → Run on Server。好处是断点调试方便坏处是 IDE 有时会静默吞掉启动异常页面响应不对又不说为什么。方式三用 Maven 插件但很多老项目根本没有 pom.xml硬加会让依赖管理变成一场灾难。我会在完整跑通后再考虑迁移到 Maven。部署后访问路径是http://localhost:8080/cloudbook/其中/cloudbook是 war 包的上下文路径。如果页面 404先看webapps下有没有解压后的cloudbook目录再检查 Tomcat 是否用了非 8080 端口。3.4 验证订单流程从注册到下单的冒烟测试项目初始化完成后不要直接进用户界面瞎点我习惯先做一次冒烟测试确认几个关键服务在线。用 curl 检查首页和列表页curl -I http://localhost:8080/cloudbook/ curl -I http://localhost:8080/cloudbook/book/list?page1第一条命令如果返回200 OK说明欢迎页和容器路由是通的第二条会带出 Session Cookie。虽然 JSP 最终渲染的是 HTML但在这个阶段我们看的是 HTTP 状态码只要不是 404 或 500 就可以继续。接下来进浏览器按我总结的顺序走一遍完整链路注册一个新账号用户名带中文验证数据库utf8mb4是否真生效。登录后进图书列表选一本书加入购物车。在购物车页面修改数量为 2再结算。填收货地址提交订单。用 MySQL 查orders表和book.sales确认金额与数量一致。这一步里最有价值的是最后一步。很多人网页上显示“下单成功”就完事了但表里的stock字段是否真的减少了、sales是否增加了才是订单逻辑正确的证据。用 SQL 核对一遍SELECT book_id, title, stock, sales FROM book WHERE book_id 1; SELECT order_id, user_id, total_amount, status FROM orders ORDER BY order_id DESC LIMIT 3;出现不一致基本可以断定 Service 层的事务或者 DAO 层 update 语句出了问题。比对着页面看半天有用得多。4. 避坑指南J2EE 书城项目里最常见的五个坑4.1 页面跳转 404相对路径和绝对路径打架现象登录成功后跳转/book/list显示 404但地址栏手动输入却能打开。原因Servlet 里写的response.sendRedirect(book/list)是相对路径它相对于当前 URL 的目录解析。如果当前 URL 是/cloudbook/user/login相对路径会被解析成/cloudbook/user/book/list自然找不到映射。解决在 Servlet 里统一用带有上下文根的前缀我最常用的写法是String ctx request.getContextPath(); response.sendRedirect(ctx /book/list);getContextPath()返回/cloudbook这样无论在本地还是部署到子目录跳转都不会错位。4.2 中文乱码POST 请求设置了也没用现象注册时输入中文用户名存进 MySQL 后变成???或乱码。原因JSP 页面本身是 UTF-8 没错但 POST 请求体默认按容器编码解码。如果EncodingFilter没有覆盖到所有 Servlet请求中的中文参数在进入 Action 前就已经变成乱码后面再存储都是错上加错。解决先确保EncodingFilter映射的是/*然后在过滤器顶端加两行代码request.setCharacterEncoding(UTF-8); response.setContentType(text/html; charsetUTF-8);另外MySQL 连接参数里我已经强调过要加characterEncodingutf8这三层必须同时正确中文才保得住。4.3 数据库连接失败驱动类找不到或时区报错现象启动 Tomcat 后访问首页的图书列表接口报ClassNotFoundException: com.mysql.jdbc.Driver或者The server time zone value ... is unrecognized。原因驱动 jar 没有复制到WEB-INF/lib或者 jar 版本和 MySQL 服务端版本不对应。在 MySQL 8.0 下继续使用旧驱动会因省略时区参数而抛异常。解决确认WEB-INF/lib下有 mysql-connector-java 的 jar。老驱动对 MySQL 5.7新驱动对 MySQL 8.0。如果就是不愿意换环境可以在 JDBC URL 加serverTimezoneAsia/ShanghaiuseSSLfalse再改成com.mysql.cj.jdbc.Driver。4.4 构造函数和表字段对不上ResultSet 拿到鼻子上现象代码能从 SQL 查出数据但页面列表行显示空白或抛NoSuchMethodError。原因BookDao里手动rs.getInt(book_id)赋值给Book对象但修改过表结构后字段名或类型不一致。例如把price改成DECIMAL(9,2)但 setter 还按Integer接收。解决打开BookDao把 SQL 查询和实体字段逐个对一遍。每一条rs.getInt、rs.getString、rs.getBigDecimal都要对应建表语句。改动表结构绝不是只跑一次 SQL 就完事一定要同步修改 DAO 层代码。4.5 库存和销量对不上事务被默默吞掉现象下单后orders表新增记录但book.sales没有增加或者库存变成负数。原因代码里先插入订单再更新图书销量但Connection默认是自动提交。如果第二步执行失败抛出异常第一步已经写入的数据不会回滚于是出现“有订单无销量”。解决在 Service 层把两步包在同一个事务里核心代码结构如下Connection conn DBUtil.getConnection(); try { conn.setAutoCommit(false); orderDao.insert(conn, order); bookDao.increaseSales(conn, bookId, count); conn.commit(); } catch (SQLException e) { conn.rollback(); throw e; } finally { conn.setAutoCommit(true); conn.close(); }这里的要点是 DAO 方法必须共享同一个连接而不是各自去DBUtil.getConnection()。否则事务就只是摆设。上面代码瞬间解决了“下单成功但数据对不上”的多数问题。5. 把项目改造成自己的连接池重构与一页纸验收清单基础版本跑通后不要急着申请下一份源码先拿这本书城做一次低风险重构。我第一个会动的地方是把DBUtil里面的DriverManager连接换成连接池毕竟每次请求都新建连接实在浪费。常见做法是引入 Apache Commons DBCP2初始化代码可以缩成这样import org.apache.commons.dbcp2.BasicDataSource; public class DBUtil { private static BasicDataSource ds; static { ds new BasicDataSource(); ds.setUrl(jdbc:mysql://localhost:3306/cloudbook?useUnicodetruecharacterEncodingutf8); ds.setUsername(root); ds.setPassword(123456); ds.setDriverClassName(com.mysql.jdbc.Driver); ds.setInitialSize(5); ds.setMaxTotal(20); ds.setMaxWaitMillis(3000); } public static Connection getConnection() throws SQLException { return ds.getConnection(); } }这改动的好处是并发上来后 Tomcat 不会因为频繁创建销毁连接而被拖垮maxTotal20表示最多同时 20 个连接超过就排队等待。每次上线前我会用一页纸清单做最终验收访问首页返回 200、注册中文用户名不乱码、登录后 Session 保持正常、购物车加购数量正确、下单后订单表金额正确、库存扣减同步、后台能看到订单且状态可流转。只要有一条不满足就往对应层翻代码。这份项目真正有价值的不是页面而是那几个够典型的事务与跳转案例。从那以后我每次搭 Java Web 项目都会强制自己先走一遍这条从 SQL 到 Servlet 的原始链路把框架带来的自动连接、自动事务先拆掉看懂了再包上一层 MyBatis 或 Spring心里才踏实。希望帮到你。本文还有配套的精品资源点击获取 拆解一个能跑通的J2EE网上书城项目：从JSP到MySQL全流程解析
简介这是一份基于J2EE技术栈的“云工厂-网上书城”完整项目压缩包面向正在学习Java企业级开发或需要课程设计、毕业设计参考的开发者。项目从用户前端到后台服务再到数据库交互均有覆盖集中展示Servlet、JSP、JavaBeans、EJB、JDBC等技术的多层架构写法。压缩包共588个文件约4.09MB主要包含83个Java源码、82个class文件、45个JSP页面及相关CSS样式同时带有SQL/DB数据库脚本和大量GIF/JPG/SWF演示素材便于直接对照运行效果与代码实现。目前已有241人学习下载。解压后可通过数据库脚本建表结合JSP和Servlet理解登录、搜索、购买、购物车等功能模块其清晰的目录划分和完整前后端链路也适合作为J2EE项目实践与课堂讲解的案例。1. 云工厂-网上书城拆一个能跑通下单流程的 J2EE 项目云工厂-网上书城这名字在下载站里不算显眼但它属于那种少见的、能把“注册→浏览→加购物车→下订单→后台发货”整条链路完整串起来的 J2EE 教学型项目。第一次拿到这份源码时我最关心的不是页面好不好看而是它是否还在用那套最经典的 JSP Servlet Service DAO 分工——拆开看确实是这样没有 Spring 全家桶遮挡请求到数据库之间的任何一步。对那些简历里写着“熟悉 Java Web 开发”但只做过增删改查的人来说这份代码能帮你把 Model 2 架构、Session 购物车、事务边界这些概念一次性对齐到真实代码上。如果你正在学 Servlet 生命周期或者准备给毕业设计找一个可靠的底子这团源码比短视频里的“三天做出网上商城”靠谱得多。它适合的读者很明确还停留在框架调用层次、对 J2EE 底层处理流程缺乏实感的初中级 Java 开发者。不需要你懂得分布式带着 IDEA 或 Eclipse配一个本地 MySQL照着下面的步骤就能看到整个请求如何从 index.jsp 出发穿过层层 Java 类最后落到 orders 表里。这也是我写这篇拆解笔记的原因——把我解压、改配置、踩坑、重跑的过程都记下来能省掉你至少一个下午的查错时间。2. 云工厂-网上书城项目拆解从 WAR 包到模块边界2.1 按 J2EE 分层看代码边界Web 层、业务层、持久层J2EE 发展到今天最容易被忽略的其实是“分层纪律”。云工厂-网上书城这点做得比很多培训机构的项目清楚它把 Java 源码按职责塞进几个包而不是把所有逻辑堆在 Servlet 里。拿到的 WAR 包解压后典型的 WebContent 结构通常是下面这个形状cloudbook ├── src │ ├── com/cloudbook.web │ │ ├── servlet │ │ │ ├── UserServlet.java │ │ │ ├── BookServlet.java │ │ │ └── OrderServlet.java │ │ ├── filter │ │ │ ├── EncodingFilter.java │ │ │ └── LoginFilter.java │ ├── com/cloudbook.service │ │ └── BookService.java │ ├── com/cloudbook.dao │ │ └── BookDao.java │ └── com/cloudbook.model │ ├── Book.java │ └── User.java ├── WebContent │ ├── jsp │ │ ├── index.jsp │ │ ├── book_list.jsp │ │ ├── cart.jsp │ │ └── order_confirm.jsp │ ├── WEB-INF │ │ └── web.xml │ └── lib │ └── mysql-connector-java-5.1.49.jar └── sql └── cloudbook.sql这里最值得看的是 Servlet 只负责“接参、调 service、跳转”而 Service 层集中处理库存校验、价格计算这类业务规则DAO 层负责拼 SQL、执行 JDBC、把 ResultSet 转成 Model 对象。这样的边界带来的直接好处理是如果上线后发现某本书下单后库存不减你会直接去翻 BookDao.updateStock()而不是从 index.jsp 开始读代码。对于初学者这比“一个 Servlet 干所有事”的版本更容易追踪请求的数据流。我一般会建议先读 BookService 和 BookDao 这两个类因为它们体量最小、依赖最干净能直观看到 J2EE 项目里控制反转出现之前对象之间是怎么手动 new 出来的。没有注入、没有 AOP所有依赖都在构造方法或 setter 里显示传递这种方式看着啰嗦但对理解调用链非常有帮助。2.2 关键配置文件web.xml 与服务映射Servlet 3.0 之后支持注解但老派 J2EE 项目还是把配置集中在 web.xml 里好处是改路径不用重新编译。我拿到的这份源码在 WEB-INF/web.xml 里维护了所有核心服务映射核心片段类似这样web-app xmlnshttp://xmlns.jcp.org/xml/ns/javaee version3.1 display-nameCloudFactoryBookstore/display-name welcome-file-list welcome-filejsp/index.jsp/welcome-file /welcome-file-list servlet servlet-nameBookListServlet/servlet-name servlet-classcom.cloudbook.web.servlet.BookListServlet/servlet-class /servlet servlet-mapping servlet-nameBookListServlet/servlet-name url-pattern/book/list/url-pattern /servlet-mapping session-config session-timeout30/session-timeout /session-config /web-app这里面有个容易忽略的细节url-pattern用的是/book/list这种扩展名无关的路径而不是老项目里常见的*.do。好处是浏览器地址栏直接暴露真实意图配合代码里的resp.sendRedirect(book/list)不容易产生路径错乱。另一个需要留意的是session-timeout它默认单位是分钟设为 30 表示购物车数据在用户停止操作半小时后失效。这个值如果在线上过小用户选半天书再下单就会因为会话过期而出现“购物车空了”的投诉。请求进来的过滤器也注册在 web.xml 里常见的EncodingFilter会在 servlet 之前强制设置request.setCharacterEncoding(UTF-8)。如果你在本地复现时发现中文参数乱码第一件事不是改 Servlet而是检查这个 Filter 是否被正确挂到了 URL 模式上。它看似不起眼但几乎决定了整个项目的中文友好度。2.3 数据访问设计与 MySQL 初始化脚本数据层是这份源码最传统也最扎实的部分。仓库里通常带一个sql/cloudbook.sql用来初始化库表。建表语句应该符合这么几个特征字段用下划线命名、主键自增、必备created_at。一个可用的最小版本是这样CREATE DATABASE IF NOT EXISTS cloudbook DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE cloudbook; CREATE TABLE user ( user_id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(32) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, created_at DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB; CREATE TABLE book ( book_id INT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(128) NOT NULL, author VARCHAR(64), price DECIMAL(10,2) NOT NULL, stock INT NOT NULL DEFAULT 0, sales INT NOT NULL DEFAULT 0 ) ENGINEInnoDB; CREATE TABLE orders ( order_id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, total_amount DECIMAL(10,2) NOT NULL, status TINYINT NOT NULL DEFAULT 0, create_time DATETIME NOT NULL, CONSTRAINT fk_orders_user FOREIGN KEY (user_id) REFERENCES user(user_id) ) ENGINEInnoDB;建表有几个选择值得展开说。utf8mb4而不是utf8是因为 utf8 在 MySQL 里最多存 3 字节碰上 emoji 或生僻字直接报错网上书城用户昵称里出现表情符号一点都不稀奇。DECIMAL(10,2)是金额字段的正确姿势用 float 会埋下浮点误差等对账时再发现就晚了。ENGINEInnoDB是另一个关键点它是唯一支持事务提交的常用引擎订单创建时必须依赖事务保证“订单表插入成功但库存扣减失败”的情况能整体回滚。MyISAM 在这些老项目里偶尔见到但它不支持行级锁在线书店改库存时很容易把整张表锁住并发稍高就卡。DAO 部分的典型写法是先用Connection拿到连接然后PreparedStatement拼参数再executeUpdate或executeQuery。例如BookDao.findHotBooks()内部可能就是这样一个方法读连接、执行SELECT ... ORDER BY sales DESC LIMIT 10、把每条记录封装成 Book 对象、放进 List 返回。中间没有连接池没有 ORM一切靠自己。看这份源码时别急着嘲笑代码土先想想为什么后来要引入 MyBatis——多半就是因为这种手写 JDBC 样板代码实在太多而不是因为 JDBC 本身不能用。3. 把书城跑起来环境准备、连接配置与部署验证3.1 环境准备对照表版本选不好后面全是泪技术栈确定了接下来就是环境。我复现时第一次就栽在版本组合上系统装了 JDK 17 MySQL 8.0 Tomcat 10结果项目里的 JSP 一编译就报javax.servlet包不存在。后来换成下面的组合全部流程一气呵成组件推荐版本说明JDK1.8兼容性最好老代码的编译参数不用改Tomcat8.5.x支持 Servlet 3.1/JSP 2.3和 J2EE 项目同代MySQL5.7.x驱动名不需要额外处理cj前缀MySQL Connector/J5.1.49已有 jar 或 Maven 依赖均可构建方式Eclipse 直接导入 WAR省去 Maven 坐标对不上的麻烦差一个版本就会出各种诡异问题。比如 MySQL 8.0 需要驱动类改成com.mysql.cj.jdbc.Driver并且要额外带serverTimezone参数Tomcat 10 则把包名换成了jakarta.*旧代码直接没法编译。所以我建议第一步就照这个表把环境逼平不要想着“高版本肯定能向下兼容”。学习型项目的目的是跑通逻辑不是挑战升级路线。3.2 修改数据库连接参数从 DAO 到 JDBC 驱动大多数 J2EE 项目会把数据库连接抽到一个静态类里常见名字是DBUtil或BaseDao。我拿到这份源码时里面是这样一段代码public class DBUtil { private static final String URL jdbc:mysql://localhost:3306/cloudbook ?useUnicodetruecharacterEncodingutf8useSSLfalse; private static final String USER root; private static final String PASSWORD 123456; static { try { Class.forName(com.mysql.jdbc.Driver); } catch (ClassNotFoundException e) { throw new ExceptionInInitializerError(e); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } }这段代码有四个参数要按你的本机情况进行修改数据库 IP、端口、用户名、密码。useUnicodetruecharacterEncodingutf8这两个参数能够让连接层面返回的中文不扭曲useSSLfalse是为了省掉本地环境根本没有的 SSL 证书配置。驱动类com.mysql.jdbc.Driver是 Connector/J 5.x 的花名如果你换成了新版驱动请同步改成com.mysql.cj.jdbc.Driver否则会抛ClassNotFoundException。改完参数后最头疼的情况是明明改了PASSWORD项目启动后仍连库失败。原因多半是编译后的 class 文件没有被重新发布Tomcat 还在用旧的 class。所以改完 DBUtil 之后不要只点保存要在 IDE 里强制重新编译整个项目并把 Tomcat 的temp和work目录清掉再重启。3.3 部署到 Tomcat三种方式与启动日志部署方式没有一步登天的魔法无非是这几种但我会优先推荐第一种因为离命令行最近出问题也最好查。方式一直接打 WAR 包放到webapps目录。Eclipse 里右键项目选 Export → WAR file生成cloudbook.war后复制进 Tomcat 的webapps。然后在命令行启动export CATALINA_HOME/opt/tomcat8 cp cloudbook.war $CATALINA_HOME/webapps/ $CATALINA_HOME/bin/startup.sh tail -f $CATALINA_HOME/logs/catalina.outTomcat 启动时会自动解压 war 包日志出现Deploying web application archive之后紧跟一句Deployment of web application archive ... has finished就说明部署成功。这里解释下catalina.out它是 Tomcat 所有标准输出和异常的汇总日志里只要看到SEVERE或Exception基本就是启动失败根因。方式二在 Eclipse 的 Servers 视图里添加 Tomcat 8.5右键项目 Run As → Run on Server。好处是断点调试方便坏处是 IDE 有时会静默吞掉启动异常页面响应不对又不说为什么。方式三用 Maven 插件但很多老项目根本没有 pom.xml硬加会让依赖管理变成一场灾难。我会在完整跑通后再考虑迁移到 Maven。部署后访问路径是http://localhost:8080/cloudbook/其中/cloudbook是 war 包的上下文路径。如果页面 404先看webapps下有没有解压后的cloudbook目录再检查 Tomcat 是否用了非 8080 端口。3.4 验证订单流程从注册到下单的冒烟测试项目初始化完成后不要直接进用户界面瞎点我习惯先做一次冒烟测试确认几个关键服务在线。用 curl 检查首页和列表页curl -I http://localhost:8080/cloudbook/ curl -I http://localhost:8080/cloudbook/book/list?page1第一条命令如果返回200 OK说明欢迎页和容器路由是通的第二条会带出 Session Cookie。虽然 JSP 最终渲染的是 HTML但在这个阶段我们看的是 HTTP 状态码只要不是 404 或 500 就可以继续。接下来进浏览器按我总结的顺序走一遍完整链路注册一个新账号用户名带中文验证数据库utf8mb4是否真生效。登录后进图书列表选一本书加入购物车。在购物车页面修改数量为 2再结算。填收货地址提交订单。用 MySQL 查orders表和book.sales确认金额与数量一致。这一步里最有价值的是最后一步。很多人网页上显示“下单成功”就完事了但表里的stock字段是否真的减少了、sales是否增加了才是订单逻辑正确的证据。用 SQL 核对一遍SELECT book_id, title, stock, sales FROM book WHERE book_id 1; SELECT order_id, user_id, total_amount, status FROM orders ORDER BY order_id DESC LIMIT 3;出现不一致基本可以断定 Service 层的事务或者 DAO 层 update 语句出了问题。比对着页面看半天有用得多。4. 避坑指南J2EE 书城项目里最常见的五个坑4.1 页面跳转 404相对路径和绝对路径打架现象登录成功后跳转/book/list显示 404但地址栏手动输入却能打开。原因Servlet 里写的response.sendRedirect(book/list)是相对路径它相对于当前 URL 的目录解析。如果当前 URL 是/cloudbook/user/login相对路径会被解析成/cloudbook/user/book/list自然找不到映射。解决在 Servlet 里统一用带有上下文根的前缀我最常用的写法是String ctx request.getContextPath(); response.sendRedirect(ctx /book/list);getContextPath()返回/cloudbook这样无论在本地还是部署到子目录跳转都不会错位。4.2 中文乱码POST 请求设置了也没用现象注册时输入中文用户名存进 MySQL 后变成???或乱码。原因JSP 页面本身是 UTF-8 没错但 POST 请求体默认按容器编码解码。如果EncodingFilter没有覆盖到所有 Servlet请求中的中文参数在进入 Action 前就已经变成乱码后面再存储都是错上加错。解决先确保EncodingFilter映射的是/*然后在过滤器顶端加两行代码request.setCharacterEncoding(UTF-8); response.setContentType(text/html; charsetUTF-8);另外MySQL 连接参数里我已经强调过要加characterEncodingutf8这三层必须同时正确中文才保得住。4.3 数据库连接失败驱动类找不到或时区报错现象启动 Tomcat 后访问首页的图书列表接口报ClassNotFoundException: com.mysql.jdbc.Driver或者The server time zone value ... is unrecognized。原因驱动 jar 没有复制到WEB-INF/lib或者 jar 版本和 MySQL 服务端版本不对应。在 MySQL 8.0 下继续使用旧驱动会因省略时区参数而抛异常。解决确认WEB-INF/lib下有 mysql-connector-java 的 jar。老驱动对 MySQL 5.7新驱动对 MySQL 8.0。如果就是不愿意换环境可以在 JDBC URL 加serverTimezoneAsia/ShanghaiuseSSLfalse再改成com.mysql.cj.jdbc.Driver。4.4 构造函数和表字段对不上ResultSet 拿到鼻子上现象代码能从 SQL 查出数据但页面列表行显示空白或抛NoSuchMethodError。原因BookDao里手动rs.getInt(book_id)赋值给Book对象但修改过表结构后字段名或类型不一致。例如把price改成DECIMAL(9,2)但 setter 还按Integer接收。解决打开BookDao把 SQL 查询和实体字段逐个对一遍。每一条rs.getInt、rs.getString、rs.getBigDecimal都要对应建表语句。改动表结构绝不是只跑一次 SQL 就完事一定要同步修改 DAO 层代码。4.5 库存和销量对不上事务被默默吞掉现象下单后orders表新增记录但book.sales没有增加或者库存变成负数。原因代码里先插入订单再更新图书销量但Connection默认是自动提交。如果第二步执行失败抛出异常第一步已经写入的数据不会回滚于是出现“有订单无销量”。解决在 Service 层把两步包在同一个事务里核心代码结构如下Connection conn DBUtil.getConnection(); try { conn.setAutoCommit(false); orderDao.insert(conn, order); bookDao.increaseSales(conn, bookId, count); conn.commit(); } catch (SQLException e) { conn.rollback(); throw e; } finally { conn.setAutoCommit(true); conn.close(); }这里的要点是 DAO 方法必须共享同一个连接而不是各自去DBUtil.getConnection()。否则事务就只是摆设。上面代码瞬间解决了“下单成功但数据对不上”的多数问题。5. 把项目改造成自己的连接池重构与一页纸验收清单基础版本跑通后不要急着申请下一份源码先拿这本书城做一次低风险重构。我第一个会动的地方是把DBUtil里面的DriverManager连接换成连接池毕竟每次请求都新建连接实在浪费。常见做法是引入 Apache Commons DBCP2初始化代码可以缩成这样import org.apache.commons.dbcp2.BasicDataSource; public class DBUtil { private static BasicDataSource ds; static { ds new BasicDataSource(); ds.setUrl(jdbc:mysql://localhost:3306/cloudbook?useUnicodetruecharacterEncodingutf8); ds.setUsername(root); ds.setPassword(123456); ds.setDriverClassName(com.mysql.jdbc.Driver); ds.setInitialSize(5); ds.setMaxTotal(20); ds.setMaxWaitMillis(3000); } public static Connection getConnection() throws SQLException { return ds.getConnection(); } }这改动的好处是并发上来后 Tomcat 不会因为频繁创建销毁连接而被拖垮maxTotal20表示最多同时 20 个连接超过就排队等待。每次上线前我会用一页纸清单做最终验收访问首页返回 200、注册中文用户名不乱码、登录后 Session 保持正常、购物车加购数量正确、下单后订单表金额正确、库存扣减同步、后台能看到订单且状态可流转。只要有一条不满足就往对应层翻代码。这份项目真正有价值的不是页面而是那几个够典型的事务与跳转案例。从那以后我每次搭 Java Web 项目都会强制自己先走一遍这条从 SQL 到 Servlet 的原始链路把框架带来的自动连接、自动事务先拆掉看懂了再包上一层 MyBatis 或 Spring心里才踏实。希望帮到你。本文还有配套的精品资源点击获取