🎉前言

项目命名为goodsKill一方面有商品秒杀项目的意思(好像有点chinglish的味道)，另外也可理解为good skill，本项目就是希望搭建一套完整的项目框架，把一些好的技术和技巧整合进来（偏向于后端技术），方便学习和查阅。

本项目为慕课网仿购物秒杀网站,系统分为用户注册登录、秒杀商品管理模块。注册登录功能目前使用shiro完成权限验证。 此项目整体采用springMVC+RESTFUL风格，mybatis持久层框架，采用springcloud dubbo实现服务分布式服务调用，服务注册发现使用nacos server。

本项目扩展了秒杀功能，集成了jmock完成service层的测试，支持数据库分库分表，并提供基本的秒杀解决方案（通过模拟接口实现）。

• 集成内嵌式H2数据库，方便独立进行单元功能测试

• 集成sentinel限流组件，可以针对http请求以及dubbo rpc调用限流

• 集成新版支付宝easySDK，通过当面扫完成扫码付款

• 集成服务网关，采用Spring Cloud Gateway网关组件，并提供JWT用户鉴权功能

💎分支介绍

dev_gradle分支为使用gradle构建工具管理项目依赖（已停更），dev_maven分支对应maven构建工具（springframework版本4.x，已停更），master分支基于最新springcloud体系构建。本项目功能目前比较简陋且有很多不完善的地方，仅作学习参考之用，如果觉得本项目对你有帮助的请多多star支持一下👍~~~~。

附：码云项目链接https://gitee.com/techa/goodsKill ,clone速度慢的用码云仓库拉吧，不定期同步到码云~

✨技术选型

📌后端技术:

📌前端技术:

📝项目模块介绍

goodsKill
|--goodskill-chat-provider                  ||聊天室服务提供者（待完成）
|--goodsKill-common                         ||项目公共服务（待补充）
|--goodskill-gateway                        ||微服务网关
|--goodsKill-es-provider                    ||elasticsearch搜索服务提供者，目前提供根据商品名称检索商品库
|   |--goodskill-es-api                     
|   |--goodskill-es-dao                     
|   |--goodskill-es-service                 
|--goodsKill-mongo-provider                 ||mongo存储服务提供者
|   |--goodskill-mongo-service              
|--goodsKill-spring-boot-provider           ||订单、用户、登录、商品管理服务提供者（待拆分）
|   |--goodsKill-api
|   |--goodsKill-mp-dao                     ||使用MyBatis-Plus访问MySql数据源  
|   |--goodsKill-entry                      
|   |--goodsKill-generator                  
|   |--goodsKill-service                    
|   |--goodsKill-util                       
|--goodskill-spring-boot-starter            ||项目配置自动装配
|--goodskill-web                            ||提供页面客户端访问，controller层在这一模块   
|--goodskill-job                            ||elastic-job定时任务 

🧰开发环境版本说明

• JDK: OpenJDK11
• MySQL: 8.0.22+
• Kafka: 2.7.0+
• MongoDB: 4.4+
• Elasticsearch: 7.10.1+
• Sharding-JDBC: 4.1.1
• RabbitMQ: 3.8.5+
• SpringCloud: 2020.0.x
• SpringBoot: 2.4.x.RELEASE
• SpringCloudAlibaba: 2.2.3.RELEASE
• Kotlin: 1.4.22
• NacosServer: 1.3.2

🏃‍♂️如何启动项目

方法一：使用Docker镜像构建脚本

• 项目根目录goodsKill中执行

  mvn clean install
  或 
  #跳过单元测试
  mvn clean install -DskipTests
  

• 进入项目根目录(确保已安装compose以支持docker-compose命令)，执行以下命令：

  docker-compose up （第一次运行只需执行此命令）
  or
  docker-compose up -d //-d后台运行
  or
  docker-compose up -d --build //build重新构建镜像文件，针对项目自定义镜像配置需要修改的情况
  or
  docker-compose up -d --no-recreate //如上次以构建容器，则此次会跳过构建容器
  

  注:推荐使用docker-compose命令（推荐电脑运行内存16G以上），无需手动下载软件安装包，开箱即用。此命令会自动拉取docker镜像并以默认端口运行

  镜像	版本	端口	用户名密码
  Nacos	1.3.2	8848	无
  Redis	latest	6379	无
  Kafka	2.13-2.7.0	9092	无
  Mongo	4.4.3	27017	无
  MySQL	8.0.22	3306	root:Password123
  Zookeeper	3.6.2	2181	无
  Elasticsearch	7.10.1	9200 9300	无
  Kibana	7.10.1	5601	无
  RabbitMQ	latest	5672 15672	无
  Zipkin	latest	9411	无

注:除以上镜像外，docker-compose文件还包含项目构建命令，目前暂未列出

方法二：使用IDEA运行项目

• 如无docker运行环境，可参照官网安装上述应用，本地默认端口启动

• 进入goodskill-gateway模块，通过GatewayApplication类main方法启动服务网关

• 找到EsApplication类main方法启动远程服务

• 找到GoodsKillRpcServiceApplication类main方法启动远程服务，并且需要在host中加入以下信息

  127.0.0.1 kafka
  127.0.0.1 nacos
  

• 进入goodsKill-web模块根目录，运行命令或直接通过SampleWebJspApplication类main方法启动

  mvn spring-boot:run -Dspring.profiles.active=dev
  

• 如已安装MongoDB，可以main方法启动MongoReactiveApplication，通过使用该服务操作mongo库

⚠导入项目数据库基础数据 ️

• 找到seckill.sql文件，在本地mysql数据库中建立seckill仓库并执行完成数据初始化操作

  注:docker-compose启动方式会自动执行初始化脚本，因此无需执行该步骤

• application.yml已包含所有环境配置信息，根据个人需要切换环境配置修改，修改active属性值即可

  spring:
    profiles:
      active: dev
  

• 启动完成后访问登录页面http://localhost:8080/goodskill/login，默认管理员账号admin123，密码：aa123456

额外功能（可选）

• 已集成sentinel限流组件，支持nacos配置中心方式推送限流规则，使用时需启动sentinel控制台，并以18088端口启动，docker环境暂不支持。

📦打包部署方法

• 可参考Dockerfile文件，如:

FROM openjdk:11.0.9.1-jdk
COPY goodsKill-service/target/goodsKill-service.jar /app/goodsKill-service.jar
WORKDIR /app
CMD ["java", "-jar","-Dspring.profiles.active=docker","-Duser.timezone=GMT+08", "goodsKill-service.jar"]

❓常见问题

• 使用idea启动SampleWebJspApplication类(goodsKill-web模块)时会出现访问不了页面的问题，eclipse无此问题。

  解决办法：配置启动类的工作目录为goodsKill-web

• docker es镜像启动失败？

  出现此问题一般为linux环境，运行以下命令即可

  sysctl -w vm.max_map_count=262144
  

• 新版支付宝SDK已集成，使用时需将AlipayRunner中的alipay对应配置替换成你的支付宝应用配置（本项目基于沙箱环境）

    //为了防止启动项目报错默认配置为1，可参考官方文档修改对应配置
    @Value("${alipay.merchantPrivateKey:1}")
    private String merchantPrivateKey;

    @Value("${alipay.alipayPublicKey:1}")
    private String alipayPublicKey;
    
    ......   

📚分库分表情况说明

注:其他表均未分库分表，默认使用seckill作为主库

🔖服务网关说明

• http://localhost/goodskill/mongo 对应goodsKill-mongo-provider服务

• http://localhost/goodskill/es 对应goodsKill-es-provider服务

• http://localhost/goodskill 对应goodsKill-service-provider服务

• 通过http://localhost/goodskill/token接口获取token

• 通过http://localhost/goodskill/refresh刷新用户token

🔥🔥秒杀方案

目前实现了几种秒杀方案，通过SeckillMockController提供测试接口

swagger主页测试地址：http://localhost:8080/goodskill/swagger-ui.html#/

swagger增强主页测试地址：http://localhost:8080/goodskill/doc.html

• 场景一：sychronized同步锁实现
• 场景二：redisson分布式锁实现
• 场景三：ActiveMQ实现(已废弃)
• 场景四：Kafka实现
• 场景五：本地事务实现
• 场景六：实时等待秒杀处理结果(已废弃)
• 场景七：zookeeper分布式锁
• 场景八：使用redis进行秒杀商品减库存操作，秒杀结束后异步发送MQ，使用mongoDB完成数据落地
• 场景九：SpringCloudStream RabbitMQ实现

可在web控台查看秒杀结果，打印信息类似：

2019-03-25 13:40:42.123  INFO 1016 --- [io-18080-exec-9] o.s.w.controller.SeckillMockController   : 秒杀活动开始，秒杀场景三(activemq消息队列实现)时间：Mon Mar 25 13:40:42 CST 2019,秒杀id：1001
2019-03-25 13:40:49.050  INFO 1016 --- [ jmsContainer-1] o.s.web.mqlistener.SeckillTopicListener  : 最终成功交易笔数：100
2019-03-25 13:40:49.050  INFO 1016 --- [ jmsContainer-1] o.s.web.mqlistener.SeckillTopicListener  : 秒杀活动结束，秒杀场景三(activemq消息队列实现)时间：Mon Mar 25 13:40:49 CST 2019,秒杀id：1001

🔨后续更新计划

API接口

API接口说明

🍔页面展示

登录：

注册：

主页：

商品查询:

搜索框下拉商品候选信息基于elasticsearch实现，支持关键词高亮显示

商品列表限流：

用户角色权限管理：

模拟秒杀接口测试

📑数据库表结构

📖参考文档

• 解决Docker容器连接 Kafka 连接失败问题：https://www.cnblogs.com/hellxz/p/why_cnnect_to_kafka_always_failure.html