techa03 / Goodskill
Projects that are alternatives of or similar to Goodskill
🎉前言
项目命名为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速度慢的用码云仓库拉吧，不定期同步到码云~
✨技术选型
📌后端技术:
📌前端技术:
| 技术 | 名称 | 官网 |
|---|---|---|
| JQuery | 函式库 | http://jquery.com/ |
| Bootstrap | 前端框架 | http://getbootstrap.com/ |
| LayUI | 前端UI框架 | http://www.layui.com/ |
📝项目模块介绍
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定时任务
|--goodskill-seata ||集成nacos+dubbo+shardingjdbc+seata的分布式事务解决方案示例
🧰开发环境版本说明
- 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
- SpringCloudAlibaba: 2.2.5.RELEASE
- Kotlin: 1.4.21
- NacosServer: 1.4.1
- SeataServer: 1.4.1
🕹️️如何启动项目
方法一：使用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.4.1 8848 无 Redis latest 6379 无 Kafka 2.13-2.7.0 9092 无 KafkaManager latest 9000 无 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 无 SeataServer latest 8091 无
注:除以上镜像外，docker-compose.yml文件还包含项目构建命令，目前暂未列出。
若仅启动以上镜像不启动项目应用，可使用以下命令：
docker-compose -f goodskill-simple.yml up -d
方法二：使用IDEA运行项目
-
如无
docker运行环境，可参照官网安装上述应用，本地默认端口启动 -
进入
goodskill-gateway模块，通过GatewayApplication类main方法启动服务网关 -
找到
EsApplication类main方法启动远程服务 -
找到
GoodsKillRpcServiceApplication类main方法启动远程服务，并且需要在host中加入以下信息127.0.0.1 kafka 127.0.0.1 nacos 127.0.0.1 redis 127.0.0.1 mysql 127.0.0.1 zookeeper 127.0.0.1 mongo 127.0.0.1 elasticsearch 127.0.0.1 rabbitmq 127.0.0.1 zipkin -
进入
goodsKill-web模块根目录，运行命令或直接通过SampleWebJspApplication类main方法启动mvn spring-boot:run -Dspring.profiles.active=docker -
如已安装MongoDB，可以main方法启动
MongoReactiveApplication，通过使用该服务操作mongo库
⚠导入项目数据库基础数据 ️
-
找到
seckill.sql文件，在本地mysql数据库中建立seckill仓库并执行完成数据初始化操作注:docker-compose启动方式会自动执行初始化脚本，因此无需执行该步骤
-
启动完成后访问登录页面http://localhost:8080/goodskill/login，默认管理员账号admin123，密码：aa123456
额外功能（可选）
- 已集成
sentinel限流组件，支持nacos配置中心方式推送限流规则，使用时需启动sentinel控制台，并以18088端口启动，docker环境暂不支持。 - 通过main方法启动
GoodskillSeataApplication运行seata示例，运行前需启动seata-server服务，并配置nacos为seata注册中心和配置中心，另外还需在nacos控制台中增加以下配置（group需配置为SEATA_GROUP）
可参考Seata官方Nacos配置文档:http://seata.io/zh-cn/docs/user/configuration/nacos.htmlservice.vgroupMapping.my_test_tx_group=default store.mode=file
📦打包部署方法
- 可参考
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;
......
📚分库分表情况说明
| 表 | 数据库 | 是否分库 | 分库字段 | 是否分表 | 分表字段 |
|---|---|---|---|---|---|
| success_killed | MySQL | 是（同一服务器中，分为seckill和seckill_01两个库） | seckill_id | 是（分为success_killed_0,success_kill_1两张表） | user_phone |
注:其他表均未分库分表，默认使用seckill作为主库
🔖服务网关说明
-
http://localhost/goodskill/mongo 对应
goodsKill-mongo-provider服务 -
http://localhost/goodskill/es 对应
goodsKill-es-provider服务 -
http://localhost/goodskill/seata 对应
goodskill-seata服务 -
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
kafka状态监控页面地址: http://localhost:9000
zipkin链路跟踪页面地址: http://localhost:9411/zipkin/
- 场景一：sychronized同步锁实现
- 场景二：redisson分布式锁实现
- 场景三：ActiveMQ实现(已废弃)
- 场景四：Kafka消息队列实现
- 场景五：数据库原子性更新
- 场景六：实时等待秒杀处理结果(已废弃)
- 场景七：zookeeper分布式锁
- 场景八：使用redis进行秒杀商品减库存操作，秒杀结束后异步发送MQ，使用mongoDB完成数据落地
- 场景九：SpringCloudStream RabbitMQ实现
- 场景十：Sentinel限流+数据库原子性更新（需搭配sentinel控制台配置资源名
limit的流控规则）
可在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
🔨后续更新计划
| 功能 | 进度 | 完成时间 | 说明 |
|---|---|---|---|
| 集成spring cloud alibaba组件 | ✅ | 2020.5 | 目前已集成nacos、sentinel、dubbo组件 |
| 基于配置中心改造项目配置 | ✅ | 2020.7 | 支付宝配置保存于nacos配置中心，防止配置泄露 |
| 新版支付宝SDK集成 | ✅ | 2020.7 | 使用当面扫完成付款 |
| 完善jwt用户鉴权，并提供通用服务接口 | ✅ | 2020.12 | |
| 集成分布式事务解决方案 | ✅ | 2021.2 | |
| 聊天室功能 | ⏳ | 使用netty网络通信，maven分支已经实现，master分支待集成 | |
| 前后端分离 | ⏳ | 目前前后端全部放在gooskill-web模块，不利于部署 | |
| 丰富项目文档 | ⏳ |
API接口
API接口说明
💻页面展示
登录：
注册：
主页：
商品查询:
搜索框下拉商品候选信息基于elasticsearch实现，支持关键词高亮显示
用户角色权限管理：
商品列表限流：
Kafka状态监控
模拟秒杀接口测试
📑数据库表结构
📖参考文档
- 解决Docker容器连接 Kafka 连接失败问题：https://www.cnblogs.com/hellxz/p/why_cnnect_to_kafka_always_failure.html