权限认证框架sa-token的token有效期与实时续签

sa-token

sa-token 是一个非常强大的JavaWeb权限认证框架，其集成了诸多好用的特性，诸如：登录验证、权限验证、自定义session会话、踢人下线 等等均可以在框架中一行代码完成调用，官网地址：http://sa-token.dev33.cn/

sa-token的令牌有效期

sa-token 提供两种token自动过期策略，分别是timeout与activity-timeout，其详细用法如下：

timeout

• timeout代表token的长久有效期，单位/秒，例如将其配置为2592000(30天)，代表在30天后，token必定过期，无法继续使用
• timeout无法续签，想要继续使用必须重新登录
• timeout的值配置为-1后，代表永久有效，不会过期

activity-timeout

• activity-timeout代表临时有效期，单位/秒，例如将其配置为1800(30分钟)，代表用户如果30分钟无操作，则此token会立即过期
• 如果在30分钟内用户有操作，则会再次续签30分钟，用户如果一直操作则会一直续签，直到连续30分钟无操作，token才会过期
• activity-timeout的值配置为-1后，代表永久有效，不会过期，此时也无需频繁续签

关于activity-timeout的续签

如果activity-timeout配置了大于零的值，sa-token会在登录时开始计时，在每次直接或间接调用getLoginId()时进行一次过期检查与续签操作。
此时会有两种情况：

• 一种是会话无操作时间太长，token已经过期，此时框架会抛出NotLoginException异常(场景值=-3)，
• 另一种则是会话在activity-timeout有效期内通过检查，此时token可以成功续签

我可以手动续签吗？

可以！
如果框架的自动续签算法无法满足您的业务需求，你可以进行手动续签，sa-token提供两个API供你操作：

• StpUtil.checkActivityTimeout(): 检查当前token 是否已经[临时过期]，如果已经过期则抛出异常
• StpUtil.updateLastActivityToNow(): 续签当前token：(将 [最后操作时间] 更新为当前时间戳)
• 注意：在手动续签时，即时token已经 [临时过期] 也可续签成功，如果此场景下需要提示续签失败，可采用先检查再续签的形式保证token有效性
• 例如以下代码：

	// 先检查是否已过期
	StpUtil.checkActivityTimeout();
	// 检查通过后继续续签
	StpUtil.updateLastActivityToNow();

timeout与activity-timeout可以同时使用吗？

可以同时使用！
两者的认证逻辑彼此独立，互不干扰，可以同时使用。

程序员交流qq群：782974737 点击加入