JWT TOKEN

开箱即用的jwt token生成、校验、刷新和接口token检查

需要Java17+和spring boot 3

引入

<dependency>
    <groupId>io.github.ljezio</groupId>
    <artifactId>jwt-token-spring-boot-starter</artifactId>
    <version>1.1.2</version>
</dependency>

使用

class JwtToken {
    // 生成一个token
    static Token create(T payload);
    // 从token中取出负载
    static T decode(String token, Class<T> clazz) throws TokenVerifyFailedException, TokenExpiredException;
    // 刷新token
    static Token refresh(Token oldToken) throws TokenVerifyFailedException, TokenExpiredException;
    static Token refresh(String refreshToken) throws TokenVerifyFailedException, TokenExpiredException;
}

配置

jwt-token:
  secret: 1234
  access-token-expire-minutes: 30
  refresh-token-expire-days: 180
  interception:
    enable: true
    exclude-path:
      - /register
      - /login

配置	说明	类型	默认值
jwt-token.algorithm	加密算法	Enum	HMAC256
jwt-token.secret	密钥	String	1234ezio
jwt-token.access-token-expire-minutes	accessToken过期时间（分钟）	int	30
jwt-token.refresh-token-expire-days	refreshToken过期时间（天）	int	180
jwt-token.show-banner	是否显示banner图	boolean	true
jwt-token.interception.enable	是否启用拦截器	boolean	false
jwt-token.interception.header	安全请求头key	String	Authorization
jwt-token.interception.header-value-prefix	安全请求头value前缀	String	"Bearer "
jwt-token.interception.order	拦截器执行顺序	int	-1000
jwt-token.interception.path	需要检查token的url	List<String>	/**
jwt-token.interception.exclude-path	不需要检查token的url	List<String>
jwt-token.interception.check-fail-json.expired	token过期返回json	String	{ "code": 452, "msg": "token已过期", "data": null }
jwt-token.interception.check-fail-json.verifier-fail	token校验失败返回json	String	{ "code": 453, "msg": "token无效", "data": null }

拦截器

jwt-token.interception.enable设为true时启用拦截器，token校验不通过时拦截接口返回错误信息 PayloadHolder.get(Class<T> clazz)从上下文中获取token中的负载对象