v1.20.0 更新

2025-10-20 18:47:25 +08:00 · 2021-06-16 20:24:23 +08:00
parent 1df8465e20
commit c6d3cda4a4
38 changed files with 81 additions and 51 deletions
--- a/sa-token-doc/doc/README.md
+++ b/sa-token-doc/doc/README.md
@@ -1,7 +1,7 @@
 <p align="center">
 	<img alt="logo" src="https://gitee.com/dromara/sa-token/raw/master/sa-token-doc/doc/logo.png" width="150" height="150">
 </p>
-<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">Sa-Token v1.19.0</h1>
+<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">Sa-Token v1.20.0</h1>
 <h4 align="center">这可能是史上功能最全的 Java 权限认证框架！</h4>
 <h4 align="center">
 	<a href="https://gitee.com/dromara/sa-token/stargazers"><img src="https://gitee.com/dromara/sa-token/badge/star.svg"></a>
@@ -51,6 +51,7 @@ Sa-Token是一个轻量级Java权限认证框架，主要解决：登录认证
 - **分布式会话** —— 提供jwt集成和共享数据中心两种分布式会话方案
 - **微服务网关鉴权** —— 适配Gateway、Soul、Zuul等常见网关组件的请求拦截认证
 - **单点登录** —— 一处登录，处处通行
+- **临时Token验证** —— 解决短时间的Token授权问题
 - **模拟他人账号** —— 实时操作任意用户状态数据
 - **临时身份切换** —— 将会话身份临时切换为其它账号
 - **无Cookie模式** —— APP、小程序等前后台分离场景
--- a/sa-token-doc/doc/index.html
+++ b/sa-token-doc/doc/index.html
@@ -4,7 +4,7 @@
 		<meta charset="UTF-8">
 		<title>sa-token</title>
 		<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
-		<meta name="description" content="sa-token是一个java权限认证框架，功能全面，上手简单，登录验证、权限验证、Session会话、踢人下线、账号封禁、集成Redis、前后台分离、分布式会话、微服务网关鉴权、单点登录、记住我模式、模拟他人账号、临时身份切换、多账号体系、注解式鉴权、路由拦截式鉴权、花式token、自动续签、同端互斥登录、会话治理、密码加密、jwt集成、Spring集成、WebFlux集成...，有了sa-token，你所有的权限认证问题，都不再是问题">
+		<meta name="description" content="sa-token是一个java权限认证框架，功能全面，上手简单，登录验证、权限验证、Session会话、踢人下线、账号封禁、集成Redis、前后台分离、分布式会话、微服务网关鉴权、单点登录、临时Token验证、记住我模式、模拟他人账号、临时身份切换、多账号体系、注解式鉴权、路由拦截式鉴权、花式token、自动续签、同端互斥登录、会话治理、密码加密、jwt集成、Spring集成、WebFlux集成...，有了sa-token，你所有的权限认证问题，都不再是问题">
 		<meta name="keywords" content="sa-token,sa-token框架,sa-token文档,java权限认证">
 		<meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
 		<link rel="shortcut icon" type="image/x-icon" href="logo.png">
@@ -21,6 +21,7 @@
 		<nav>
 			<select onchange="location.href=this.value">
 				<option value="http://sa-token.dev33.cn/doc/index.html">最新版</option>
+				<option value="http://sa-token.dev33.cn/v/v1.19.0/doc/index.html">v1.19.0</option>
 				<option value="http://sa-token.dev33.cn/v/v1.18.0/doc/index.html">v1.18.0</option>
 				<option value="http://sa-token.dev33.cn/v/v1.17.0/doc/index.html">v1.17.0</option>
 				<option value="http://sa-token.dev33.cn/v/v1.16.0/doc/index.html">v1.16.0</option>
@@ -49,7 +50,7 @@
 		</div>
 		<script>
 			var name = '<img style="width: 60px; height: 60px; vertical-align: middle;" src="logo.png" alt="logo" /> ';
-			name += '<b style="font-size: 28px; vertical-align: middle;">Sa-Token</b> <sub>v1.19.0</sub>'
+			name += '<b style="font-size: 28px; vertical-align: middle;">Sa-Token</b> <sub>v1.20.0</sub>'
 			window.$docsify = {
 				name: name, // 名字 
 				repo: 'https://github.com/dromara/sa-token', // github地址 
@@ -112,7 +113,7 @@
 		</script>
 		<script src="https://unpkg.zhimg.com/docsify@4.9.4/lib/docsify.min.js"></script>
 		<script src="https://unpkg.zhimg.com/docsify-copy-code@2.1.0/dist/docsify-copy-code.min.js"></script>
-		<script src="https://unpkg.zhimg.com/prismjs@1.19.0/components/prism-java.min.js"></script>
+		<script src="https://unpkg.zhimg.com/prismjs@1.20.0/components/prism-java.min.js"></script>
 		<script src="https://cdn.jsdelivr.net/npm/docsify/lib/plugins/search.min.js"></script>
 		<script src="https://unpkg.zhimg.com/docsify-tabs@1.4.4"></script>
 		<!-- img点击放大 -->
--- a/sa-token-doc/doc/more/common-action.md
+++ b/sa-token-doc/doc/more/common-action.md
@@ -52,7 +52,7 @@ tokenName=satoken
 # token有效期，单位s 默认30天, -1代表永不过期 
 timeout=2592000
 # token临时有效期 (指定时间内无操作就视为token过期) 单位: 秒
-activityTimeout
+activityTimeout=-1
 # 是否允许同一账号并发登录 (为true时允许一起登录, 为false时新登录挤掉旧登录) =-1
 isConcurrent=true
 # 在多人登录同一账号时，是否共用一个token (为true时所有登录共用一个token, 为false时每次登录新建一个token) 
--- a/sa-token-doc/doc/more/update-log.md
+++ b/sa-token-doc/doc/more/update-log.md
@@ -1,5 +1,27 @@
 # 更新日志 

+
+### 2021-5-10 @v1.20.0
+- 新增：新增Solon适配插件，感谢大佬 `@刘西东` 提供的pr **[重要]** 
+- 新增：新增`SaRouter.stop()`函数，用于一次性跳出匹配链功能 **[重要]** 
+- 新增：新增单元测试   **[重要]** 
+- 新增：新增临时令牌验证模块   **[重要]**  
+- 新增：新增`sa-token-temp-jwt`模块整合jwt临时令牌鉴权    **[重要]**  
+- 新增：会话 `SaSession.get()` 增加缓存API，简化代码 
+- 新增：新增框架调查问卷 
+- 修复：修复同时引入 `Spring Cloud Bus` 与 `Sa-Token` 冲突的问题   **[重要]** 
+- 修复：修复`SaServletFilter`异常函数中无法自定义`Content-Type`的问题 
+- 文档：新增微服务依赖引入说明 
+- 文档：新增认证流程图 
+- 不兼容更新重构：
+	- 方法：`StpUtil.setLoginId(id)` -> `StpUtil.login(id)` 
+	- 方法：`StpUtil.getLoginKey()` -> `StpUtil.getLoginType()` (注意其它所有地方的`LoginKey`均已更改为`loginType`)
+	- 工具类：`SaRouterUtil` -> `SaRouter` 
+	- 配置类：`allowConcurrentLogin` -> `isConcurrent` 
+	- 配置类：`isV` -> `isPrint` 
+	- 为保证平滑更新，旧API仍旧保留，但已增加`@Deprecated`注解，请尽快更新至新API  
+
+
 ### 2021-5-10 @v1.19.0
 - 新增：注解鉴权新增定制loginType功能  **[重要]** 
 - 重构：重构目录结构，抽离`plugin`模块  **[重要]** 
--- a/sa-token-doc/doc/plugin/aop-at.md
+++ b/sa-token-doc/doc/plugin/aop-at.md
@@ -11,7 +11,7 @@
 <dependency>
 	<groupId>cn.dev33</groupId>
 	<artifactId>sa-token-spring-aop</artifactId>
-	<version>1.19.0</version>
+	<version>1.20.0</version>
 </dependency>
 ```

--- a/sa-token-doc/doc/plugin/quick-login.md
+++ b/sa-token-doc/doc/plugin/quick-login.md
@@ -49,7 +49,7 @@ Sa-Token-Quick-Login的定位是这样的场景：你的项目需要一个登录
 <dependency>
 	<groupId>cn.dev33</groupId>
 	<artifactId>sa-token-quick-login</artifactId>
-	<version>1.19.0</version>
+	<version>1.20.0</version>
 </dependency>
 ```

--- a/sa-token-doc/doc/plugin/temp-token.md
+++ b/sa-token-doc/doc/plugin/temp-token.md
@@ -60,7 +60,7 @@ SaTempUtil.getTimeout(token);
 <dependency>
 	<groupId>cn.dev33</groupId>
 	<artifactId>sa-token-temp-jwt</artifactId>
-	<version>1.19.0</version>
+	<version>1.20.0</version>
 </dependency>
 ```

--- a/sa-token-doc/doc/start/download.md
+++ b/sa-token-doc/doc/start/download.md
@@ -14,7 +14,7 @@
 <dependency>
 	<groupId>cn.dev33</groupId>
 	<artifactId>sa-token-spring-boot-starter</artifactId>
-	<version>1.19.0</version>
+	<version>1.20.0</version>
 </dependency>
 ```

@@ -25,7 +25,7 @@
 <dependency>
 	<groupId>cn.dev33</groupId>
 	<artifactId>sa-token-reactor-spring-boot-starter</artifactId>
-	<version>1.19.0</version>
+	<version>1.20.0</version>
 </dependency>
 ```

@@ -36,7 +36,7 @@
 <dependency>
 	<groupId>cn.dev33</groupId>
 	<artifactId>sa-token-servlet</artifactId>
-	<version>1.19.0</version>
+	<version>1.20.0</version>
 </dependency>
 ```

@@ -47,7 +47,7 @@
 <dependency>
 	<groupId>cn.dev33</groupId>
 	<artifactId>sa-token-core</artifactId>
-	<version>1.19.0</version>
+	<version>1.20.0</version>
 </dependency>
 ```
 <!---------------------------- tabs:end ------------------------------>
@@ -57,19 +57,19 @@
 <!-- tabs:start -->
 <!-- tab:SpringMVC环境 （ServletAPI）  -->
 ``` xml
-implementation 'cn.dev33:sa-token-spring-boot-starter:1.19.0'
+implementation 'cn.dev33:sa-token-spring-boot-starter:1.20.0'
 ```
 <!-- tab:WebFlux环境 （Reactor）  -->
 ``` xml
-implementation 'cn.dev33:sa-token-reactor-spring-boot-starter:1.19.0'
+implementation 'cn.dev33:sa-token-reactor-spring-boot-starter:1.20.0'
 ```
 <!-- tab:Servlet容器环境  -->
 ``` xml
-implementation 'cn.dev33:sa-token-servlet:1.19.0'
+implementation 'cn.dev33:sa-token-servlet:1.20.0'
 ```
 <!-- tab:其它  -->
 ``` xml
-implementation 'cn.dev33:sa-token-core:1.19.0'
+implementation 'cn.dev33:sa-token-core:1.20.0'
 ```
 <!-- tabs:end -->

--- a/sa-token-doc/doc/start/example.md
+++ b/sa-token-doc/doc/start/example.md
@@ -17,7 +17,7 @@
 <dependency>
 	<groupId>cn.dev33</groupId>
 	<artifactId>sa-token-spring-boot-starter</artifactId>
-	<version>1.19.0</version>
+	<version>1.20.0</version>
 </dependency>
 ```

--- a/sa-token-doc/doc/start/webflux-example.md
+++ b/sa-token-doc/doc/start/webflux-example.md
@@ -19,7 +19,7 @@ WebFlux基于Reactor响应式模型开发，有着与标准ServletAPI完全不
 <dependency>
 	<groupId>cn.dev33</groupId>
 	<artifactId>sa-token-reactor-spring-boot-starter</artifactId>
-	<version>1.19.0</version>
+	<version>1.20.0</version>
 </dependency>
 ```

--- a/sa-token-doc/doc/use/dao-extend.md
+++ b/sa-token-doc/doc/use/dao-extend.md
@@ -14,7 +14,7 @@ Sa-token默认将会话数据保存在内存中，此模式读写速度最快，
 <dependency>
 	<groupId>cn.dev33</groupId>
 	<artifactId>sa-token-dao-redis</artifactId>
-	<version>1.19.0</version>
+	<version>1.20.0</version>
 </dependency>
 ```
 优点：兼容性好，缺点：Session序列化后基本不可读，对开发者来讲等同于乱码
@@ -26,7 +26,7 @@ Sa-token默认将会话数据保存在内存中，此模式读写速度最快，
 <dependency>
 	<groupId>cn.dev33</groupId>
 	<artifactId>sa-token-dao-redis-jackson</artifactId>
-	<version>1.19.0</version>
+	<version>1.20.0</version>
 </dependency>
 ```
 优点：Session序列化后可读性强，可灵活手动修改，缺点：兼容性稍差
--- a/sa-token-doc/doc/use/login-auth.md
+++ b/sa-token-doc/doc/use/login-auth.md
@@ -14,7 +14,7 @@
 ``` java
 // 标记当前会话登录的账号id 
 // 建议的参数类型：long | int | String， 不可以传入复杂类型，如：User、Admin等等
-StpUtil.login(Object id);	
+StpUtil.login(Object id);	 

 // 当前会话注销登录
 StpUtil.logout();
--- a/sa-token-doc/doc/use/many-account.md
+++ b/sa-token-doc/doc/use/many-account.md
@@ -33,7 +33,7 @@ public class StpUserUtil {
 	/**
 	 * 账号体系标识 
 	 */
-	public static final String KEY = "user";	// 将 LoginType 从`login`改为`user` 
+	public static final String TYPE = "user";	// 将 LoginType 从`login`改为`user` 

 	// 其它代码 ...