网上商城
截图展示
声明
- 未经许可不得将本项目商用,如需商用请联系作者zxr@tju.edu.cn
- 欢迎各位看官向本项目提交代码,对提交的分支我将进行合并。提交时请务必保证能编译能运行
关键技术
基于SpringCloud框架开发的商城系统,代码严格遵循MVC分层**,可部署到服务器上,设计精良,不断完善
包结构说明
- com.supermarket.*.filter对应于微服务的过滤器
- com.supermarket.*.listener对应于微服务的监听器
- com.supermarket.*.controller对应于微服务的controller层
- com.supermarket.*.aspect对应于微服务的切面类
- com.supermarket.*.service对应于微服务的service层
- com.supermarket.*.dao对应于微服务的持久层
- com.supermarket.*.schedule对应于微服务的定时任务
- com.supermarket.*.exception对应于微服务的自定义异常
- com.supermarket.*.domain对应于微服务的JavaBean
- com.supermarket.*.utils对应于微服务的工具类
- com.supermarket.*.vo对应于微服务的ViewObject
系统架构
功能说明
用户微服务(com.supermarket.user)
- 用户登录
- 免验证码登录
- 用户注册
- 用户登出
- 用户名可用性校验
- 用户登录状态获取
- 查询用户权限等级
商品微服务(com.supermarket.product)
- 分页查询
- 单个商品查询
- 商品新增
- 商品修改
- 查询全部商品
公共资源微服务(com.supermarket.common)
- 公共资源微服务同时也是SpringCloud的Eureka模块
- 提供了常用的JavaBean, ViewObject, 工具类
zuul网关(com.supermarket.gateway)
- SpringCloud的zuul网关模块
- 对敏感API调用进行后端鉴权
图片微服务(com.supermarket.image)
- 图片上传功能
- 生成验证码功能
- 清除验证码在redis中的缓存
购物车微服务(com.supermarket.cart)
- 购物车查询
- 购物车新增商品
- 购物车删除商品
- 购物车修改商品
- 购物车价格查询
订单微服务(com.supermarket.order)
- 新增订单
- 删除订单
- 查询订单
检索微服务(com.supermarket.search)
- 分页检索
- 新增商品
- 删除商品
- 建立索引
秒杀微服务(com.supermarket.instantbuy)
- 全部秒杀商品查询
- 单个秒杀商品查询
- 发起秒杀
新版本部署教程
- 环境准备
- 开发环境准备:首先你需要有一台电脑、以及一个虚拟机(或服务器)。内存要大,不然跑不起来。假设你的虚拟机的ip地址是192.168.137.147在你的电脑中把hosts追加两行。
192.168.137.147 www.supermarket.com
192.168.137.147 image.supermarket.com
然后添加环境变量
DOCKER_HOST=tcp://192.168.137.147:2375
- 部署环境准备:虚拟机装上centos7,再装上docker,然后依次拉取镜像
docker pull zongxr/redis:3.2.11
docker pull zongxr/mycat:1.15.1
docker pull zongxr/mysql:5.7.37
docker pull zongxr/elasticsearch:6.8.6
docker pull zongxr/supermarket-cart:1.0-SNAPSHOT
docker pull zongxr/supermarket-user:1.0-SNAPSHOT
docker pull zongxr/supermarket-gateway:1.0-SNAPSHOT
docker pull zongxr/supermarket-eureka:1.0-SNAPSHOT
docker pull zongxr/supermarket-image:1.0-SNAPSHOT
docker pull zongxr/supermarket-search:1.0-SNAPSHOT
docker pull zongxr/supermarket-instantbuy:1.0-SNAPSHOT
docker pull zongxr/supermarket-product:1.0-SNAPSHOT
docker pull zongxr/supermarket-order:1.0-SNAPSHOT
然后把start_up目录拷贝到/home目录下
- 开发环境准备:首先你需要有一台电脑、以及一个虚拟机(或服务器)。内存要大,不然跑不起来。假设你的虚拟机的ip地址是192.168.137.147在你的电脑中把hosts追加两行。
- 部署数据库
- 参照数据库启动脚本逐行执行,或直接运行该脚本。
- 由于官方的mysql镜像没有默认开启主从配置,也没设定UTF-8字符集,因此使用本项目专有镜像zongxr/mysql:5.7.37,可自动开启bin-log,并设定UTF-8字符集
- 该脚本制作了双向主从高可用的数据分片,节点分别为dn1_host1, dn1_host2, dn2_host1, dn2_host2。并且通过mycat实现了读写分离以及分库分表,最后灌入数据。如果上一步执行成功了,你将能够通过以下的JDBC连接上数据库
jdbc:mysql://192.168.137.147:3306/supermarket
连接dn1_host1
jdbc:mysql://192.168.137.147:3307/supermarket
连接dn1_host2
jdbc:mysql://192.168.137.147:3308/supermarket
连接dn2_host1
jdbc:mysql://192.168.137.147:3309/supermarket
连接dn2_host2
jdbc:mysql://192.168.137.147:8066/supermarket
连接mycat
- 部署redis集群
- 参照redis启动脚本逐行执行,或者直接运行该脚本
- 该脚本搭建了一个6节点的redis集群,从redis-1到redis-6。由于3.2.11版本的redis官方镜像没有预置ruby环境,而创建集群需要使用ruby环境。因此使用该项目的专用redis镜像zongxr/redis:3.2.11,该镜像已经集成了ruby环境可直接使用。
- 如果上一步redis集群部署成功了,那么可以通过6379端口连接该集群
- 部署elasticsearch集群
- 参照elasticsearch启动脚本逐行执行,或直接运行该脚本
- 该脚本搭建了3节点的elasticsearch集群,分别是es-1, es-2, es-3。如果部署成功了,可以使用head插件连接http://192.168.137.147:9200/地址,集群状态应为green
- 官方默认的elasticsearch镜像不带JDBC连接功能,该项目通过技术手段集成了JDBC连接功能,可以像操作关系型数据库一样写SQL去操作elasticsearch。使用的driver是
org.elasticsearch.xpack.sql.jdbc.EsDriver
jdbc:es://192.168.137.147:9201
连接es-1
jdbc:es://192.168.137.147:9202
连接es-2
jdbc:es://192.168.137.147:9200
连接es-3
- 部署微服务
- 参照微服务启动脚本逐行执行,或直接运行该脚本
- 每个微服务做了一个镜像,名为zongxr/supermarket-xxx:tag。如果所有微服务都启动成功了,那么将能够在注册中心看到所有注册的微服务,并且在http://192.168.137.147:APP_PORT/swagger-ui/网址能够看到该微服务对应的接口文档
- instant-buy微服务用到了消息队列rabbitmq。如果消息队列启动成功,将能够在Web UI管理界面看到传输的消息,用户名密码均为guest
- 至此,所有服务都已经启动完成了。访问www.supermarket.com进行访问即可。
旧版本部署教程
点击链接加入群聊【Supermarket项目交流群】: 交流群https://jq.qq.com/?_wv=1027&k=wlpUy5jo
![交流群二维码](https://raw.githubusercontent.com/GoogleLLP/SuperMarket/master/./img/交流群.png)
版本迭代
版本号 | 更新内容 | 上传时间 |
---|---|---|
0.1 |
|
2020年8月3日 |
0.1.1 |
|
2020年8月7日 |
0.1.2 |
|
2020年8月9日 |
0.2 |
|
2020年8月20日 |
0.2.1 |
|
2020年8月22日 |
0.2.2 |
|
2020年8月24日 |
0.2.3 |
|
2020年8月25日 |
0.3 |
|
2020年9月25日 |
0.3.1 |
|
2020年9月29日 |
0.3.2 |
|
2020年10月1日 |
0.4 |
|
2020年11月10日 |
0.4.1 |
|
2020年11月12日 |
0.4.2 |
|
2020年11月13日 |
0.4.3 |
|
2020年11月14日 |
0.4.4 |
|
2020年11月15日 |
0.4.5 |
|
2020年11月18日 |
0.4.6 |
|
2020年11月19日 |
0.4.7 |
|
2020年11月24日 |
0.4.8 |
|
2020年11月30日 |
0.4.9 |
|
2020年12月6日 |
0.5 |
|
2020年12月9日 |
0.5.1 |
|
2020年12月10日 |
0.5.2 |
|
2020年12月11日 |
0.5.3 |
|
2020年12月12日 |
1.0.0 |
|
2022年3月26日 |
1.0.1.0 |
|
2022年4月1日 |
1.0.2.0 |
|
2022年4月1日 |
1.0.3.0 |
|
2022年4月4日 |
1.0.4.0 |
|
2022年4月5日 |
配置情况
- JDK版本:OpenJDK11
- nginx:1.19.1
- maven: 3.6.3
- MySql: 5.7.37
- Redis: 3.2.11
- MyCat: 1.5.1
- ElasticSearch: 6.8.6
- IK分词器: 6.8.6
- RabbitMQ: 3.7.7
- 开发环境:IntelliJ Idea 2020.1.4
- 框架:Springboot 2.2.5.RELEASE, SpringCloud Hoxton.SR3
-
hosts配置:
192.168.137.147 www.supermarket.com
192.168.137.147 image.supermarket.com
遇到的bug锦集(作为记录,博君一笑)
- HttpServletRequest的装饰者类HttpServletRequestDecorator中的getParameterMap重写方法中,不能在原地进行参数字符集修改,否则如果调用两次及以上该方法时会编码多次,造成乱码
- 对请求参数的拦截处理,如果用到装饰者模式,最好在一处完成。如果在多处完成会造成请求参数的重复处理,从而导致乱码或者拿到非预期的参数值
- 用户的登录信息最好保存到session域中,在0.2.1中的自动登录成功后误把user对象塞入到了request域,造成了重启服务器自动登录失效的bug。
- 使用过滤器将密码加密,不仅要将参数为password的值加密,还要将参数为password2的值加密,否则永远确认密码不一致
- 使用SpringMVC处理请求参数,如果自动封bean作为方法参数传入,那么该bean所携带的请求参数是不经过过滤器的!原因未知
- 自动登录最好使用过滤器实现,因为SpringMVC拦截器无法拦截index.jsp。而因为使用过滤器的时候Spring容器还未初始化,所以过滤器的属性需要手工注入
- 即便上一次响应设置了cookie的path,下一次请求携带的cookie的path也会是null。因此如果要修改或删除cookie,一定要严格满足name, path都设置,否则可能会无效
- 如果间接依赖了spring-cloud-starter-netflix-eureka-server,一定要把jackson-dataformat-xml排除掉,因为如果不排除掉会导致返回给浏览器的对象是xml格式而非json格式
- MyBatis如果使用bean传参,不要使用<if>标签内的test属性名应该对应bean属性名而非表的列名。否则会报There is no getter for property named 'xx' in 'class xxx
- 在Springboot项目中,如果要在application.properties中写自定义配置项,若该配置项为路径字符串,一定要写全路径,从盘符写起,否则会自动在前面拼接tomcat的临时路径
- html中onsubmit事件要放在form标签内,放在<input type="submit" />标签内无效
- 启动的时候需要先启动redis再启动微服务,否则会报RedisConnectionFailureException
- redis作为缓存使用时,建议捕获RedisConnectionFailureException异常,从而在redis崩掉的情况下能够直接访问数据库
- 基于SpringCloud的Ribbon模块在微服务之间相互调用时,不经过zuul网关
- MySQL主从高可用时,如果因为错误数据导致挂接失败,需要先取消挂接(stop slave),手动删除错误数据,再重新挂接(start slave)
- MyCat1.5.1版本还不支持复杂SQL,比如update...select..., insert ...select...等
- insert的时候加上列名是一个好习惯,因为MyCat1.5.1不支持省略列名的写法
- 直接使用RedisTemplate模板类,键和值会出现类似\xac\xed\x00\x05t\x00的东西,此时要么不去手动查看redis输出,要么换用StringRedisTemplate
- 用nginx也能做到外部调用内部api的拦截,只需要将提供给前端的api路径和提供给后端的api路径区分开。比如提供给前端的api路径是/manage/query,提供给后端的api是/backend/query,因为nginx拼接了"/manage",所以自然找不到/backend/query
@RequestParam
用于接收单个query请求参数;@ModelAttribute
用于接收Content-Type为application/x-www-form-urlencoded的多个query请求参数后封装成bean;@RequestBody
用于接收Content-Type为application/json的封装成body的请求参数单个基本请求参数 多个请求参数组成的一个bean query @RequestParam
@ModelAttribute
body 无 @RequestBody
@ExceptionHandler
注解修饰的方法别忘了加@ResponseBody
注解,否则捕获不到异常