README.md · 小楼一夜听春雨丶/springcloud-template

一个基于 Spring Cloud Netflix 、Spring Boot 2.0.3 的微服务开发模板

## 功能说明

- 基于Eureka服务下线实现无报错优雅发版
- 统一异常处理和响应包装
- 请求参数、响应结果统一日志打印(可将日志ID传递至子线程)
- 自定义线程池日志、Tomcat线程池(主要加了日志打印功能)
- Feign请求头数据在微服务间传递
- 基于MDC实现的自定义请求链路追踪
- 基于redis+注解实现的API幂等
- 统一认证demo，包括微信、支付宝授权登录等各种登录方式
- 文件存储demo，包括阿里云OSS、腾讯云COS等多种云存储方式

## 快速开始

### 核心依赖

| 依赖                   | 版本       |
| ---------------------- |------------|
| Spring Boot            | 2.0.3      |
| Spring Cloud Netflix   | 2.0.0      |

### 模块说明

```lua
springcloud-template
├── template-common -- 公共模块
└── template-framework -- 框架代码(内部微服务)
     └── advice -- 统一异常处理、响应日志统一打印
     └── autoconfigure -- 自动配置
     └── deploy -- 优雅发版(可做到用户无感发版，完全不报错)
     └── interceptor -- Feign请求头数据在微服务间传递
     └── threadpool -- 自定义线程池（JDK和Tomcat）
└── template-framework-edge -- 框架代码(边缘微服务)
     └── filter -- http公共请求参数设置到请求头在微服务内传递
     └── interceptor -- 访问控制(结合@PublicUrl使用)
├── template-eureka -- 注册中心
├── template-zuul -- 网关
├── template-config -- 配置中心
└── template-order -- 订单服务(内部微服务)
     └── template-order-api -- 被依赖开放api
└── template-order -- 订单服务(内部微服务)
     └── template-order-api -- 被依赖开放api
└── template-tool -- 工具服务(内部微服务)
     └── template-tool-api -- 被依赖开放api
     └── file -- 文件存储
          └── alioss -- 阿里云OSS
          └── amazons3 -- 亚马逊AWS
          └── baidubos -- 百度BOS
          └── huaweiobs -- 华为云OBS
          └── jingdongoss -- 京东云OOS
          └── local -- 本地磁盘
          └── minio -- MinIO
          └── tencentcos -- 腾讯云COS
          └── wangyinos -- 网易NOS
└── template-auth -- 统一认证接入层(边缘微服务)
     └── authentication -- 登录
          └── 本机号码一键登录
          └── 用户名+密码登录
          └── 手机号+验证码登录
          └── 手机号+验证码登录并绑定授权码
          └── APP微信授权登录
          └── 微信小程序登录(新版)
          └── 微信小程序登录(旧版)
          └── 微信公众号登录
          └── 支付宝小程序登录
     └── token -- token的使用
          └── JWT
          └── sa-token的应用
     └── wx -- binarywang的应用
├── template-app -- app端接入层(边缘微服务)
├── template-web -- web端接入层(边缘微服务)
├── template-admin -- 管理后台端
```

### 本地开发 运行

- 先启动注册中心eureka，[http://localhost:7001/](http://localhost:7001/)
- 启动需要的边缘微服务，通过pom找到其依赖的内部微服务启动（如果需要预览API内没有依赖内部微服务，也可不启动），就可以请求相关API进行效果预览了（建议使用postman等工具）

### 运用

- 建议作为参考demo，再结合你的项目选择合适代码放到你的项目中

## 开源共建

### 开源协议

springcloud-template 开源软件遵循 [Apache 2.0 协议](https://www.apache.org/licenses/LICENSE-2.0.html)。
允许商业使用，但务必保留类作者、Copyright 信息。

### 其他说明

1. 联系作者 <a href="mailto:897665787@qq.com">897665787@qq.com</a>

小楼一夜听春雨丶/springcloud-template

简介

发行版

贡献者

近期动态

小楼一夜听春雨丶/springcloud-template .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

小楼一夜听春雨丶/springcloud-template