TokenManager是一款基于Java开发的Spring Boot组件,用于管理自身平台以外的三方平台Token。
TokenManager将全场景的远程调用获取Token抽象到TokenManager接口中,通过调用指定的三方TokenAPI 实现各类三方平台的Token的管理。
TokenManager通过Redis的消息订阅特性实现了延时消息监听Token生命周期过期时间,从而自动刷新Token。 确保在高并发请求下,用户不会调用具体的三方接口实时获取Token。
TokenManager 默认实现了WEIXIN微信平台的accessToken(非用户授权码token)
TokenManager原理图如下所示:
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依赖:
<dependency>
<groupId>com.wuweiitgroupId>
<artifactId>token-managerartifactId>
<version>0.0.2version>
dependency>
Springboot配置内容
spring:
## 三方Token管理器
token-manager:
# TokenManager自动装配开关
enabled: true
# redis链接地址
host: ${TOKEN_REDIS_HOST:127.0.0.1}
# redis密码
password : ${TOKEN_REDIS_PASSWORD:123456}
# redis数据索引 默认15
database : ${TOKEN_REDIS_DB:14}
port: ${TOKEN_REDIS_PORT:6379}
# Token管理器多实例配置
configMap:
# 微信Token接口配置,自动注入Bean weixinTokenManager
weixin:
type: WEIXIN
appid: xxxxx
appsecret: xxxxx
TokenAPI设计简介
TokenAPI 提供了获取Token和刷新token两种接口,参数包含SecretConfig和Map,这里使用Map的原因是我们不能确定获取Token需要c端用户传递哪些数据字段,因此使用Map会较为通用的方式。
TokenManager会通过类型自动判断调用那个接口实现,当然我们也可以采用策略模式直接设置TokenAPI到TokenManger实例里。
通过时间偏移量来防止本地token过期,提前刷新Token。