https://github.com/wuweiit/token-manager
三方对接Token管理器，支持自动刷新Token，基于Redis多服务共享，2level缓存，适用微信小程序Token等三方Token管理续期
https://github.com/wuweiit/token-manager
java redis token
Last synced: 6 months ago
JSON representation
三方对接Token管理器，支持自动刷新Token，基于Redis多服务共享，2level缓存，适用微信小程序Token等三方Token管理续期
- Host: GitHub
- URL: https://github.com/wuweiit/token-manager
- Owner: wuweiit
- Created: 2021-08-15T11:29:53.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-08-26T23:34:56.000Z (almost 2 years ago)
- Last Synced: 2025-07-25T14:18:32.622Z (12 months ago)
- Topics: java, redis, token
- Language: Java
- Homepage:
- Size: 115 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- Changelog: history.md
Awesome Lists containing this project
README
# TokenManager
TokenManager是一款基于Java开发的Springboot组件，用于管理自身平台以外的三方Token。
TokenManager将全场景的远程调用获取Token抽象到TokenManager接口中，通过调用指定的API实现各类三方系统的Token的管理。
通过Redis的消息订阅特性实现了延时消息监听Token生命周期过期时间，从而自动刷新Token。
确保在高并发请求下，用户不会调用具体的三方接口实时获取Token。
TokenManager原理图如下所示：
开发者：marker
### TokenManger更新历史
[更新历史文档](#history.md)
### TokenManager特性
- **多环境Token共享**
例如：调试微信，获取appid+secrt换取accessToken，在开发环境和测试环境共用appid的情况下，Token共享。
- **自动刷新accessToken**
支持基于Oauth2协议的刷新Token机制，无需干预自动刷新，最佳的管理方式，提高接口响应速度。
- **多级缓存（待实现)**
支持本地缓存与远程缓存。本地缓存JVM级别的，远程缓存基于Redis。提高Token的访问速度，防止Redis击穿雪崩。
本地缓存的生命周期动态管理。
- **可扩展**
支持扩展现有的API实现，能够支持除了微信以外的其他平台。采用自动装配技术，实例动态注入到Spring容器中。
- **支持请求日志拦截**
通过RestTempalte 拦截器实现了请求日志拦截，默认实现了请求Slf4j的info级别日志。可以自定义配置个性化的拦截实现。
### 快速开始
准备好Redis-server，服务IP与端口还有密码
```
服务：127.0.0.1:6379
密码：123456
```
如果您没有Redis服务环境，推荐使用Docker部署测试。
在您的项目中pom.xml加入maven依赖：
```
com.wuweibi
token-manager
0.0.3
```
### TokenAPI
TokenAPI 提供了获取Token和刷新token两种接口，参数包含SecretConfig和Map，这里使用Map的原因是我们不能确定获取Token需要c端用户传递哪些数据字段，因此使用Map会较为通用的方式。
TokenManager会通过类型自动判断调用那个接口实现，当然我们也可以采用策略模式直接设置TokenAPI到TokenManger实例里。
### Springboot配置内容
```
spring:
## 三方Token管理器
token-manager:
enabled: true
# redis链接地址
host: ${TOKEN_REDIS_HOST:192.168.1.6}
# redis密码
password : ${TOKEN_REDIS_PASSWORD:xxx}
# redis数据索引 默认14
database : ${TOKEN_REDIS_DB:13}
port: ${TOKEN_REDIS_PORT:6379}
lettuce:
#在关闭客户端连接之前等待任务处理完成的最长时间，在这之后，无论任务是否执行完成，都会被执行器关闭，默认100ms
shutdownTimeout: 100
pool:
# 连接池最大连接数（使用负值表示没有限制）
maxActive: 50
# 连接池中的最大空闲连接
maxIdle: 10
# 连接池中的最小空闲连接
minIdle: 9
# 连接池最大阻塞等待时间（使用负值表示没有限制）
maxWait: -1
# Token管理器多实例配置
configMap:
# 微信Token接口配置
weixinMp:
type: WEIXIN
appid: wx03698c0a99f50cfb
appsecret: 82aee19d923384fcda0be1ad9f23619c
offsetTime: 60
```
使用代码
```
// 注入控制器或service
@Lazy
@Resource
private TokenManager tokenManager;
// 调用获取token （内部会自动维护过期时间）
TokenInfo tokenInfo = tokenManager.getToken();
BufferedImage bufferedImage = WxaAPI.getwxacodeunlimit(tokenInfo.getAccessToken(), getwxacodeunlimit);
```