基于SpringCloudAlibaba技术栈微服务模板项目
boot-model
| 模块 | 描述 |
|---|---|
| docs | 配置文档 |
| boot | 启动模块 |
| boot-dev | 开发模块 |
| boot-parent | 依赖模块 |
| gateway | 网关服务模块 |
| web-parent | Web服务模块 |
| rest-parent | Rest服务模块 |
| service-parent | 内部服务模块 |
三个模块没有具体区分，均可按需向外提供服务。
[+]添加功能[-]删除功能[*]修改功能[!]危险操作[#]没有完成[~]日常任务
+：必选*：可选
Web服务使用传统Session记录状态，通过RedisSession实现共享，需要用户自己通过拦截器或者Spring Security实现认证授权。
如果Web登录成功访问没有集成RedisSession的项目，那么就会导致Session失效。
解决方法设置session的cookie.name、cookie.domain或者cookie.path进行区分。
Rest服务使用OAuth2服务通过网关实现统一认证鉴权
为了方便测试后台接口，可以绕过网关直接请求WWW(Web/Rest)服务，需要配置system.rest.ignore-user=true忽略用户拦截。
如果需要模拟用户登陆需要添加请求头部current-user设置登陆用户信息。
配置统一放在Nacos配置中心通过bootstrap.yml加载：
spring:
application:
name: acgist
main:
allow-circular-references: true
allow-bean-definition-overriding: true
profiles:
active: @profile@
cloud:
nacos:
username: @nacosUser@
password: @nacosPassword@
discovery:
namespace: ${spring.profiles.active}
server-addr: @nacos@
config:
namespace: ${spring.profiles.active}
server-addr: @nacos@
file-extension: yml
refreshable-dataids: main.yml, task.yml, dubbo.yml
# 设置标签
git tag 1.0.0
# 设置版本
mvn versions:set -DnewVersion=1.0.0
mvn -N versions:update-child-modules
mvn versions:commit
# 配置中心
system.version=1.0.0
sed -i "s/1.0.0/1.1.0/g" `grep 1.0.0 -rl ./*.sh`
- 服务下线
kill -2 pidkill -15 pid
# 系统名称
system.name=muses
# 系统版本
system.version=1.0.0
# 机器编号（负数自动生成）：主要用于生成ID（相同服务建议设置不同编号）
system.sn=-1
# 系统端口：随机生成
system.port=8080
# 系统序列化类型
system.serializer.type=jdk|jackson
# 是否自动配置MVC：请求拦截器、参数解析器
system.mvc=true|false
# Rest忽略用户拦截
system.rest.ignore-user=true|false
# 慢请求统计时间：毫秒
system.gateway.slow.request.duration=1000
# 静态资源地址
system.static.host=//localhost:8888
# 网关Topic
system.topic.gateway=topic-gateway
# 是否允许下线自动关机
system.shutdown.enable=true
# 自动关机等待时间：秒
system.shutdown.gracefully=30
# 缓存时间：分钟
system.cache.ttl=30
# 缓存前缀
system.cache.prefix=cache::
# 登陆失败最大次数
system.login.fail.count=5
# 登陆失败锁定时长：秒
system.login.fail.duration=1800
# Excel
system.excel.header.font=宋体
system.excel.header.size=16
system.excel.cell.font=宋体
system.excel.cell.size=12
system.excel.font.width=256
# 错误路径
system.error.path=/error
# 错误页面
system.error.view=/error
系统已经统一处理所有异常错误，Web模块建议不要使用网关进行地址截取，同时配置错误路径防止重定向时跳转地址错误。
存在重定向的服务均不建议使用网关地址截取
# 应用启动JVM参数
system.maven.jvm.arg=
# 应用启动JVM内存
system.maven.jvm.mem=
# 作者
system.maven.vendor=acgist
# 模块
system.maven.module=com.acgist.muses
# 项目的根目录
system.maven.basedir=${project.basedir}
# 编码
system.maven.encoding=UTF-8
# 是否跳过打包
system.maven.skip.assembly=true
| 模块 | 端口 |
|---|---|
| gateway | 8888 |
| rest-oauth2 | 9999 |
| web | [18000,19000) |
| rest | [19000,20000) |
# 配置
server.port=8888
# 命令
java -jar appliation.jar --server.port=8888
java -Dserver.port=8888 -jar appliation.jar
java -jar appliation.jar --system.port=8888
java -Dsystem.port=8888 -jar appliation.jar
server.port=0
server.port=${system.port:8080}
服务实例里面所有业务逻辑都是测试使用，可以根据自己实际情况进行修改删除。
| 名称 | 包名 | 描述 |
|---|---|---|
| 配置 | com.acgist.**.config | |
| 过滤器 | com.acgist.**.filter | |
| 监听器 | com.acgist.**.listener | |
| 拦截器 | com.acgist.**.inteceptor | |
| 控制器 | com.acgist.**.controller | |
| 远程服务 | com.acgist.**.api.impl | |
| 本地服务 | com.acgist.**.service.impl | |
| 数据模块 | com.acgist.**.dao.* | es/neo4j/mapper/repository |
| 数据模型 | com.acgist.**.model.* | es/neo4j/entity/vo/dto/type/request/response/exception |
model.type存放实体枚举
- 本地
Service接口不要使用I开头：UserService - 远程
Service接口需要使用I开头：IUserService - 实现接口使用
Impl结尾：UserServiceImpl - 不要使用继承
BootService提供远程服务
现在Dubbo暂不支持JDK17，需要添加以下参数才能启动：
--add-opens java.base/java.io=ALL-UNNAMED
--add-opens java.base/java.math=ALL-UNNAMED
--add-opens java.base/java.util=ALL-UNNAMED
--add-opens java.base/java.lang=ALL-UNNAMED
--add-opens java.rmi/sun.rmi.transport=ALL-UNNAMED
--add-opens java.base/java.lang.reflect=ALL-UNNAMED
--add-opens java.base/java.util.concurrent=ALL-UNNAMED
https://docs.spring.io/spring-boot/docs/current/reference/html/application-properties.html