SaToken学习笔记-01

SaToken学习笔记-01

SaToken版本为1.18

如果有排版方面的错误，请查看：传送门

springboot集成

根据官网步骤maven导入依赖

<dependency>
	<groupId>cn.dev33</groupId>
	<artifactId>sa-token-spring-boot-starter</artifactId>
	<version>1.18.0</version>
</dependency>

在resources下的application.ym中增加配置 当然你也可以零配置启动

server:
    # 端口
    port: 8081

spring:
    # sa-token配置
    sa-token:
        # token名称 (同时也是cookie名称)
        token-name: satoken
        # token有效期，单位s 默认30天, -1代表永不过期
        timeout: 2592000
        # token临时有效期 (指定时间内无操作就视为token过期) 单位: 秒
        activity-timeout: -1
        # 是否允许同一账号并发登录 (为true时允许一起登录, 为false时新登录挤掉旧登录)
        allow-concurrent-login: false
        # 在多人登录同一账号时，是否共用一个token (为true时所有登录共用一个token, 为false时每次登录新建一个token)
        is-share: false
        # token风格
        token-style: uuid
        # 是否输出操作日志
        is-log: false

创建启动类

在我学的时候，注意这里有个一个小坑：制作人员改动了1.18版本但是却没有及时更改官网信息

原版本官网：

@SpringBootApplication
public class SaTokenDemoApplication {
    public static void main(String[] args) throws JsonProcessingException {
        SpringApplication.run(SaTokenDemoApplication.class, args);
        System.out.println("启动成功：sa-token配置如下：" + SaTokenManager.getConfig());
    }
}

这样会导致异常：找不到SaTokenManager

通过我与相关人员取得联系后，发现其实应该将SaTokenManager更改为SaManager

正确版本应该为：

public static void main(String[] args) throws JsonProcessingException {
		SpringApplication.run(WebApplication.class, args);
		System.out.println("启动成功：sa-token配置如下：" + SaManager.getConfig());
}

创建测试Controller

官方测试用例：

@RestController
@RequestMapping("/user/")
public class UserController {

    // 测试登录，浏览器访问： http://localhost:8081/user/doLogin?username=zhang&password=123456
    @RequestMapping("doLogin")
    public String doLogin(String username, String password) {
        // 此处仅作模拟示例，真实项目需要从数据库中查询数据进行比对
        if("zhang".equals(username) && "123456".equals(password)) {
            StpUtil.setLoginId(10001);
            return "登录成功";
        }
        return "登录失败";
    }

    // 查询登录状态，浏览器访问： http://localhost:8081/user/isLogin
    @RequestMapping("isLogin")
    public String isLogin(String username, String password) {
        return "当前会话是否登录：" + StpUtil.isLogin();
    }

}

到这里所有的基本配置已经全部完成，开始测试

访问： http://localhost:8081/user/doLogin?username=zhang&password=123456

显示登录成功

访问： http://localhost:8082/user/isLogin

显示当前会话是否登录：true

---

清楚所有cookie后重新尝试

更改对应数值

访问： http://localhost:8081/user/doLogin?username=zhang&password=123456

显示登录失败

访问： http://localhost:8082/user/isLogin

显示当前会话是否登录：false

测试成功！！！

源码解析

看到这里不禁感叹，哇塞，这是多么的方便啊。同时也对他的实现原理尝试了好奇，他是如何使用这么便捷的代码做到的？于是我点开了源码：

1.StpUtil.setLoginId();

在判断传入的用户名和密码与数据库一致后，进行了此操作：StpUtil.setLoginId(10001);

我们看看他做了什么：

public static void setLoginId(Object loginId) {
		stpLogic.setLoginId(loginId);
	}

StpUtil类中的setLoginId将传入的loginId参数传给了stpLogic.setLoginId();

---

什么是stpLogic?

可以看到在StpUtil类中声明了

public static StpLogic stpLogic = new StpLogic("login");

点进StpLogic类，看到注解信息表明：

/**
 * sa-token 权限验证，逻辑实现类
 * <p>
 * (stp = sa-token-permission 的缩写 )
 * @author kong
 */

得知这个类是用于权限验证，以及逻辑实现的

---

继续深入：

 * 在当前会话上登录id
	 * @param loginId 登录id，建议的类型：（long | int | String）
	 */
	public void setLoginId(Object loginId) {
		setLoginId(loginId, new SaLoginModel());
	}

由此可见他创建了一个新的SaLoginModel,并且和loginId一起传入到另一个setLoginId中：

---

什么是SaLoginModel?

/**
 * 调用 `StpUtil.setLogin()` 时的 [配置参数 Model ]
 * @author kong
 *
 */

由注解可得是对于StpUtil.setLogin()时的用于配置参数的mdoel

其中包括设置了：

此次登录的客户端设备标识，

是否为持久Cookie，

指定此次登录token的有效期, 单位:秒 （如未指定，自动取全局配置的timeout值），

......

继续深入：

/**
	 * 在当前会话上登录id, 并指定所有登录参数Model
	 * @param loginId 登录id，建议的类型：（long | int | String）
	 * @param loginModel 此次登录的参数Model
	 */
	public void setLoginId(Object loginId, SaLoginModel loginModel) {

		// ------ 0、检查此账号是否已被封禁
		if(isDisable(loginId)) {
			throw new DisableLoginException(loginKey, loginId, getDisableTime(loginId));
		}

		// ------ 1、获取相应对象
		SaTokenConfig config = getConfig();
		SaTokenDao dao = SaManager.getSaTokenDao();
		loginModel.build(config);

		// ------ 2、生成一个token
		String tokenValue = null;
		// --- 如果允许并发登录
		if(config.getAllowConcurrentLogin() == true) {
			// 如果配置为共享token, 则尝试从Session签名记录里取出token
			if(config.getIsShare() == true) {
				tokenValue = getTokenValueByLoginId(loginId, loginModel.getDevice());
			}
		} else {
			// --- 如果不允许并发登录
			// 如果此时[user-session]不为null，说明此账号在其他地正在登录，现在需要先把其它地的同设备token标记为被顶下线
			SaSession session = getSessionByLoginId(loginId, false);
			if(session != null) {
				List<TokenSign> tokenSignList = session.getTokenSignList();
				for (TokenSign tokenSign : tokenSignList) {
					if(tokenSign.getDevice().equals(loginModel.getDevice())) {
						// 1. 将此token 标记为已顶替
						dao.update(splicingKeyTokenValue(tokenSign.getValue()), NotLoginException.BE_REPLACED);
						// 2. 清理掉[token-最后操作时间]
						clearLastActivity(tokenSign.getValue());
						// 3. 清理user-session上的token签名记录
						session.removeTokenSign(tokenSign.getValue());
				 		// $$ 通知监听器
				 		SaManager.getSaTokenListener().doReplaced(loginKey, loginId, tokenSign.getValue(), tokenSign.getDevice());
					}
				}
			}
		}
		// 如果至此，仍未成功创建tokenValue, 则开始生成一个
		if(tokenValue == null) {
			tokenValue = createTokenValue(loginId);
		}

		// ------ 3. 获取[User-Session] (如果还没有创建session, 则新建, 如果已经创建，则续期)
		SaSession session = getSessionByLoginId(loginId, false);
		if(session == null) {
			session = getSessionByLoginId(loginId);
		} else {
			session.updateMinTimeout(loginModel.getTimeout());
		}
		// 在session上记录token签名
		session.addTokenSign(new TokenSign(tokenValue, loginModel.getDevice()));

		// ------ 4. 持久化其它数据
		// token -> uid
		dao.set(splicingKeyTokenValue(tokenValue), String.valueOf(loginId), loginModel.getTimeout());

		// 写入 [最后操作时间]
		setLastActivityToNow(tokenValue); 

		// 在当前会话写入当前tokenValue
		setTokenValue(tokenValue, loginModel.getCookieTimeout());

		// $$ 通知监听器
		SaManager.getSaTokenListener().doLogin(loginKey, loginId, loginModel);
	}

根据传入的id，和相关的配置model带来的配置信息进行操作：

• 判断账号是否被封禁
  
  将获取的loginId传入isDisable中：

/**
	 * 指定账号是否已被封禁 (true=已被封禁, false=未被封禁)
	 * @param loginId 账号id
	 * @return see note
	 */
	public boolean isDisable(Object loginId) {
		return SaManager.getSaTokenDao().get(splicingKeyDisable(loginId)) != null;
	}

从splicingKeyDisable中拿出token名字+loginkey+loginId格式的字符串

（loginkey持久化的key前缀，用于多账号认证体系时通过这个key来区分，默认为""）

/**
	 * 拼接key： 账号封禁
	 * @param loginId 账号id
	 * @return key
	 */
	public String splicingKeyDisable(Object loginId) {
		return getConfig().getTokenName() + ":" + loginKey + ":disable:" + loginId;
	}

调用SaTokenDao接口中的get方法传入获取的字符串作为 key

该接口被SaTokenDaoDefaultImpl类所实现，重写方法get为：

@Override
	public String get(String key) {
		clearKeyByTimeout(key);
		return (String)dataMap.get(key);
	}

clearKeyByTimeout()：判断传入的key是否已经过期，如果key不为空并且没有设置为永不过期并且已经超出过期的时间时，则确认key已经过期，就将它对应的值remove

最终返回数据集合dataMap中key对应的值（包括账号信息是否封禁的值）

（public Map<String, Object> dataMap = new ConcurrentHashMap<String, Object>();）

最终根据传出的值是否带有封禁信息，和是否有值返回对应的boolean值来达到检查此账号是否封禁的目的

• 获取相应对象

SaTokenConfig

SaTokenDao

loginModel

• 生成一个token

根据SaTokenConfig类中的allowConcurrentLogin值判断是否允许并发登录

如果允许就再次判断是否配置为共享token（在多人登录同一账号时，是否共用一个token (为true时所有登录共用一个token, 为false时每次登录新建一个token)，根据SaTokenConfig中的isShare变量进行判断）如果是共享token，则根据loginId和登录模型中的设备标识返回一个token并赋给tokenValue

/**
	 * 获取指定loginId指定设备端的tokenValue
	 * <p> 在配置为允许并发登录时，此方法只会返回队列的最后一个token，
	 * 如果你需要返回此账号id的所有token，请调用 getTokenValueListByLoginId
	 * @param loginId 账号id
	 * @param device 设备标识
	 * @return token值
	 */
	public String getTokenValueByLoginId(Object loginId, String device) {
		List<String> tokenValueList = getTokenValueListByLoginId(loginId, device);
		return tokenValueList.size() == 0 ? null : tokenValueList.get(tokenValueList.size() - 1);
	}

如果不允许并发登录，就先通过loginId和isCreate（false无需新建，默认true），返回一个查询到的Session

/**
	 * 获取指定loginId的session, 如果session尚未创建，isCreate=是否新建并返回
	 * @param loginId 账号id
	 * @param isCreate 是否新建
	 * @return SaSession
	 */
	public SaSession getSessionByLoginId(Object loginId, boolean isCreate) {
		return getSessionBySessionId(splicingKeySession(loginId), isCreate);
	}

判断seesion是否为空，如果不为空则说明此账号在其他地正在登录，现在需要先把其它地的同设备token标记为被顶下线。通过该session获取到token签名列表的拷贝副本（底层为Vector），对获取到底列表副本遍历，将列表中的设备标识和此时的设备标识一一比对，如果有相同的，则将此token 标记为已顶替 ，清理token最后操作时间

/**
 	 * 清除指定token的 [最后操作时间]
 	 * @param tokenValue 指定token
 	 */
 	protected void clearLastActivity(String tokenValue) {
 		// 如果token == null 或者 设置了[永不过期], 则立即返回
 		if(tokenValue == null || getConfig().getActivityTimeout() == SaTokenDao.NEVER_EXPIRE) {
 			return;
 		}
 		// 删除[最后操作时间]
 		SaManager.getSaTokenDao().delete(splicingKeyLastActivityTime(tokenValue));
 		// 清除标记
 		SaHolder.getStorage().delete((SaTokenConsts.TOKEN_ACTIVITY_TIMEOUT_CHECKED_KEY));
 	}

清理user-session上的token签名记录

/**
	 * 移除一个token签名
	 *
	 * @param tokenValue token名称
	 */
	public void removeTokenSign(String tokenValue) {
		TokenSign tokenSign = getTokenSign(tokenValue);
		if (tokenSignList.remove(tokenSign)) {
			update();
		}
	}

最后通知监听器，调用SaTokenListener接口中的doReplaced方法，该方法被SaTokenListenerDefaultImpl类实现，并重写为输出相关被顶下线时的通知

/**
	 * 每次被顶下线时触发
	 */
	@Override
	public void doReplaced(String loginKey, Object loginId, String tokenValue, String device) {
		println("账号[" + loginId + "]被顶下线 (终端: " + device + ")");
	}

做完这些后继续判断是否session为null

若仍然没有成功创建session，也就是说该用户为不允许并发登录，并且没有已经登录的情况。则创建一个新的token

调用SaTokenAction接口中的createToken方法，SaTokenActionDefaultImpl类实现了这个接口，并重写了createToken方法

@Override
	public String createToken(Object loginId, String loginKey) {
		// 根据配置的tokenStyle生成不同风格的token
		String tokenStyle = SaManager.getConfig().getTokenStyle();
		// uuid
		if(SaTokenConsts.TOKEN_STYLE_UUID.equals(tokenStyle)) {
			return UUID.randomUUID().toString();
		}
		// 简单uuid (不带下划线)
		if(SaTokenConsts.TOKEN_STYLE_SIMPLE_UUID.equals(tokenStyle)) {
			return UUID.randomUUID().toString().replaceAll("-", "");
		}
		// 32位随机字符串
		if(SaTokenConsts.TOKEN_STYLE_RANDOM_32.equals(tokenStyle)) {
			return SaFoxUtil.getRandomString(32);
		}
		// 64位随机字符串
		if(SaTokenConsts.TOKEN_STYLE_RANDOM_64.equals(tokenStyle)) {
			return SaFoxUtil.getRandomString(64);
		}
		// 128位随机字符串
		if(SaTokenConsts.TOKEN_STYLE_RANDOM_128.equals(tokenStyle)) {
			return SaFoxUtil.getRandomString(128);
		}
		// tik风格 (2_14_16)
		if(SaTokenConsts.TOKEN_STYLE_TIK.equals(tokenStyle)) {
			return SaFoxUtil.getRandomString(2) + "_" + SaFoxUtil.getRandomString(14) + "_" + SaFoxUtil.getRandomString(16) + "__";
		}
		// 默认，还是uuid
		return UUID.randomUUID().toString();
	}

• **获取[User-Session] (如果还没有创建session, 则新建, 如果已经创建，则续期) **
  
  通过loginId，isCreate（false无需新建，默认true）获取session，并判断是否为空
  
  若为空就创建一个新的session，若不为空则，重新修改session的存活时间

/**
	 * 修改此Session的最小剩余存活时间 (只有在Session的过期时间低于指定的minTimeout时才会进行修改)
	 * @param minTimeout 过期时间 (单位: 秒)
	 */
	public void updateMinTimeout(long minTimeout) {
		if(getTimeout() < minTimeout) {
			SaManager.getSaTokenDao().updateSessionTimeout(this.id, minTimeout);
		}
	}

在session上记录token签名

• **持久化其它数据 **
  
  调用SaTokenDao接口中的set方法

	/**
	 * 写入指定key-value键值对，并设定过期时间 (单位: 秒)
	 * @param key 键名称
	 * @param value 值
	 * @param timeout 过期时间 (单位: 秒)
	 */
	public void set(String key, String value, long timeout);

SaTokenDaoDefaultImpl类实现了该接口并且重写了set方法

@Override
	public void set(String key, String value, long timeout) {
		dataMap.put(key, value);
		expireMap.put(key, (timeout == SaTokenDao.NEVER_EXPIRE) ? (SaTokenDao.NEVER_EXPIRE) : (System.currentTimeMillis() + timeout * 1000));
	}

通过重写的此方法，对数据集dataMap,expireMap中的数据进行添加

/**
	 * 数据集合
	 */
	public Map<String, Object> dataMap = new ConcurrentHashMap<String, Object>();

	/**
	 * 过期时间集合 (单位: 毫秒) , 记录所有key的到期时间 [注意不是剩余存活时间]
	 */
	public Map<String, Long> expireMap = new ConcurrentHashMap<String, Long>();

写入最后操作时间,根据传入的值确定指定token

/**
 	 * 写入指定token的 [最后操作时间] 为当前时间戳
 	 * @param tokenValue 指定token
 	 */
 	protected void setLastActivityToNow(String tokenValue) {
 		// 如果token == null 或者 设置了[永不过期], 则立即返回
 		if(tokenValue == null || getConfig().getActivityTimeout() == SaTokenDao.NEVER_EXPIRE) {
 			return;
 		}
 		// 将[最后操作时间]标记为当前时间戳
 		SaManager.getSaTokenDao().set(splicingKeyLastActivityTime(tokenValue), String.valueOf(System.currentTimeMillis()), getConfig().getTimeout());
 	}

如果token已经是永不过期或者是空，就不做任何操作直接返回，否则就把时间戳写入作为token的最后操作时间

在当前会话写入当前tokenValue

/**
 	 * 在当前会话写入当前tokenValue
 	 * @param tokenValue token值
 	 * @param cookieTimeout Cookie存活时间(秒)
 	 */
	public void setTokenValue(String tokenValue, int cookieTimeout){
		SaTokenConfig config = getConfig();
		// 将token保存到[存储器]里
		SaStorage storage = SaHolder.getStorage();
		// 判断是否配置了token前缀
		String tokenPrefix = config.getTokenPrefix();
		if(SaFoxUtil.isEmpty(tokenPrefix)) {
			storage.set(splicingKeyJustCreatedSave(), tokenValue);
		} else {
			// 如果配置了token前缀，则拼接上前缀一起写入
			storage.set(splicingKeyJustCreatedSave(), tokenPrefix + SaTokenConsts.TOKEN_CONNECTOR_CHAT + tokenValue);
		}

		// 注入Cookie
		if(config.getIsReadCookie() == true){
			SaResponse response = SaHolder.getResponse();
			response.addCookie(getTokenName(), tokenValue, "/", config.getCookieDomain(), cookieTimeout);
		}
	}

将加了前缀后的token写入到容器中，并且将加了前缀的token和传入的Cookie存活时间一起出入Cookie

最终调用SaTokenListener接口中的doLogin方法

/**
	 * 每次登录时触发
	 * @param loginKey 账号类别
	 * @param loginId 账号id
	 * @param loginModel 登录参数
	 */
	public void doLogin(String loginKey, Object loginId, SaLoginModel loginModel);

SaTokenListenerDefaultImpl方法实现了该接口，并且重写了该方法：

/**

* 每次登录时触发

*/

@Override

public void doLogin(String loginKey, Object loginId, SaLoginModel loginModel) {

println("账号[" + loginId + "]登录成功");

}

---

2.StpUtil.isLogin();

访问页面时，可以调用此方法直接判断该用户是否登录

开始浏览源码：

/**
 	 * 获取当前会话是否已经登录
 	 * @return 是否已登录
 	 */
	public static boolean isLogin() {
		return stpLogic.isLogin();
	}

可以看到，该方法调用了stpLogic.isLogin()方法，如果已登录返回true，否则为false

（什么是stpLogic?)见此文档源码解析1下

继续深入

/**
 	 * 获取当前会话是否已经登录
 	 * @return 是否已登录
 	 */
 	public boolean isLogin() {
 		// 判断条件：不为null，并且不在异常项集合里
 		return getLoginIdDefaultNull() != null;
 	}

getLoginIdDefaultNull()返回对应情况的loginId，如果有值并且不在异常项集合里则isLogin判断为已登录，否则就判断为未登录

查看getLoginIdDefaultNull()具体判断

/**
	 * 获取当前会话登录id, 如果未登录，则返回null
	 * @return 账号id
	 */
	public Object getLoginIdDefaultNull() {
		// 如果正在[临时身份切换]
		if(isSwitch()) {
			return getSwitchLoginId();
		}
		// 如果连token都是空的，则直接返回
		String tokenValue = getTokenValue();
 		if(tokenValue == null) {
 			return null;
 		}
 		// loginId为null或者在异常项里面，均视为未登录, 返回null
 		Object loginId = getLoginIdNotHandle(tokenValue);
 		if(loginId == null || NotLoginException.ABNORMAL_LIST.contains(loginId)) {
 			return null;
 		}
 		// 如果已经[临时过期]
 		if(getTokenActivityTimeoutByToken(tokenValue) == SaTokenDao.NOT_VALUE_EXPIRE) {
 			return null;
 		}
 		// 执行到此，证明loginId已经是个正常的账号id了
 		return loginId;
 	}

- 首先判断是否在身份互换

/**
	 * 当前是否正处于[身份临时切换]中
	 * @return 是否正处于[身份临时切换]中
	 */
	public boolean isSwitch() {
		return SaHolder.getStorage().get(splicingKeySwitch()) != null;
	}

调用了splicingKeySwitch()返回一个字符串作为SaHolder.getStorage().get()的key

---

什么是SaHolder.getStorage()？

SaHolder是sa-Token的上下文持有类

其中的getStorage()实现了返回当前请求存储器的对象（底层容器操作Bean实现）

public static SaStorage getStorage() {
	return SaManager.getSaTokenContext().getStorage();
}

---

继续深入splicingKeySwitch()

/**
	 * 在进行身份切换时，使用的存储key
	 * @return key
	 */
	public String splicingKeySwitch() {
		return SaTokenConsts.SWITCH_TO_SAVE_KEY + loginKey;
	}

返回一个常量+loginKey格式的字符串

/**
	 * 常量key标记: 在进行临时身份切换时使用的key
	 */
	public static final String SWITCH_TO_SAVE_KEY = "SWITCH_TO_SAVE_KEY_";

如果可以在容器中取到对应key的值，则表示为正在临时身份互换，否则没有进行临时身份互换

若进行了临时身份互换则返回临时互换身份的loginId：

/**
	 * 返回[身份临时切换]的loginId
	 * @return 返回[身份临时切换]的loginId
	 */
	public Object getSwitchLoginId() {
		return SaHolder.getStorage().get(splicingKeySwitch());
	}

同样根据拼接的字符串作为SaHolder类中获取的容器对象取值的key，返回相对应的值也就是互换身份的临时loginId

- 取到token进行判断

通过getTokenValue()取到当前的token值

/**
	 * 获取当前tokenValue
	 * @return 当前tokenValue
	 */
	public String getTokenValue(){
		// 0. 获取相应对象
		SaStorage storage = SaHolder.getStorage();
		SaRequest request = SaHolder.getRequest();
		SaTokenConfig config = getConfig();
		String keyTokenName = getTokenName();
		String tokenValue = null;

		// 1. 尝试从Storage里读取
		if(storage.get(splicingKeyJustCreatedSave()) != null) {
			tokenValue = String.valueOf(storage.get(splicingKeyJustCreatedSave()));
		}
		// 2. 尝试从请求体里面读取
		if(tokenValue == null && config.getIsReadBody()){
			tokenValue = request.getParameter(keyTokenName);
		}
		// 3. 尝试从header里读取
		if(tokenValue == null && config.getIsReadHead()){
			tokenValue = request.getHeader(keyTokenName);
		}
		// 4. 尝试从cookie里读取
		if(tokenValue == null && config.getIsReadCookie()){
			tokenValue = request.getCookieValue(keyTokenName);
		}

		// 5. 如果打开了前缀模式
		String tokenPrefix = getConfig().getTokenPrefix();
		if(SaFoxUtil.isEmpty(tokenPrefix) == false && SaFoxUtil.isEmpty(tokenValue) == false) {
			// 如果token以指定的前缀开头, 则裁剪掉它, 否则视为未提供token
			if(tokenValue.startsWith(tokenPrefix + SaTokenConsts.TOKEN_CONNECTOR_CHAT)) {
				tokenValue = tokenValue.substring(tokenPrefix.length() + SaTokenConsts.TOKEN_CONNECTOR_CHAT.length());
			} else {
				tokenValue = null;
			}
		}

		// 6. 返回
		return tokenValue;
	}

取值方法为：

首先获取相对应的对象：SaStorage,SaRequest,SaTokenConfig,keyTokenName,tokenValue

分别从Storage,请求体，header,cookie中获取token值（tokenValue)

再判断是否打开了前缀模式：如果打开了并且token值为空就继续判断token是否以指定的前缀开头, 是则裁剪掉它, 否则视为未提供token（token置空）

返回token值

对返回的token值进行判断，若为空，则返回空，即getLoginIdDefaultNull()判断此用户未登录

-对LoginId判断

/**
 	  * 获取指定token对应的登录id (不做任何特殊处理)
 	  * @param tokenValue token值
 	  * @return loginId
 	  */
 	public String getLoginIdNotHandle(String tokenValue) {
 		return SaManager.getSaTokenDao().get(splicingKeyTokenValue(tokenValue));
 	}

通过调用getLoginIdNotHandle(String token)，返回传入token对应的lginId

使用splicingKeyTokenValue(tokenValue)，返回一个常量和token拼接的字符串作为SaManager.getSaTokenDao().get()的key，并且返回查询到的loginId

---

什么是SaManager？

/**
 * 管理sa-token所有接口对象
 * @author kong
 *
 */
public class SaManager

是用来管理所有接口的对象

---

SaTokenDaoDefaultImpl类实现了SaTokenDao接口并重写了get方法：

@Override
	public String get(String key) {
		clearKeyByTimeout(key);
		return (String)dataMap.get(key);
	}

通过传入的key，先判断是否已经过期，之后返回在数据集dataMap中查询到的相应的loginId

（详细操作在本文档中源码分析1中解析过）

对获取到的loginId进行判断是否是空或者被异常项包括

(异常项：public class NotLoginException extends SaTokenException ，一个异常，代表用户没有登录)

如果满足，则说明该用户没有登录，直接返回null

-对是否临近过期进行判断

/**
 	 * 获取指定token[临时过期]剩余有效时间 (单位: 秒)
 	 * @param tokenValue 指定token
 	 * @return token[临时过期]剩余有效时间
 	 */
 	public long getTokenActivityTimeoutByToken(String tokenValue) {
 		// 如果token为null , 则返回 -2
 		if(tokenValue == null) {
 			return SaTokenDao.NOT_VALUE_EXPIRE;
 		}
 		// 如果设置了永不过期, 则返回 -1
 		if(getConfig().getActivityTimeout() == SaTokenDao.NEVER_EXPIRE) {
 			return SaTokenDao.NEVER_EXPIRE;
 		}
 		// ------ 开始查询
 		// 获取相关数据
 		String keyLastActivityTime = splicingKeyLastActivityTime(tokenValue);
 		String lastActivityTimeString = SaManager.getSaTokenDao().get(keyLastActivityTime);
 		// 查不到，返回-2
 		if(lastActivityTimeString == null) {
 			return SaTokenDao.NOT_VALUE_EXPIRE;
 		}
 		// 计算相差时间
 		long lastActivityTime = Long.valueOf(lastActivityTimeString);
 		long apartSecond = (System.currentTimeMillis() - lastActivityTime) / 1000;
 		long timeout = getConfig().getActivityTimeout() - apartSecond;
 		// 如果 < 0， 代表已经过期 ，返回-2
 		if(timeout < 0) {
 			return SaTokenDao.NOT_VALUE_EXPIRE;
 		}
 		return timeout;
 	}

该方法对传入的token的相应情况设定了不同的返回值

getTokenActivityTimeoutByToken()的返回值与常量（-2）

/** 常量(在对不存在的key获取剩余存活时间时返回此值) */ public static final long NOT_VALUE_EXPIRE = -2;

进行比对，如果相等，即该用户的token为空（未登录），或者满足剩余时间不足的条件，直接返回null

-最后返回loginId

如果可以执行到此，证明loginId已经是个正常的账号id了 ，直接返回loginId即可。

---

END