cn.dev33.satoken.same

类 SaSameTemplate

java.lang.Object

cn.dev33.satoken.same.SaSameTemplate

public class SaSameTemplate
extends java.lang.Object

Sa Same-Token 同源系统身份认证模块 - 模板方法类

解决同源系统互相调用时的身份认证校验， 例如：微服务网关请求转发鉴权、微服务RPC调用鉴权

从以下版本开始:

2022-10-24

作者:

kong

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	SAME_TOKEN 提交 Same-Token 时，建议使用的参数名称

构造器概要

构造器

构造器和说明
SaSameTemplate()

方法概要

限定符和类型	方法和说明
void	checkCurrentRequestToken() 校验当前 Request 上下文提供的 Same-Token 是否有效 (如果无效则抛出异常)
void	checkToken(java.lang.String token) 校验一个 Same-Token 是否有效 (如果无效则抛出异常)
java.lang.String	createToken() 创建一个 Same-Token
java.lang.String	getPastTokenNh() 获取 Past-Same-Token，不做任何处理
java.lang.String	getToken() 获取当前 Same-Token, 如果不存在，则立即创建并返回
java.lang.String	getTokenNh() 获取 Same-Token，不做任何处理
long	getTokenTimeout() 获取 Same-Token 的剩余有效期 (单位：秒)
boolean	isValid(java.lang.String token) 判断一个 Same-Token 是否有效
java.lang.String	refreshToken() 刷新一次 Same-Token (注意集群环境中不要多个服务重复调用)
void	savePastToken(java.lang.String token, long timeout) 保存 Past-Same-Token
void	saveToken(java.lang.String token) 保存 Same-Token
java.lang.String	splicingPastTokenSaveKey() 拼接key：次级 Same-Token 的存储 key
java.lang.String	splicingTokenSaveKey() 拼接key：Same-Token 的存储 key

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

SAME_TOKEN

public static final java.lang.String SAME_TOKEN

提交 Same-Token 时，建议使用的参数名称

另请参阅:

常量字段值

构造器详细资料

SaSameTemplate

public SaSameTemplate()

方法详细资料

getToken

public java.lang.String getToken()

获取当前 Same-Token, 如果不存在，则立即创建并返回

返回:

/

isValid

public boolean isValid(java.lang.String token)

判断一个 Same-Token 是否有效

参数:

token - /

返回:

/

checkToken

public void checkToken(java.lang.String token)

校验一个 Same-Token 是否有效 (如果无效则抛出异常)

参数:

token - /

checkCurrentRequestToken

public void checkCurrentRequestToken()

校验当前 Request 上下文提供的 Same-Token 是否有效 (如果无效则抛出异常)

refreshToken

public java.lang.String refreshToken()

刷新一次 Same-Token (注意集群环境中不要多个服务重复调用)

返回:

刷新后产生的新 Same-Token

saveToken

public void saveToken(java.lang.String token)

保存 Same-Token

参数:

token - /

savePastToken

public void savePastToken(java.lang.String token,
                          long timeout)

保存 Past-Same-Token

参数:

token - token

timeout - 有效期（单位：秒）

getTokenNh

public java.lang.String getTokenNh()

获取 Same-Token，不做任何处理

返回:

/

getPastTokenNh

public java.lang.String getPastTokenNh()

获取 Past-Same-Token，不做任何处理

返回:

/

getTokenTimeout

public long getTokenTimeout()

获取 Same-Token 的剩余有效期 (单位：秒)

返回:

/

createToken

public java.lang.String createToken()

创建一个 Same-Token

返回:

Token

splicingTokenSaveKey

public java.lang.String splicingTokenSaveKey()

拼接key：Same-Token 的存储 key

返回:

key

splicingPastTokenSaveKey

public java.lang.String splicingPastTokenSaveKey()

拼接key：次级 Same-Token 的存储 key

返回:

key