SpringBoot 购物推荐网站的设计与实现:120 个 Java 文件、147 个接口、13 张表,附真实运行截图

SpringBoot 购物推荐网站的设计与实现:120 个 Java 文件、147 个接口、13 张表,附真实运行截图

这是一套电商购物推荐系统:管理员在后台维护商品、分类、订单和用户,用户在前台浏览商品、加购物车、下单、充值、评价,首页按点击量自动推荐热门商品。本文把包里有什么、两类账号怎么分工、13 张表怎么组织、一条「看商品到下单评价」的链路怎么走、本地怎么跑起来,一条条讲清楚,附全部真实运行截图。

目录


一、项目概览:这套系统是什么

一句话定性:单体、前后端不分离的电商购物推荐系统 。前台是 layui 静态 HTML,后台是 Vue 2 + ElementUI 的编译产物,两套前端和后端代码在同一个 Maven 工程里,一个 java -jar 就能全部跑起来。

它做的事是:把「商品、分类、购物车、订单、评价、排行榜」搬到线上。管理员在后台录商品、定价格、维护分类和轮播图;用户在网页上浏览商品详情、加入购物车、选收货地址下单、给商品写评价、给自己的账户余额充值。首页还有一个「推荐」区,按商品最近点击时间倒序排------点得多的自然往前排。

规模数字

每个数字都是从源码统计出来的,命令写在最后一列,可以自己复现:

指标 数值 怎么数
Java 文件 120 个 `find src -name '*.java' \
Java 代码行数 11068 行 同上加 -exec cat {} + 后 wc -l
Controller 14 个 `find src -name '*Controller.java' \
REST 端点 147 个 数方法级 @RequestMapping/@GetMapping/...,类上的 @RequestMapping 只是路径前缀,不算端点
HTML 39 个 `find src -name '*.html' \
Mapper XML 14 个 ls src/main/resources/mapper/
数据库表 13 张 数 db.sql 里的 CREATE TABLE
演示数据 55 行 数 insert into 后面的元组,不是数语句条数

工程分层

com 包下按标准三层分:controller 14 个(一个业务表一个)、service 28 个(14 个接口 + 14 个实现)、dao 14 个 MyBatis-Plus Mapper、entity 44 个(14 个主实体 + model/view/vo 各 10 个变体)、interceptor 一个 token 校验拦截器、annotation 三个(@IgnoreAuth 标在免登录接口上)、utils 十三个(R 统一返回、PageUtils 分页、MPUtil 条件构造、MD5Util)。

资源目录里有两套前端:前台 layui 静态站 src/main/resources/front/front/(15 个页面目录,购物相关的 pages/shop-xxx/ 一个环节一个目录)、后台 Vue 打包产物 src/main/resources/admin/admin/dist/(登录后走 #/模块名),外加 14 个 Mapper XML。

有一处容易踩:目录是双层 的(front/front、admin/admin/dist),但 application.yml 里 static-locations 只写了 classpath:static/,file:static/,前台能打开靠的是 Spring Boot 对 classpath:/ 的默认兜底。所以写 URL 时只写一层:/front/index.html、/admin/dist/index.html。

系统结构图:浏览器 → 静态页 → Controller → Service → MyBatis-Plus → MySQL,两侧是前台 layui 与后台 Vue 两套前端

二、功能模块:管理员和用户分别能干什么

这套系统的用户体系是两套账号表,不是一个用户表加角色字段:

表 谁在用 登录后能做什么
users 管理员 后台全部业务菜单:商品信息、商品类型、订单、评价、排行榜、用户、资讯、轮播图
yonghu 普通用户 前台注册登录,看商品和详情、加购物车、下单、收货地址、充值、收藏、评价

两套表用一张 token 表区分:登录成功时把 tablename(users 或 yonghu)和 role 一起写进 token 记录,之后的请求靠这个字段判断身份。答辩老师很爱问「你怎么区分管理员和普通用户」,答案就在 token 表的 tablename 字段上。

前台能做什么

前台按业务表分页面,顶部导航是「商品信息、商品类型、购物资讯」加上右侧的个人中心、后台管理入口。核心的一组是 pages/shop- 开头的五个页面------购物车、订单、收货地址、充值,加一个商品详情页。

前台首页:顶部是轮播图,下方是按点击量排出来的推荐商品区

商品信息列表:左侧按商品类型筛选,右侧商品卡片带图片、价格和名称

商品销售排行榜:按月销售量排的热门商品位

我的订单:登录后能看到自己的订单记录,带订单号、金额和状态

后台能做什么

后台是 Vue + ElementUI,左侧菜单跟业务表一一对应(token 不单独给菜单)。每张表都是同一套页面:列表带搜索条件和分页、新增、编辑、删除、详情。

后台首页:左侧菜单一项对应一张业务表,右侧是统计和快捷入口

商品信息管理:每行一个商品,操作列有详情、修改、删除、查看评论

订单管理:订单号、商品、数量、金额、收货人、状态一览

商品评价管理:评价内容、昵称和商家回复都在这一张表里

14 个 Controller 对应哪些模块

Controller 业务含义
ShangpinxinxiController 商品信息(编号、名称、类型、图片、详情、价格、最近点击时间)
ShangpinleixingController 商品类型字典(服饰、家电等分类)
ShangpinxiaoshoupaixingbangController 商品销售排行榜(月销售量)
OrdersController 订单(订单号、数量、金额、支付类型、状态、地址、电话、收货人)
CartController 购物车(商品表名、用户 id、商品 id、数量、单价、折扣价)
AddressController 收货地址(地址、姓名、电话、是否默认)
DiscussshangpinxinxiController 商品评价(关联 id、昵称、内容、商家回复)
NewsController 购物资讯(标题、简介、图片、正文)
StoreupController 收藏夹(用户 id、关联 id、表名、名称、图片)
YonghuController / UserController 普通用户 / 管理员两套账号
ConfigController 轮播图与站点配置
CommonController / FileController 通用能力(下拉选项、统计、跨表查询、图片上传下载)

三、数据库设计:13 张表怎么组织

db.sql 13 张表、0 条外键。生成器写表不写外键约束,表与表的关系全在字段语义里,所以画 ER 图要按字段名去对,不能指望数据库自己告诉你。

分六组看:

分组 表 干什么
用户与鉴权 users、token、yonghu 管理员、登录凭证、普通用户
商品与分类 shangpinxinxi、shangpinleixing 商品本体 + 类型字典
交易与订单 cart、orders、address 购物车、订单、收货地址
评价与排行 discussshangpinxinxi、shangpinxiaoshoupaixingbang 商品评价、销售排行榜
内容与收藏 news、storeup 购物资讯、收藏夹
系统配置 config 轮播图和站点参数

几张关键表长什么样

shangpinxinxi(商品信息,9 列):商品编号、商品名称、商品类型、图片、商品详情(长文本)、价格,加上一个 clicktime(最近点击时间)。这个 clicktime 是首页推荐区的排序依据。

orders(订单,18 列)是这套系统最宽的一张表:订单编号、商品表名、用户 id、商品 id、商品名称、图片、购买数量、价格、折扣价格、总价、折扣总价、支付类型、状态,加上收货地址、电话、收货人。订单编号有唯一索引,支付类型和状态用中文存(未支付 / 已支付)。

cart(购物车,10 列):商品表名、用户 id、商品 id、商品名称、图片、购买数量、单价、折扣价。tablename 这一列是关键------它记的是「这个购物车条目属于哪张商品表」,所以同一套购物车代码换个业务表还能用。

两类身份靠 token.tablename 串成一套登录体系

商品挂在分类字典下,商品编号有唯一索引

购物车、订单、收货地址三张表都带用户 id,靠字段语义关联,没有外键

评价表带关联 id 指回商品,排行榜是商品信息的统计视图

演示数据分布

db.sql 里 12 条 insert into 语句,展开成 55 行数据,分布在 12 张表:

表 行数 表 行数
address 7 yonghu 7
discussshangpinxinxi 7 news 6
shangpinleixing 6 shangpinxinxi 6
shangpinxiaoshoupaixingbang 6 config 4
orders 2 token 2
users 1 storeup 1

导入脚本就有数据,不用自己造。唯一空表是 cart------购物车要用户自己加过商品才有记录,截图里看到购物车是空的不用担心,那是正常的。

四、核心业务走读:从逛商品到下单评价

这条链路是这套系统的全部价值,讲清楚它,论文的「详细设计」就有一节能写了。

第一步:首页推荐商品

首页调 shangpinxinxi/autoSort,这个接口在方法里写死了排序:

复制代码
params.put("sort", "clicktime");
params.put("order", "desc");
PageUtils page = shangpinxinxiService.queryPage(params, MPUtil.sort(MPUtil.between(MPUtil.likeOrEq(ew, shangpinxinxi), params), params));

也就是说,推荐区不是个性化算法,就是按最近点击时间倒序------被点得多的自然往前排。想改成别的规则,改这两行就行。

第二步:浏览商品详情,加入购物车

点进商品详情页,「加入购物车」的按钮先查一次购物车,确认这个商品没加过,再写一条:

复制代码
// 添加到购物车
addCartTap() {
	// 活动倒计时限制
	// 查询是否已经添加到购物车
	layui.http.request('cart/list', 'get', {
		userid: localStorage.getItem('userid'),
		tablename: `${this.detailTable}`,
		goodid: this.detail.id
	}, (res) => {
		if (res.data.list.length > 0) {
			layer.msg("该商品已经添加到购物车", {
				time: 2000,
				icon: 5
			});
			return
		}
		layui.http.requestJson('cart/save', 'post', {
			tablename: `${this.detailTable}`,
			goodid: this.detail.id,
			goodname: this.title,
			picture: this.swiperList[0],
			buynumber: this.buynumber,
			userid: localStorage.getItem('userid'),
			price: this.detail.price,
			discountprice: this.detail.vipprice ? this.detail.vipprice : 0
		}, (res) => {

加进去的这条记录,把商品 id、名称、图片、单价、数量都冗余存了一份在购物车里------下单时不用再回商品表查。

第三步:结算页下单

结算页(shop-order/confirm.html)是这条链路的核心。金额在前端算 ,然后整条订单对象 POST 给后端。订单对象里的 price、total、discounttotal 都是浏览器里乘出来的,status 直接写死中文 未支付,address/tel/consignee 来自选中的收货地址,最后一句 layui.http.requestJson('orders/add', 'post', order, ...) 把整条记录发出去。

total 和 discounttotal 都是前端乘出来的,后端 orders/add 直接收下存库------这是这套系统的技术债之一,改价逻辑在前端,答辩时值得主动提一句「改进方案是把金额计算挪到后端,用订单明细重新算一遍」。

第四步:扣余额、改订单状态、清购物车

订单插进去之后,结算页接着做三件事:查余额够不够,不够就提示「余额不足,请先充值」并中止;够就把 user.money 减掉,POST 回 yonghu/update 存库;把订单状态从 未支付 改成 已支付,再 POST orders/update,最后把购物车里那条 cart/delete 掉。

所以余额扣减和订单状态更新是两次独立请求 ,不是一次事务。中间哪一步断了,订单和余额就对不上------这也是可以写进「论文展望」的一条:把「创建订单 + 扣库存 + 扣余额 + 清购物车」包进一个 @Transactional。

第五步:充值和评价

余额不够就去「充值」页填金额,前端直接把 user.money 加上再 POST 回去。评价在商品详情页底部,提交到 discussshangpinxinxi/save,字段是昵称、内容、关联 id,商家可以在后台「商品评价管理」里回复。

完整链路

首页 shangpinxinxi/autoSort → 商品详情页 shangpinxinxi/detail.html → cart/save 加购 → orders/add 建单 → yonghu/update 扣余额 → orders/update 改状态 → cart/delete 清车 → discussshangpinxinxi/save 写评价 → 后台 discussshangpinxinxi/update 商家回复。

两段值得贴进论文的代码

第一段:一行代码把筛选、区间、排序全接住。 上面第一步那段 MPUtil.sort(MPUtil.between(MPUtil.likeOrEq(...))) 就是它的完整写法。三个工具方法各干一件事:likeOrEq 把实体里的非空字段变成条件(值里带 % 走 LIKE,否则走 =,所以搜索框留空不会查出全表);between 把 xxx_start/xxx_end 翻成区间条件;sort 把 sort/order 翻成 ORDER BY。前端加个筛选框,后端一行都不用改。

第二段:登录取 token。 两类身份共用一个签发方法 generateToken(userid, username, tableName, role),在 TokenServiceImpl 里:先按 userid + role 查有没有旧 token,有就换新值并把过期时间续 1 小时,没有就新插一行;token 是 32 位随机串,存在 token 表。

拦截器 AuthorizationInterceptor 拿请求头里的 Token 查这张表,查到就把 userId/role/tableName/username 塞进 session,后面 Controller 全靠 session 取值;查不到直接返回「请先登录」。标了 @IgnoreAuth 的接口不校验,所以没登录也能浏览商品和资讯。

五、本地跑起来:六步到浏览器

环境

  • JDK 8(pom.xml 里 <java.version> 写的就是 1.8)
  • Maven 3.6+
  • MySQL 5.7 或 8.0
  • 不需要 Redis、不需要消息队列、不需要 Node(前台是静态页,后台是打好的 dist)

六步

  1. 建库:CREATE DATABASE springboot707pd DEFAULT CHARACTER SET utf8;
  2. 导入数据:mysql -uroot -p 你的密码 < db.sql
  3. 改连接:src/main/resources/application.yml 里的 username / password 换成你自己的
  4. 打包:mvn clean package -DskipTests
  5. 启动:java -jar target/springboot707pd-0.0.1-SNAPSHOT.jar
  6. 打开 http://localhost:8080/springboot707pd/front/index.html,后台是 http://localhost:8080/springboot707pd/admin/dist/index.html

默认账号写在源码包的 说明文档.txt 和 db.sql 种子数据里,前后台各一套。

配置长什么样

application.yml 里最关键的是三处:server.port(8080)、server.servlet.context-path(/springboot707pd)、spring.datasource.url/username/password(指自己的 MySQL)。

context-path 决定了所有地址前面那个 /springboot707pd,改它要一起改三个地方:application.yml、front/front/js/config.js(1 处)、front/front/modules/http/http.js(2 处)。只改 yml 会出现「后台能开、前台一片白」------前台调接口的地址还指着旧路径。

三个常见报错

Access denied for user 'root'@'localhost':yml 里的密码不是你的 MySQL 密码,改 yml。

前台一片白、控制台一堆 404 :先看上面那三个改路径的地方改全了没,再看 config.js 里的接口端口是不是 8080。

说明文档.txt 打开是乱码:这是 GBK 编码的文本,用 VSCode 打开会提示编码,选 GB18030 就正常了。

六、答辩与使用提醒

一、账号写在说明文档和 db.sql 里,公开页面不写。 两类账号的口令都在源码包的 说明文档.txt 和 db.sql 种子数据里,跟着资料一起交付。演示前把默认口令改掉,别原样挂着。

二、上传的图片存在运行目录下的 upload 文件夹。 FileController 把图片写到 classpath:static 解析出来的绝对路径 /upload/ 里。重新 mvn clean package 之后,之前传的图片会跟着旧包一起没了。答辩前重新打过包,记得把演示用的商品图重传一遍。想彻底解决,把上传目录指到工程外的绝对路径,或者写进论文改进方向(换成对象存储)。

三、密码是明文存的,这一点可以主动讲。 两张账号表的 mima/password 字段直接存原文,工程里有 MD5Util 这个工具类,但登录流程并没有调用它(注册时是直接 user.setMima(...) 这样的明文赋值)。答辩老师问到安全性,别硬撑,直接答「当前是明文,改进方案是换 BCrypt 加盐哈希」,再补一句「登录已经用 token + 拦截器做了会话校验」,比被问住强。

四、金额在前端算,这是最值得改进的一处。 结算页把 total = price * buynumber 在浏览器里乘出来再 POST 给后端存库,后端不重算。答辩老师问「怎么保证价格不被篡改」,答「当前是前端算的,改进方案是后端按订单明细重新算一遍并以服务端为准」,比被问住强。这条也可以直接写进论文的「系统不足与改进」一节。

五、pom.xml 里有一项要注意。 依赖里引了 shiro-spring 这个包,但整个 src/main/java 里搜不到任何一行 Shiro 的引用,实际鉴权是自写的 AuthorizationInterceptor 做的。答辩被问「用的什么权限框架」,如实答「用 Spring 拦截器自己实现的 token 校验,Shiro 那个依赖是模板带过来的没实际用到」。

六、推荐区是「按点击量排序」,不是算法推荐。 首页推荐调的是 shangpinxinxi/autoSort,方法里写死了 sort=clicktime、order=desc。如果你的论文标题里写了「推荐算法」,答辩时注意别把它说成协同过滤------它是按点击时间倒序的简单排序。想真做推荐,可以把 clicktime 换成点击次数累加,或者引入协同过滤,那是一个能写进展望的改进点。

七、这套适合什么样的同学

适合你,如果:

  • 选题是「电商购物」「商品推荐」「在线商城」这类,需要「浏览 → 加购 → 下单 → 评价 → 排行榜」完整闭环的底子;
  • 想要 java -jar 就能演示、不用装中间件,且导入即有 55 行演示数据(13 张表,商品、订单、评价、地址都有内容);
  • 需要论文里的功能模块和代码一一对上:14 个 Controller、13 张表,铺满「系统设计」和「详细设计」两章没问题。

可能不太合适,如果:

  • 学校要求前后端分离、前端独立 Vue/React 工程(这套前台是 layui 静态页,后台是编译好的 dist);
  • 选题必须是移动端或小程序(这套只有 Web 端);
  • 需要真实的第三方支付、优惠券、退款、发票这类流程(这套的「支付」是扣自己账户余额,没有对接支付网关)。

想在这套上面加东西,三个自然的方向:把结算金额挪到后端重算并加上事务;把「按点击量排序」升级成真正的推荐(比如同类目协同过滤);给商品加库存字段,下单时扣库存并加悲观锁防超卖。这三条都能直接写进论文的「未来展望」。


本文基于 springboot01-062 源码逐文件分析,代码片段均为原文摘录,统计数字可复现,截图来自真实运行环境。

相关推荐
文丑颜不良啊17 分钟前
LeetCode3041~3060题目解析
java·leetcode
文丑颜不良啊2 小时前
LeetCode3101~3120题目解析
java·leetcode
Resean02232 小时前
SpringMVC 6+源码分析(十一)视图渲染与异步请求(收尾篇)
java·spring·springmvc
靠沿2 小时前
MySQL数据库进阶——存储过程和触发器
java·数据库·mysql
码少女3 小时前
MySQL--库与表的增删改查基础
java·数据库·mysql
隔窗听雨眠4 小时前
Spring Boot启动提速的机制剖析与调优路径
性能优化·springboot·后端开发
Flynt5 小时前
掘金热文说 Spring Boot 4.1 默认开虚拟线程,我实测后发现了更狠的坑
java·spring boot·性能优化
Resean02236 小时前
Spring 源码分析(一)IOC 容器总览与 refresh() 全景
java·后端·spring
保利威视频SaaS小张6 小时前
企业直播接入笔记 12|企业内训直播怎么做签到和学时统计,防挂机这件事比想象中难
java·前端·数据库·笔记·视频云·polvy·polyv