JSP商城项目源码解析：MVC分层与部署优化

简介一份基于Java的JSP网上购物商城源码包面向正在学习JavaWeb开发的学生、毕业设计作者及初级开发者提供了从商品展示、用户登录到后台管理的完整交互流程整体界面清晰、功能模块划分明确便于按需查阅。包体共108个文件压缩包约1.7MB其中java与class文件对应业务逻辑和编译结果jsp文件用于前端页面展示jpg/gif/png等图片资源支撑界面视觉js/css完善交互效果另包含项目配置与元数据文件便于导入开发环境后直接运行查看。内容覆盖用户、商品、分类、评论等核心模块并包含Login、Product、Class等Servlet处理请求的典型写法适合用来理解JSPServletDAO结构的开发模式也可作为课程设计或商城类项目的基础框架。已有354人学习对于希望快速获取可运行商城模板并研究其中代码组织的学习者具有不错的参考价值。1. 为什么要读一套 JSP 实现的商城项目源码在 Spring Boot 和前后端分离已经变成默认配置的今天一套基于 Java 的 JSP 网上购物商城设计源码看起来像是上个时代的产物。但恰恰因为它的“旧”它把一次 HTTP 请求怎么进 Servlet、怎么在 Session 里保留购物车、怎么用 JDBC 做事务提交全部摊开在你面前。这套源码的常见形态是 JavaBean 做实体封装JSP 做页面渲染Servlet 做请求路由再配一张 MySQL 数据库。它适合两类人刚学完 Java 基础、准备把 Servlet/JSP 串成完整项目的学生以及需要快速交付一个轻量级商城原型、又不想引入重型框架的开发者。读这套源码的收获并不是“能跑”而是能复现一条完整业务链注册登录、商品列表、商品详情、加入购物车、生成订单、后台查看订单。源码里的 JSP 隐式对象、JSP 编译机制、Filter 过滤器、Session 状态保持恰好是 Java 面试中反复出现的高频考点。后面四章按照“架构、编码、部署、优化”的顺序把这条链路拆开讲清楚。2. JSP 商城源码的 MVC 分层与 JSP 编译机制2.1 Model 2 架构下 Servlet、JSP、JavaBean 各自负责什么JSP 商城项目最常见的架构是 Model 2也就是 MVC 的 Servlet 实现方式。Model 1 时代JSP 页面里混着请求处理和页面展示一个 list.jsp 既要查数据库又要写 HTML项目超过五个页面就难以维护。商城系统涉及用户权限、购物车状态、订单事务任何一步都要求请求流转可控所以必须把控制器单独抽出来。在这个分层里Servlet 是唯一的请求入口负责接收前端参数、校验数据、调用业务对象、决定 forward 还是 redirect。JSP 不再写 Java 脚本片段主要用 EL 表达式和 JSTL 标签把 request、session 里的数据渲染成 HTML。JavaBean 或 DAO 负责封装字段和数据库操作Service 类负责业务规则。这样分工之后改页面样式不会碰业务逻辑换数据库实现也不需要动 Servlet。有一点容易在源码阅读时忽略JSP 本质上是一个 Servlet但它并不是在请求到达时直接把页面内容返回给浏览器而是先由容器把 JSP 翻译成 Java 类再走一遍 Servlet 生命周期。理解这一点后面排查页面 500 错误、变量空指针时就不会一头雾水。2.2 web 项目配置 Tomcat 后JSP 编译出的 Java 类在哪看很多人在 IDEA 里写好 JSP点运行看到页面正常却不知道后台发生了什么。以 Tomcat 为例第一次访问某个 JSP 页面时org.apache.jasper.servlet.JspServlet会把 JSP 文件解析并编译成一个_jsp开头的 Java 类再继续编译成 class 文件。这个编译产物不是放在项目的 target 目录而是放在 Tomcat 的 work 目录下。假设项目上下文路径是shop对应目录就是${TOMCAT_HOME}/work/Catalina/localhost/shop/org/apache/jsp/打开这个目录能看到list_jsp.java、cart_jsp.java之类的文件。每个文件里都有一个_jspService(HttpServletRequest request, HttpServletResponse response)方法JSP 页面的所有隐式对象pageContext、request、session、application、out都从这个方法里取出来。这个位置对于调试特别有用当 JSP 里某个 EL 表达式没有按预期输出时查看生成的 Java 类能确认到底是数据没放进去还是 getter 方法名拼错了。还需要知道JSP 文件修改后Tomcat 在开发模式下会自动检测时间戳并重新编译但如果手动清理了 work 目录或改了 web.xml 里的配置就需要重启 Tomcat。在检索“web项目配置tomcat后查看jsp编译后的java类”时大部分人想找的就是这个目录路径和_jspService方法。2.3 商城源码的 JDBC 连接方式连接池为什么不显得多余商城源码里的数据库访问通常有两种写法。第一种是 DAO 里每次操作都DriverManager.getConnection(url, user, password)用完close()。这种写法代码最简单但高并发下频繁创建和销毁连接数据库很快会出现连接数打满。第二种是使用连接池在应用初始化时创建一定数量的连接请求时从池里取用完归还。连接方式获取连接典型代码适用阶段注意点DriverManagerClass.forName(driver); DriverManager.getConnection(url, user, pwd)学习、原型验证必须在 finally 中关闭 Connection、Statement、ResultSetDBCP2 / C3P0通过BasicDataSource或配置 XML 获得DataSource并发量不大的独立部署需要引入 commons-pool2 依赖并配置最大连接数容器数据源Tomcat JNDIDataSource查询部署到 Tomcat 时的规范做法在 context.xml 中配置与 Web 项目解耦连接池在三层架构里有另一个好处事务边界容易控制。Service 层从同一个连接池拿到Connection设置setAutoCommit(false)一系列 SQL 执行成功后commit()任何一个环节失败就rollback()。这也为后面下单扣库存的原子性打下了基础。3. 从建表到 ShoppingCart商城核心模块复现3.1 一个可落地的商城常规目录结构拿到 JSP 商城源码后第一件事不是点运行而是先看包结构。一个合理的目录约定是实体放 entity数据库操作放 dao业务逻辑放 service页面控制器放 web前端资源放在 web 根目录下。下面这个结构可以直接照搬shop/src/ ├── com/demo/entity/ │ ├── Customer.java │ ├── Product.java │ ├── Order.java │ └── OrderItem.java ├── com/demo/dao/ │ ├── BaseDao.java │ ├── CustomerDao.java │ ├── ProductDao.java │ └── OrderDao.java ├── com/demo/service/ │ ├── ProductService.java │ └── OrderService.java └── com/demo/web/ ├── LoginServlet.java ├── ProductListServlet.java ├── ProductDetailServlet.java └── CartServlet.java shop/web/ ├── WEB-INF/ │ ├── web.xml │ └── lib/ │ └── mysql-connector-java-8.0.33.jar ├── css/style.css ├── login.jsp ├── register.jsp ├── list.jsp ├── detail.jsp ├── cart.jsp └── checkout.jsp这里的核心是 entity 只存字段不写业务代码dao 只做 SQLservice 处理事务和业务校验web 层只处理请求参数和视图跳转。如果源码里所有 Java 类都在默认包下建议先做包重构否则后面加 Filter 或 Spring 时会出现类扫描不到的问题。3.2 商城五张核心表的建表 SQL 与约束设计网上商城的核心数据模型离不开用户、分类、商品、订单、订单项这几张表。注意不要用user作为用户表名因为在 MySQL 里user是保留字相关语义容易出现兼容性问题更安全的做法是命名customer。下面是常用的建表脚本CREATE DATABASE shop_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE shop_db; CREATE TABLE customer ( id INT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(128) NOT NULL, nickname VARCHAR(50) DEFAULT NULL, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB; CREATE TABLE category ( id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(50) NOT NULL ) ENGINEInnoDB; CREATE TABLE product ( id INT AUTO_INCREMENT PRIMARY KEY, category_id INT NOT NULL, name VARCHAR(100) NOT NULL, price DECIMAL(10,2) NOT NULL, stock INT NOT NULL DEFAULT 0, description TEXT, image_url VARCHAR(255), FOREIGN KEY (category_id) REFERENCES category(id) ) ENGINEInnoDB; CREATE TABLE orders ( id INT AUTO_INCREMENT PRIMARY KEY, customer_id INT NOT NULL, total_price DECIMAL(10,2) NOT NULL, status TINYINT NOT NULL DEFAULT 0, address VARCHAR(255) DEFAULT NULL, create_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (customer_id) REFERENCES customer(id) ) ENGINEInnoDB; CREATE TABLE order_item ( id INT AUTO_INCREMENT PRIMARY KEY, order_id INT NOT NULL, product_id INT NOT NULL, price DECIMAL(10,2) NOT NULL, quantity INT NOT NULL, FOREIGN KEY (order_id) REFERENCES orders(id), FOREIGN KEY (product_id) REFERENCES product(id) ) ENGINEInnoDB;金额字段全部用DECIMAL(10,2)不做float/double高并发场景下浮点误差会在订单统计上累积。订单和商品的关系通过order_item做多对多拆分每个订单项里冗余保存一份单价price因为商品价格后续可能调整历史订单需要保留下单时刻的价格。外键在示例里保留是为了让初学者通过SHOW CREATE TABLE看清关联关系实际大并发系统经常去掉外键把一致性交给应用层控制。3.3 在 JSP 商品列表页面中输出商品数据商品列表页是 JSP 商城源码里最能体现 EL 表达式和 JSTL 配合的页面。Servlet 查询完商品后通过request.setAttribute(productList, list)把数据放进请求域然后转发到list.jsp% page contentTypetext/html; charsetUTF-8 % % taglib prefixc urihttp://java.sun.com/jsp/jstl/core % !DOCTYPE html html head meta charsetUTF-8 title商品列表/title /head body h2商品列表/h2 table border1 cellpadding8 tr th商品ID/th th商品名/th th价格/th th库存/th th操作/th /tr c:forEach items${productList} varp tr td${p.id}/td tda hrefdetail?id${p.id}${p.name}/a/td td${p.price}/td td${p.stock}/td tda hrefcart?actionaddid${p.id}加入购物车/a/td /tr /c:forEach /table /body /html${productList}并不是直接从 Java 全局变量里取而是 JSP 容器按照 pageContext、request、session、application 的顺序查找属性名为productList的对象。c:forEach每次迭代把当前元素赋值给varp表达式${p.name}会调用Product类的getName()方法而不是直接访问字段。因此要求实体类必须写全 getter/setter字段名和属性名保持一致。注意操作链接里的detail和cart是相对路径。如果 JSP 页面被 Servlet 转发出来浏览器地址栏是/list当前路径就是/list所在的上下文但如果是直接访问 JSP 文件相对路径解析结果可能不同。最稳妥的写法是href${pageContext.request.contextPath}/detail?id${p.id}这样无论应用部署在根路径还是子路径下都能正确跳转。3.4 登录、购物车 Servlet 的请求入口与参数约定登录功能是商城源码里最经典的一个 Servlet。关键点有两个一是取参数之前必须设置编码二是密码校验成功后要在 Session 里保存用户对象而不是只存用户名。下面这段代码可以放在LoginServlet里package com.demo.web; import com.demo.dao.CustomerDao; import com.demo.entity.Customer; import javax.servlet.ServletException; import javax.servlet.annotation.WebServlet; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.io.IOException; WebServlet(/login) public class LoginServlet extends HttpServlet { private final CustomerDao customerDao new CustomerDao(); Override protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding(UTF-8); String username request.getParameter(username); String password request.getParameter(password); Customer customer customerDao.findByUsernameAndPassword(username, password); if (customer ! null) { request.getSession().setAttribute(loginUser, customer); response.sendRedirect(request.getContextPath() /list); } else { request.setAttribute(error, 用户名或密码错误); request.getRequestDispatcher(/login.jsp).forward(request, response); } } }代码里先设置request.setCharacterEncoding(UTF-8)再调用getParameter才能正确解析 POST 请求体里的中文。customerDao.findByUsernameAndPassword里面如果用的是字符串拼接 SQL会导致注入风险实际源码里应该使用PreparedStatement的占位符参数。登录成功后用重定向而不是 forward是为了避免用户刷新页面时重复提交表单。购物车 Servlet 通常用 Session 里的MapInteger, Integer保存“商品ID - 数量”不单独建购物车表WebServlet(/cart) public class CartServlet extends HttpServlet { Override protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { HttpSession session request.getSession(); MapInteger, Integer cart (MapInteger, Integer) session.getAttribute(cart); if (cart null) { cart new HashMap(); session.setAttribute(cart, cart); } String action request.getParameter(action); if (add.equals(action)) { int productId Integer.parseInt(request.getParameter(id)); cart.merge(productId, 1, Integer::sum); } else if (clear.equals(action)) { cart.clear(); } response.sendRedirect(request.getContextPath() /cart.jsp); } }cart.merge(productId, 1, Integer::sum)是 JDK 8 的写法如果商品已存在则数量加 1不存在则放入数量 1。用 Session 保存购物车的好处是服务端不需要建表、不需要处理游客用户 ID缺点是用户关闭浏览器或 Session 过期后购物车丢失这对学习项目是可接受的。4. 商城源码部署到 Tomcat 的配置与三个高频坑4.1 商城项目打成 War 包还是直接把 JSP 源码放 webapps拿到源码后的部署有两种常见路径。第一种是开发环境里直接用 IDEA 或 Eclipse 配置 Tomcat把 web 目录作为 Web 根目录启动第二种是把项目打包成 War 包复制到 Tomcat 的webapps目录下启动。推荐第二种因为 War 包里包含了WEB-INF/classes、WEB-INF/lib部署行为更接近正式环境。在项目根目录执行下面的打包命令jar -cvf shop.war -C web .这个命令把web目录下所有文件打进shop.war其中WEB-INF/classes下的.class文件和WEB-INF/lib下的 jar 会被 Tomcat 自动识别。Tomcat 启动时会自动解压 War 包生成shop目录作为上下文路径然后访问地址就是http://localhost:8080/shop/。需要注意如果你改的是 Java 源码必须重新编译并重启 Tomcat如果只改了 JSPTomcat 开发模式能自动感知并重新编译。判断当前模式看conf/web.xml中JspServlet的development参数是否为true。避免线上环境也开着自动编译减少安全风险。4.2 商城应用的 JDBC 驱动 jar 与连接参数数据库驱动 jar 的摆放位置直接影响类加载结果。放在webapps/shop/WEB-INF/lib/下只对当前商城应用可见升级驱动不会影响其他项目放在 Tomcatlib/目录下所有 webapp 共享。建议先放 Web 应用内部避免依赖混乱。MySQL 8 和旧版驱动的连接写法差异比较大常见的db.properties是这样jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/shop_db?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8 jdbc.usernameroot jdbc.password123456驱动类必须写com.mysql.cj.jdbc.Driver如果写成com.mysql.jdbc.Driver运行时虽然有时能自动桥接但会打印弃用警告。URL 里的serverTimezone不设置MySQL 8 默认返回的日期时间类型会因时区不匹配报错。characterEncodingutf8要放在连接参数里和页面 JSP 声明的UTF-8形成前后端一致编码链。在 Java 代码里通过Class.forName(jdbc.driver)加载驱动后每次DriverManager.getConnection都会新建连接。如果源码提供了BaseDao抽象把获取连接、关闭 Statement 和 ResultSet 的模板方法放在 BaseDao 里可以让每个 DAO 少写大量重复代码。4.3 商城部署中的编码、Session 超时和 JSP 路径坑部署完成后最容易遇到的是中文乱码。乱码往往不是单一环节造成的页面、请求、数据库连接、响应头四处都要统一。JSP 页面除了contentTypetext/html; charsetUTF-8还要确认页面文件本身以 UTF-8 保存request.setCharacterEncoding只对 POST 参数有效GET 查询串的编码取决于 Tomcat 的 URIEncoding 配置在server.xml的Connector上加上URIEncodingUTF-8能一次解决。第二个高频坑是 Session 超时。Tomcat 默认 30 分钟如果用户把商品加到购物车后超过 30 分钟才结算Session 里的cart已经失效再次访问时会新建一个空 Map。调整方式是在web.xml里增加session-config session-timeout60/session-timeout /session-config这里单位是分钟。但需要注意Session 超时时间设置得太长也会带来服务端内存压力尤其是用户量上来以后。第三个坑是重定向路径漏掉项目上下文名。比如在 Servlet 里写response.sendRedirect(/list)当项目部署在http://localhost:8080/shop/时浏览器会被重定向到http://localhost:8080/list直接 404。正确写法是用request.getContextPath()拼接上下文路径response.sendRedirect(request.getContextPath() /list);源码里如果大量使用这种裸路径建议全局搜索sendRedirect(和href统一替换成带pageContext.request.contextPath的写法。这也是把 JSP 商城项目从单机开发迁移到子路径部署时最耗时的改造点。5. 商城源码上线的三个优化技巧5.1 用 Filter 统一做商城页面的编码与登录校验上面的编码问题可以在每个 Servlet 里各自处理但更好的做法是抽一个CharacterEncodingFilter拦截所有请求WebFilter(/*) public class EncodingFilter implements Filter { private String encoding UTF-8; Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest req (HttpServletRequest) request; HttpServletResponse resp (HttpServletResponse) response; req.setCharacterEncoding(encoding); resp.setCharacterEncoding(encoding); chain.doFilter(request, response); } }这个 Filter 的WebFilter(/*)表示拦截所有路径包括 JSP、Servlet 和静态资源。设置编码之后调用chain.doFilter继续放行。如果你要额外做登录校验可以在doFilter里判断请求路径如果是/cart、/checkout等需要登录的地址且 Session 里没有loginUser就重定向到登录页。这样业务 Servlet 里就不用重复写登录判断了。5.2 商城下单事务与分页查询的复用写法下单操作必须保证 orders 表写入、order_item 表写入、商品库存扣减这三个动作要么全部成功要么全部失败。把这三个操作放进同一个数据库事务里是 JSP 商城源码里最重要的进阶改进Connection conn dataSource.getConnection(); try { conn.setAutoCommit(false); orderDao.insertOrder(conn, order); orderDao.insertOrderItems(conn, orderId, cartItems); productDao.decreaseStock(conn, productId, quantity); conn.commit(); } catch (SQLException e) { conn.rollback(); throw new RuntimeException(下单失败, e); } finally { conn.setAutoCommit(true); conn.close(); }这里所有 DAO 方法都接收Connection参数而不是自己从 DriverManager 获取连接这样才能保证大家用的是同一个数据库连接。如果 Product 表库存为 0在decreaseStock里先执行UPDATE product SET stock stock - ? WHERE id ? AND stock ?再通过int rows statement.executeUpdate()判断返回行数是否为 0就能避免库存被扣成负数。分页查询也要抽成公共方法。一个通用做法是写PageBeanT保存当前页、每页条数、总记录数和当前页数据列表然后在 DAO 里封装两个方法public ListProduct findPage(int pageNum, int pageSize) { String sql SELECT * FROM product ORDER BY id DESC LIMIT ?,?; int offset (pageNum - 1) * pageSize; // PreparedStatement 设置参数 offset 和 pageSize } public int count() { String sql SELECT COUNT(*) FROM product; // 返回总记录数 }计算偏移量时用(pageNum - 1) * pageSize因为数据库的LIMIT是从 0 开始计数。前端传来的 pageNum 必须做一次Math.max(1, pageNum)防护避免负数和零值导致 SQL 异常。提示把分页参数封装到统一的PageBean之后商品列表、订单列表、后台用户列表都可以复用同一套模板不要再让每个 Servlet 各自计算起始行号。底层 SQL 里的 LIMIT 参数要绑定整数类型不要把前端字符串拼进语句里避免 SQL 注入。本文还有配套的精品资源点击获取