v1.20.0 更新

dromara · Jun 16, 2021 · c6d3cda · c6d3cda
1 parent 1df8465
commit c6d3cda
Show file tree

Hide file tree

Showing 38 changed files with 81 additions and 51 deletions.
diff --git a/README.md b/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、小程序等前后台分离场景

diff --git a/pom.xml b/pom.xml
@@ -8,7 +8,7 @@
     <groupId>cn.dev33</groupId>
     <artifactId>sa-token-parent</artifactId>
 	<packaging>pom</packaging>
-	<version>1.19.0</version>
+	<version>1.20.0</version>
 
 	<!-- 项目介绍 -->
 	<name>sa-token</name>
@@ -36,7 +36,7 @@
 
 	<!-- 一些属性 -->
 	<properties>
-		<sa-token-version>1.19.0</sa-token-version>
+		<sa-token-version>1.20.0</sa-token-version>
         <jdk.version>1.8</jdk.version>
 		<project.build.sourceEncoding>utf-8</project.build.sourceEncoding>
 		<project.reporting.outputEncoding>utf-8</project.reporting.outputEncoding>

diff --git a/sa-token-core/pom.xml b/sa-token-core/pom.xml
@@ -7,7 +7,7 @@
 	<parent>
         <groupId>cn.dev33</groupId>
         <artifactId>sa-token-parent</artifactId>
-        <version>1.19.0</version>
+        <version>1.20.0</version>
     </parent>
     <packaging>jar</packaging>
 

diff --git a/sa-token-core/src/main/java/cn/dev33/satoken/temp/SaTempInterface.java b/sa-token-core/src/main/java/cn/dev33/satoken/temp/SaTempInterface.java
@@ -13,7 +13,7 @@ public interface SaTempInterface {
 	/**
 	 * 根据value创建一个token 
 	 * @param value 指定值
-	 * @param time 有效期，单位：秒 
+	 * @param timeout 有效期，单位：秒 
 	 * @return 生成的token
 	 */
 	public default String createToken(Object value, long timeout) {
@@ -43,6 +43,7 @@ public default Object parseToken(String token) {
 	 * 解析token获取value，并转换为指定类型 
 	 * @param token 指定token 
 	 * @param cs 指定类型 
+	 * @param <T> 默认值的类型 
 	 * @return  See Note 
 	 */
 	public default<T> T parseToken(String token, Class<T> cs) {

diff --git a/sa-token-core/src/main/java/cn/dev33/satoken/temp/SaTempUtil.java b/sa-token-core/src/main/java/cn/dev33/satoken/temp/SaTempUtil.java
@@ -12,7 +12,7 @@ public class SaTempUtil {
 	/**
 	 * 根据value创建一个token 
 	 * @param value 指定值
-	 * @param time 有效期，单位：秒 
+	 * @param timeout 有效期，单位：秒 
 	 * @return 生成的token
 	 */
 	public static String createToken(Object value, long timeout) {
@@ -32,6 +32,7 @@ public static Object parseToken(String token) {
 	 * 解析token获取value，并转换为指定类型 
 	 * @param token 指定token 
 	 * @param cs 指定类型 
+	 * @param <T> 默认值的类型 
 	 * @return  See Note 
 	 */
 	public static<T> T parseToken(String token, Class<T> cs) {

diff --git a/sa-token-core/src/main/java/cn/dev33/satoken/util/SaTokenConsts.java b/sa-token-core/src/main/java/cn/dev33/satoken/util/SaTokenConsts.java
@@ -13,7 +13,7 @@ public class SaTokenConsts {
 	/**
 	 * sa-token 当前版本号 
 	 */
-	public static final String VERSION_NO = "v1.19.0";
+	public static final String VERSION_NO = "v1.20.0";
 
 	/**
 	 * sa-token 开源地址 

diff --git a/sa-token-demo/sa-token-demo-jwt/pom.xml b/sa-token-demo/sa-token-demo-jwt/pom.xml
@@ -16,7 +16,7 @@
 
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.19.0</sa-token-version>
+		<sa-token-version>1.20.0</sa-token-version>
 	</properties>
 
 	<dependencies>

diff --git a/sa-token-demo/sa-token-demo-quick-login/pom.xml b/sa-token-demo/sa-token-demo-quick-login/pom.xml
@@ -15,7 +15,7 @@
 
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.19.0</sa-token-version>
+		<sa-token-version>1.20.0</sa-token-version>
 	</properties>
 
 	<dependencies>

diff --git a/sa-token-demo/sa-token-demo-solon/pom.xml b/sa-token-demo/sa-token-demo-solon/pom.xml
@@ -9,7 +9,7 @@
 
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.19.0</sa-token-version>
+		<sa-token-version>1.20.0</sa-token-version>
 	</properties>
 
 	<dependencies>

diff --git a/sa-token-demo/sa-token-demo-springboot/pom.xml b/sa-token-demo/sa-token-demo-springboot/pom.xml
@@ -16,7 +16,7 @@
 
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.19.0</sa-token-version>
+		<sa-token-version>1.20.0</sa-token-version>
 	</properties>
 
 	<dependencies>

diff --git a/sa-token-demo/sa-token-demo-springboot/src/main/java/com/pj/SaTokenDemoApplication.java b/sa-token-demo/sa-token-demo-springboot/src/main/java/com/pj/SaTokenDemoApplication.java
@@ -16,7 +16,6 @@ public class SaTokenDemoApplication {
 	public static void main(String[] args) {
 		SpringApplication.run(SaTokenDemoApplication.class, args);
 		System.out.println("\n启动成功：sa-token配置如下：" + SaManager.getConfig());
-		System.out.println("\n启动成功：sa-token配置如下：" + SaManager.getConfig());
 	}
 
 }
diff --git a/sa-token-demo/sa-token-demo-webflux/pom.xml b/sa-token-demo/sa-token-demo-webflux/pom.xml
@@ -16,7 +16,7 @@
 
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.19.0</sa-token-version>
+		<sa-token-version>1.20.0</sa-token-version>
 	</properties>
 
 	<dependencies>

diff --git 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、小程序等前后台分离场景

diff --git 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 @@ <h1 class="logo-text">Sa-Token</h1>
 		<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 @@ <h1 class="logo-text">Sa-Token</h1>
 		</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 @@ <h1 class="logo-text">Sa-Token</h1>
 		</script>
 		<script src="https://unpkg.zhimg.com/[email protected]/lib/docsify.min.js"></script>
 		<script src="https://unpkg.zhimg.com/[email protected]/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/[email protected]"></script>
 		<!-- img点击放大 -->

diff --git 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) 

diff --git 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`模块  **[重要]** 

diff --git 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>
 ```
 

diff --git 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>
 ```
 

diff --git 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>
 ```
 

diff --git 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 -->
 

diff --git 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>
 ```
 

diff --git 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>
 ```
 

diff --git 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序列化后可读性强，可灵活手动修改，缺点：兼容性稍差

diff --git 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();

diff --git 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` 
 
 	// 其它代码 ...