同步操作将从 dromara/lamp-cloud 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
基于SpringCloud(Greenwich.RELEASE)
+ SpringBoot(2.1.2.RELEASE)
的微服务 脚手架,具备用户管理、资源权限管理、网关统一鉴权、Xss防跨站攻击、自动代码生成、多存储系统、分布式事务、分布式定时任务等多个模块,支持多业务系统并行开发,
支持多服务并行开发,可以作为后端服务的开发脚手架。代码简洁,架构清晰,非常适合学习使用。核心技术采用Eureka、Fegin、Ribbon、Zuul、Hystrix、JWT Token、Mybatis、SpringBoot、Seata、Nacos、Sentinel、
RibbitMQ、FastDFS等主要框架和中间件。
希望能努力打造一套从 基础框架
- 分布式微服务架构
- 持续集成
- 自动化部署
- 系统监测
的解决方案。本项目旨在实现基础能力,不涉及具体业务。
部署方面, 可以采用以下4种方式,并会陆续公布jenkins集合以下3种部署方式的脚本和配置文件:
https://www.kancloud.cn/zuihou/zuihou-admin-cloud
[gitee] https://gitee.com/zuihou111/zuihou-admin-cloud
[github] https://github.com/zuihou/zuihou-admin-cloud (由于某种特殊原因,下载代码有时非常慢)
[前端] https://github.com/zuihou/zuihou-ui
[前端] https://gitee.com/zuihou111/zuihou-ui
[代码生成器] https://github.com/zuihou/zuihou-generator
[原型] http://zuihou111.gitee.io/zuihou-admin-rp/
[介绍文档] https://zuihou.github.io/zuihou-admin-cloud/
[演示环境] http://42.202.130.216:10000/zuihou-ui
[注册中心] http://42.202.130.216:10000/nacos/
[在线文档] http://42.202.130.216:10000/api/gate/doc.html
[定时任务] http://42.202.130.216:10000/zuihou-jobs-server
[监控中心] http://42.202.130.216:10000/zuihou-monitor/
[全链路监控中心] http://42.202.130.216:10000/zipkin/
基于Eureka来实现的服务注册与调用,在Spring Cloud中使用Feign, 我们可以做到使用HTTP请求远程服务时能与调用本地方法一样的编码体验,开发者完全感知不到这是远程方法,更感知不到这是个HTTP请求。
通过JWT的方式来加强服务之间调度的权限验证,保证内部服务的安全性。
将服务保留的rest进行代理和网关控制,除了平常经常使用的node.js、nginx外,Spring Cloud系列的zuul和rebbion,可以帮我们进行正常的网关管控和负载均衡。其中扩展和借鉴国外项目的扩展基于JWT的Zuul限流插件,方面进行限流。
因为采取了服务的分布,为了避免服务之间的调用“雪崩”,采用了Hystrix的作为熔断器,避免了服务之间的“雪崩”。
利用Spring Boot Admin 来监控各个独立Service的运行状态;利用turbine来实时查看接口的运行状态和调用频率;通过Zipkin来查看各个服务之间的调用链等。
利用基于Mybatis的DataScopeInterceptor拦截器实现了简单的数据权限
采用Dozer组件来对 DTO、DO、PO等对象的优化转换
严谨的表单验证通常需要 前端+后端同时验证, 但传统的项目,均只能前后端各做一次检验, 后期规则变更,又得前后端同时修改。
故在hibernate-validator
的基础上封装了zuihou-validator-starter
起步依赖,提供一个通用接口,可以获取需要校验表单的规则,然后前端使用后端返回的规则,
以后若规则改变,只需要后端修改即可。
由于原生swagger-ui某些功能支持不够友好,故采用了国内开源的swagger-bootstrap-ui
,并制作了stater,方便springboot用户使用。
基于Mybatis-plus-generator自定义了一套代码生成器, 通过配置数据库字段的注释,自动生成枚举类、数据字典注解、SaveDTO、UpdateDTO、表单验证规则注解、Swagger注解等。
基于xxl-jobs进行了功能增强。(如:指定时间发送任务、执行器和调度器合并项目、多数据源)
汉化 Eureka 注册中心页面
大文件/断点/分片续传
前端采用webupload.js、后端采用NIO实现了大文件断点分片续传,启动Eureka、Zuul、File服务后,直接打开docs/chunkUploadDemo/demo.html即可进行测试。 经测试,本地限制堆栈最大内存128M启动File服务,5分钟内能成功上传4.6G+的大文件,正式服耗时则会受到用户带宽和服务器带宽的影响,时间比较长。
本代码采用 Intellij IDEA(2018.1 EAP) 来编写,但源码与具体的 IDE 无关。
PS: Lombok版本过低会导致枚举类型的参数无法正确获取参数,经过调试发现因为版本多低后,导致EnumDeserializer的 Object obj = p.getCurrentValue();取的值为空。
项目-业务-api
,如zuihou-authority-api
项目-业务-biz
,如zuihou-authority-biz
项目-业务-controller
,如zuihou-authority-controller
项目-业务-server
,如zuihou-authority-server
前缀_[模块_]表名
, 模块可有可无, 如c_auth_role
、 f_file
表注释: 第一行用简短的文字来描述表的名称,会体现在Swagger中; 换行后对表进行详细介绍
字段注释: 第一行用简短的文字来描述字段的名称,会体现在Swagger的字段描述上; 换行后对字段进行详细的描述。
另外,若字段需要使用枚举类型,则字段需要设置成varchar类型, 并在字段注释上使用 #枚举类型{KEY:描述;key2:描述;} 格式来描述枚举类型格式, 代码生成器会自动生成枚举类
eg: #LogType{OPT:操作日志;EX:异常日志;}
类注释: 用 /** 开头的文档型注释, 并添加 @author @date 等参数
方法注释: 用 /** 开头的文档型注释, 并添加 @param @return 等参数
clean install -T8 -DskipTests=true
@Repository
, 防止IDEA
提示注入报错。@Autowired
注入失败时,可以用@Resource
防止IDEA
提示注入报错。1,前端 (急需!!只要你懂点vue、热爱开源,请加入我们的队伍吧)
2,后端
3,土豪哥哥(求赞助服务器)
4,有想要合作或者赞助服务器的朋友加群(63202894)联系群主
1,Fork
2,修改代码后提交pr
3,等待合并
4,合并超过5次的朋友,直接拉为项目开发者
├─zuihou-admin-cloud
│ │
│ ├─docs-------------------------------------文档
│ │
│ ├─third-party-----------------------------第三方组件
│ │
│ ├─zuihou-backend---------------------------后端服务
│ | ├─zuihou-api----------------------------常用API
│ | ├─zuihou-authority----------------------权限服务[正在开发]
│ | | ├─zuihou-authority-biz---------------权限服务业务模块
│ | | ├─zuihou-authority-controller--------权限服务接口模块
│ | | ├─zuihou-authority-entity------------权限服务实体模块
│ | | ├─zuihou-authority-server------------权限服务启动模块
│ | ├─zuihou-config-------------------------配置中心
│ | ├─zuihou-demo---------------------------演示服务
│ | ├─zuihou-file---------------------------文件模块服务[完成]
│ | ├─zuihou-gateway------------------------统一网关负载中心
│ | | |─zuihou-gateway-server--------------gateway网关启动模块
│ | | |─zuihou-zuul-authentication---------zuul网关权限控制模块
│ | | |─zuihou-zuul-base-------------------zuul网关公共模块
│ | | |─zuihou-zuul-ratelimit--------------zuul网关限流模块
│ | | |─zuihou-zuul-server-----------------zuul网关启动模块
│ | ├─zuihou-jobs---------------------------定时任务调度执行器[完成]
│ | ├─zuihou-msgs---------------------------消息模块服务[完成]
│ | ├─zuihou-order--------------------------订单服务
│ │
│ ├─zuihou-commons--------------------------公共模块
│ | ├─zuihou-cache-starter-----------------缓存模块
│ | ├─zuihou-common------------------------项目业务模块 (业务模块主要用于存放可能跟业务相关的公共代码)
│ | ├─zuihou-core--------------------------项目核心模块 (核心模块存放无业务逻辑的公共代码)
│ | ├─zuihou-databases---------------------项目数据源配置模块
│ | ├─zuihou-dozer-starter-----------------优雅的bean转换起步依赖
│ | ├─zuihou-jwt-starter-------------------JWT起步依赖
│ | ├─zuihou-log-starter-------------------操作日志起步依赖
│ | ├─zuihou-openfeign-starter-------------OpenFeign常用配置起步依赖
│ | ├─zuihou-shiro-starter-----------------shiro起步依赖
│ | ├─zuihou-swagger2-starter--------------SwaggerUI文档配置
│ | ├─zuihou-user-starter------------------用户信息自动注入起步依赖
│ | ├─zuihou-validator-starter-------------增强表单前后端统一验证起步依赖
│ | ├─zuihou-xss-starter-------------------防XSS起步依赖
│ │
│ ├─zuihou-dependencies----------------------项目顶级pom
│ │
│ ├─zuihou-support---------------------------服务模块
│ | ├─zuihou-eureka-------------------------注册中心[已废弃]
│ | ├─zuihou-monitor------------------------spring-boot-admin监控中心[已开发]
│ | ├─zuihou-zipkin-------------------------zipkin分布式链路跟踪[已废弃]
│ │
│ │-...
lombok插件
1, 依次运行数据库脚本(开发阶段,数据库脚本可能更新不及时,有问题github、gitee上留言, 会第一次时间同步):
2, 启动 nacos,新增命名空间 - zuihou
,并记录下自己新增的命名空间ID
3,将该命名空间ID复制到项目: zuihou-dependencies/pom.xml
- <pom.nacos.namespace>你刚才复制的命名ID</pom.nacos.namespace>
,同时在pom.xml中将nacos的ip和端口修改成自己的。
4,在nacos中,点击配置中心
- 切换到zuihou
- 导入 zuihou-backend/zuihou-config/src/main/resources 下的所有文件,具体操作看 third-party/README.md
5, 在nacos中修改 redis.yml、mysql.yml、rabbitmq.yml
6, mac/linux 在启动项目之前先创建日志文件夹
mkdir -p /data/projects/logs
chown -R $USER:$USER /data/projects/logs # linux
chown -R $USER:wheel /data/projects/logs # mac
7, window 在项目启动前,在代码所在的盘创建:D:/data/projects。 如: D:/data/projects
8 启动 nacos、 mysql、redis(可选)、rabbitmq(可选)
9,编译项目:clean install -DskipTests=true -T8 -P dev -f pom.xml
(这一步很重要,尤其是在IDEA中启动项目)
10,在IDE中启动,编译通过后按如下顺序启动:
11, 启动完毕,就可以测试了。每个服务都能访问各自的swagger文档, 然后在网关有一个聚合文档(能看到所有服务的接口)。
访问: http://127.0.0.1:8760/api/gate/doc.html ,切换(左上角)到 authority-权限模块
- 登录
- 登录
输入账号密码(zuihou/zuihou
) 用于生成token
然后将token复制到 Authorize
- 填到 token 的value 框, 保存后刷新一下页面, 然后调用其他接口即能正确传递token到后端。
开发小技巧: 这里token 有一个默认值test
,用于开发环境测试时使用 (详见:TokenContextFilter)。
# 注意: swagger 文档 只能用谷歌浏览器打开!!! 只能用谷歌浏览器打开!!!只能用谷歌浏览器打开!!!
权限服务: http://127.0.0.1:8764/doc.html
文件服务: http://127.0.0.1:8765/doc.html
消息服务: http://127.0.0.1:8768/doc.html
网关: http://127.0.0.1:8760/api/gate/doc.html
定时: http://127.0.0.1:8767/zuihou-jobs-server/toLogin
服务 | 端口号 |
---|---|
zuihou-eureka | 8761 |
zuihou-zipkin | 8767 |
zuihou-monitor | 8762,8763 |
- | - |
zuihou-gateway-server | 8760 |
zuihou-authority-server | 8764 |
zuihou-file-server | 8765 |
zuihou-msgs-server | 8766 |
zuihou-jobs-server | 8767/8768 |
zuihou-demo-server | 8769 |
zuihou-order-server | 8779 |
spring-boot-admin监控界面: spring-boot-admin监控界面: API 界面: 注册中心界面: 定时任务调度界面:
本项目正在开发阶段,由于码主白天要上班,只有晚上、周末能挤点时间来敲敲代码,所以进度可能比较慢,文档、注释也不齐全。
各位大侠就将就着看,但随着时间的推移。文档,注释,启动说明等码主我一定会补全的(对自己负责,也是对大家负责)。
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。