docs: 升级“临时 Token 认证”章节文档

sa-token-doc/_sidebar.md

@@ -83,7 +83,7 @@
 
 - **插件**
 	- [AOP注解鉴权](/plugin/aop-at)
-	- [临时Token认证](/plugin/temp-token)
+	- [临时 Token 认证](/plugin/temp-token)
 	- [Quick-Login快速登录插件](/plugin/quick-login)
 	- [Alone独立Redis插件](/plugin/alone-redis)
 	- [缓存层扩展](/plugin/dao-extend)

sa-token-doc/plugin/temp-token.md

@@ -1,12 +1,12 @@
-# 临时Token令牌认证  
+# 临时 Token 令牌认证  
 
 ---
 
-### 适用场景 
+### 1、适用场景 
 
-在部分业务场景，我们需要一种临时授权的能力，即：一个token的有效期并不需要像登录有效期那样需要[七天、三十天]，而是仅仅需要 [五分钟、半小时]
+在部分业务场景，我们需要一种临时授权的能力，即：一个token的有效期并不需要像登录有效期那样需要[七天、三十天]，而是仅仅需要 [五分钟、半小时]。
 
-举个比较明显的例子：超链接邀请机制 
+举个比较明显的例子：超链接邀请机制。
 
 比如说你在一个游戏中创建一个公会 `(id=10014)`，现在你想邀请你的好朋友加入这个公会，在你点击 **`[邀请]`** 按钮时，系统为你生成一个连接: 
 
@@ -14,13 +14,13 @@
 http://xxx.com/apply?id=10014
 ```
 
-接着，你的好朋友点击这个链接，加入了你的工会
+接着，你的好朋友点击这个链接，加入了你的工会。
 
-那么，系统是如何识别这个链接对应的工会是10014呢？很明显，我们可以观察出，这个链接的尾部有个id参数值为10014，这便是系统识别的关键
+那么，系统是如何识别这个链接对应的工会是10014呢？很明显，我们可以观察出，这个链接的尾部有个id参数值为10014，这便是系统识别的关键。
 
 此时你可能眉头一紧，就这么简单？那我如果手动更改一下尾部的参数改成10015，然后我再一点，岂不是就可以偷偷加入别人的工会了？
 
-你想的没错，如果这个游戏的架构设计者采用上述方案完成功能的话，这个邀请机制就轻松的被你攻破了
+你想的没错，如果这个游戏的架构设计者采用上述方案完成功能的话，这个邀请机制就轻松的被你攻破了。
 
 但是很明显，正常的商业项目一般不会拉跨到这种地步，比较常见的方案是，对这个公会id做一个token映射，最终你看到链接一般是这样的：
 
@@ -28,16 +28,16 @@ http://xxx.com/apply?id=10014
 http://xxx.com/apply?token=oEwQBnglXDoGraSJdGaLooPZnGrk
 ```
 
-后面那一串字母是乱打出来的，目的是为了突出它的随机性，即：使用一个随机的token来代替明文显示真正的数据
+后面那一串字母是乱打出来的，目的是为了突出它的随机性，即：使用一个随机的token来代替明文显示真正的数据。
 
-在用户点击这个链接之后，服务器便可根据这个token解析出真正公会id (10014) ，至于伪造？全是随机的你怎么伪造？你又不知道10015会随机出一个什么样的Token 
+在用户点击这个链接之后，服务器便可根据这个token解析出真正公会id (10014) ，至于伪造？全是随机的你怎么伪造？你又不知道10015会随机出一个什么样的Token 。
 
-而且为了安全性，这个token的有效期一般不会太长，给你预留五分钟、半小时的时间足够你点击它即可
+而且为了安全性，这个token的有效期一般不会太长，给你预留五分钟、半小时的时间足够你点击它即可。
 
 
-### 相关API 
+### 2、创建临时 token
 
-**[sa-token-temp临时认证模块]** 已内嵌到核心包，无需引入其它依赖即可使用
+**[sa-token-temp 临时 token 认证模块]** 已内嵌到核心包，无需引入其它依赖即可使用：
 
 ``` java
 // 根据 value 创建一个 token 
@@ -54,7 +54,42 @@ SaTempUtil.deleteToken(token);
 ```
 
 
-### 集成jwt
+### 3、前缀拼接与裁剪
+
+``` java
+// 如果由多条业务线都需要生成临时 token，可以加个前缀进行区分
+String token = SaTempUtil.createToken("shop_1001", 1200);
+```
+
+在获取时可以自行裁剪前缀，也可以调用：
+``` java
+// 解析 token 获取 value，并裁剪指定前缀，然后转换为指定类型
+SaTempUtil.parseToken(token, "shop_", Long.class)
+```
+
+如果指定了错误的前缀，即使 token 正确，上述方法也将返回 null 
+
+
+### 4、根据 value 反查 token
+
+在创建 token 时，框架默认只会保存 `token -> value` 的映射，而不会记录 `value -> token` 的索引信息。
+
+如果想要做到反查 token，则必须在创建 token 指定框架记录 token 索引信息：
+
+``` java
+// 在创建 token 时，指定第三个参数 true，即可让框架在保存 token 时同时记录 token 索引信息
+String token1 = SaTempUtil.createToken(10004, 1200, true);
+String token2 = SaTempUtil.createToken(10004, 1300, true);
+String token3 = SaTempUtil.createToken(10004, -1, true);
+
+// 获取 10004 对应的所有 token 
+List<String> list = SaTempUtil.getTempTokenList(10004);
+System.out.println(list);
+```
+
+
+
+### 5、集成jwt
 提到 [临时Token认证]，你是不是想到一个专门干这件事的框架？对，就是JWT！
 
 **[sa-token-temp]** 模块允许以JWT作为逻辑内核完成工作，你只需要引入以下依赖，所有上层API保持不变