网上商城

截图展示

声明

• 未经许可不得将本项目商用，如需商用请联系作者[email protected]
• 欢迎各位看官向本项目提交代码，对提交的分支我将进行合并。提交时请务必保证能编译能运行

关键技术

基于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)

• 全部秒杀商品查询
• 单个秒杀商品查询
• 发起秒杀

新版本部署教程

1. 环境准备
   1. 开发环境准备:首先你需要有一台电脑、以及一个虚拟机(或服务器)。内存要大，不然跑不起来。假设你的虚拟机的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
   2. 部署环境准备:虚拟机装上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目录下
2. 部署数据库
   1. 参照数据库启动脚本逐行执行，或直接运行该脚本。
   2. 由于官方的mysql镜像没有默认开启主从配置，也没设定UTF-8字符集，因此使用本项目专有镜像zongxr/mysql:5.7.37，可自动开启bin-log，并设定UTF-8字符集
   3. 该脚本制作了双向主从高可用的数据分片，节点分别为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
      
3. 部署redis集群
   1. 参照redis启动脚本逐行执行，或者直接运行该脚本
   2. 该脚本搭建了一个6节点的redis集群，从redis-1到redis-6。由于3.2.11版本的redis官方镜像没有预置ruby环境，而创建集群需要使用ruby环境。因此使用该项目的专用redis镜像zongxr/redis:3.2.11，该镜像已经集成了ruby环境可直接使用。
   3. 如果上一步redis集群部署成功了，那么可以通过6379端口连接该集群
4. 部署elasticsearch集群
   1. 参照elasticsearch启动脚本逐行执行，或直接运行该脚本
   2. 该脚本搭建了3节点的elasticsearch集群，分别是es-1, es-2, es-3。如果部署成功了，可以使用head插件连接http://192.168.137.147:9200/地址，集群状态应为green
   3. 官方默认的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
      
5. 部署微服务
   1. 参照微服务启动脚本逐行执行，或直接运行该脚本
   2. 每个微服务做了一个镜像，名为zongxr/supermarket-xxx:tag。如果所有微服务都启动成功了，那么将能够在注册中心看到所有注册的微服务，并且在http://192.168.137.147:APP_PORT/swagger-ui/网址能够看到该微服务对应的接口文档
   3. instant-buy微服务用到了消息队列rabbitmq。如果消息队列启动成功，将能够在Web UI管理界面看到传输的消息，用户名密码均为guest
6. 至此，所有服务都已经启动完成了。访问www.supermarket.com进行访问即可。

旧版本部署教程

• 0.4.x版本博客教程(感谢BlackPeachLawn)
• 0.4.x版本视频教程(感谢20427492)
• 0.3.x版本文档教程(感谢20427492)

交流群

版本迭代

配置情况

• 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注解，否则捕获不到异常