v1.31.0 update

2025-09-19 10:08:07 +08:00 · 2022-09-08 10:38:56 +08:00
parent cb31c61efd
commit 80779da057
29 changed files with 62 additions and 37 deletions
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 <p align="center">
 	<img alt="logo" src="https://sa-token.dev33.cn/doc/logo.png" width="150" height="150">
 </p>
-<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">Sa-Token v1.31.0.RC</h1>
+<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">Sa-Token v1.31.0</h1>
 <h4 align="center">一个轻量级 Java 权限认证框架，让鉴权变得简单、优雅！</h4>
 <p align="center">
 	<a href="https://gitee.com/dromara/sa-token/stargazers"><img src="https://gitee.com/dromara/sa-token/badge/star.svg?theme=gvp"></a>
--- a/pom.xml
+++ b/pom.xml
@@ -37,7 +37,7 @@
 	
 	<!-- 一些属性 -->
 	<properties>
-		<revision>1.31.0.RC</revision>
+		<revision>1.31.0</revision>
        <jdk.version>1.8</jdk.version>
 		<project.build.sourceEncoding>utf-8</project.build.sourceEncoding>
 		<project.reporting.outputEncoding>utf-8</project.reporting.outputEncoding>
--- 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
@@ -15,7 +15,7 @@ public class SaTokenConsts {
 	/**
 	 * Sa-Token 当前版本号 
 	 */
-	public static final String VERSION_NO = "v1.31.0.RC";
+	public static final String VERSION_NO = "v1.31.0";

 	/**
 	 * Sa-Token 开源地址 Gitee 
--- a/sa-token-demo/sa-token-demo-alone-redis/pom.xml
+++ b/sa-token-demo/sa-token-demo-alone-redis/pom.xml
@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.31.0.RC</sa-token-version>
+		<sa-token-version>1.31.0</sa-token-version>
 	</properties>

 	<dependencies>
--- a/sa-token-demo/sa-token-demo-dubbo-consumer/pom.xml
+++ b/sa-token-demo/sa-token-demo-dubbo-consumer/pom.xml
@@ -16,7 +16,7 @@
 	<properties> 
 		<java.version>1.8</java.version>
 		<maven-jar-plugin.version>3.1.1</maven-jar-plugin.version>
-		<sa-token-version>1.31.0.RC</sa-token-version>
+		<sa-token-version>1.31.0</sa-token-version>
 	</properties>
 	
 	<dependencies>
--- a/sa-token-demo/sa-token-demo-dubbo-provider/pom.xml
+++ b/sa-token-demo/sa-token-demo-dubbo-provider/pom.xml
@@ -16,7 +16,7 @@
 	<properties> 
 		<java.version>1.8</java.version>
 		<maven-jar-plugin.version>3.1.1</maven-jar-plugin.version>
-		<sa-token-version>1.31.0.RC</sa-token-version>
+		<sa-token-version>1.31.0</sa-token-version>
 	</properties>
 	
 	<dependencies>
--- a/sa-token-demo/sa-token-demo-grpc/pom.xml
+++ b/sa-token-demo/sa-token-demo-grpc/pom.xml
@@ -27,7 +27,7 @@
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <lombok.version>1.18.10</lombok.version>
-        <sa-token-version>1.31.0.RC</sa-token-version>
+        <sa-token-version>1.31.0</sa-token-version>
    </properties>

    <dependencies>
--- 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.31.0.RC</sa-token-version>
+		<sa-token-version>1.31.0</sa-token-version>
 	</properties>

 	<dependencies>
--- a/sa-token-demo/sa-token-demo-oauth2-client/pom.xml
+++ b/sa-token-demo/sa-token-demo-oauth2-client/pom.xml
@@ -17,7 +17,7 @@
 		<java.version>1.8</java.version>
 		<maven-jar-plugin.version>3.1.1</maven-jar-plugin.version>
 		<!-- 定义sa-token版本号 -->
-		<sa-token-version>1.31.0.RC</sa-token-version>
+		<sa-token-version>1.31.0</sa-token-version>
 	</properties>
 	
 	<dependencies>
--- a/sa-token-demo/sa-token-demo-oauth2-server/pom.xml
+++ b/sa-token-demo/sa-token-demo-oauth2-server/pom.xml
@@ -17,7 +17,7 @@
 		<java.version>1.8</java.version>
 		<maven-jar-plugin.version>3.1.1</maven-jar-plugin.version>
 		<!-- 定义sa-token版本号 -->
-		<sa-token-version>1.31.0.RC</sa-token-version>
+		<sa-token-version>1.31.0</sa-token-version>
 	</properties>
 	
 	<dependencies>
--- a/sa-token-demo/sa-token-demo-quick-login/pom.xml
+++ b/sa-token-demo/sa-token-demo-quick-login/pom.xml
@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.31.0.RC</sa-token-version>
+		<sa-token-version>1.31.0</sa-token-version>
 	</properties>

 	<dependencies>
--- 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.31.0.RC</sa-token-version>
+		<sa-token-version>1.31.0</sa-token-version>
 	</properties>

 	<dependencies>
--- a/sa-token-demo/sa-token-demo-springboot-redis/pom.xml
+++ b/sa-token-demo/sa-token-demo-springboot-redis/pom.xml
@@ -17,7 +17,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.31.0.RC</sa-token-version>
+		<sa-token-version>1.31.0</sa-token-version>
 	</properties>

 	<dependencies>
--- a/sa-token-demo/sa-token-demo-springboot/pom.xml
+++ b/sa-token-demo/sa-token-demo-springboot/pom.xml
@@ -17,7 +17,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.31.0.RC</sa-token-version>
+		<sa-token-version>1.31.0</sa-token-version>
 	</properties>

 	<dependencies>
--- a/sa-token-demo/sa-token-demo-sso-server/pom.xml
+++ b/sa-token-demo/sa-token-demo-sso-server/pom.xml
@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.31.0.RC</sa-token-version>
+		<sa-token-version>1.31.0</sa-token-version>
 	</properties>

 	<dependencies>
--- a/sa-token-demo/sa-token-demo-sso1-client/pom.xml
+++ b/sa-token-demo/sa-token-demo-sso1-client/pom.xml
@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.31.0.RC</sa-token-version>
+		<sa-token-version>1.31.0</sa-token-version>
 	</properties>

 	<dependencies>
--- a/sa-token-demo/sa-token-demo-sso2-client/pom.xml
+++ b/sa-token-demo/sa-token-demo-sso2-client/pom.xml
@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.31.0.RC</sa-token-version>
+		<sa-token-version>1.31.0</sa-token-version>
 	</properties>

 	<dependencies>
--- a/sa-token-demo/sa-token-demo-sso3-client/pom.xml
+++ b/sa-token-demo/sa-token-demo-sso3-client/pom.xml
@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.31.0.RC</sa-token-version>
+		<sa-token-version>1.31.0</sa-token-version>
 	</properties>

 	<dependencies>
--- a/sa-token-demo/sa-token-demo-thymeleaf/pom.xml
+++ b/sa-token-demo/sa-token-demo-thymeleaf/pom.xml
@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.31.0.RC</sa-token-version>
+		<sa-token-version>1.31.0</sa-token-version>
 	</properties>

 	<dependencies>
--- 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.31.0.RC</sa-token-version>
+		<sa-token-version>1.31.0</sa-token-version>
 	</properties>

 	<dependencies>
--- a/sa-token-demo/sa-token-demo-websocket-spring/pom.xml
+++ b/sa-token-demo/sa-token-demo-websocket-spring/pom.xml
@@ -17,7 +17,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.31.0.RC</sa-token-version>
+		<sa-token-version>1.31.0</sa-token-version>
 	</properties>

 	<dependencies>
--- a/sa-token-demo/sa-token-demo-websocket/pom.xml
+++ b/sa-token-demo/sa-token-demo-websocket/pom.xml
@@ -17,7 +17,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.31.0.RC</sa-token-version>
+		<sa-token-version>1.31.0</sa-token-version>
 	</properties>

 	<dependencies>
--- 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://sa-token.dev33.cn/doc/logo.png" width="150" height="150">
 </p>
-<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">Sa-Token v1.31.0.RC</h1>
+<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">Sa-Token v1.31.0</h1>
 <h5 align="center">一个轻量级 Java 权限认证框架，让鉴权变得简单、优雅！</h5>
 <p align="center" class="badge-box">
 	<a href="https://gitee.com/dromara/sa-token/stargazers"><img src="https://gitee.com/dromara/sa-token/badge/star.svg?theme=gvp"></a>
--- a/sa-token-doc/doc/api/stp-util.md
+++ b/sa-token-doc/doc/api/stp-util.md
@@ -152,14 +152,34 @@ StpUtil.searchTokenSessionId(keyword, start, size, sortType);   // 根据条件

 ### 11、账号封禁
 ``` java
-StpUtil.disable(10001, 1200);   // 封禁指定账号 
-StpUtil.disable(10001);   // 指定账号是否已被封禁 (true=已被封禁, false=未被封禁) 
-StpUtil.getDisableTime(10001);   // 获取指定账号剩余封禁时间，单位：秒（-1=永久封禁，-2=未被封禁）
-StpUtil.untieDisable(loginId);   // 解封指定账号
+StpUtil.disable(10001, 1200);   // 封禁：指定账号
+StpUtil.isDisable(10001);   // 判断：指定账号是否已被封禁 (true=已被封禁, false=未被封禁) 
+StpUtil.checkDisable(10001);   // 校验：指定账号是否已被封禁，如果被封禁则抛出异常 `DisableServiceException`
+StpUtil.getDisableTime(10001);   // 获取：指定账号剩余封禁时间，单位：秒（-1=永久封禁，-2=未被封禁）
+StpUtil.untieDisable(loginId);   // 解封：指定账号
 ```


-### 12、身份切换
+### 12、分类封禁
+``` java
+StpUtil.disable(10001, "<业务标识>", 86400);   // 封禁：指定账号的指定服务 
+StpUtil.isDisable(10001, "<业务标识>");   // 判断：指定账号的指定服务 是否已被封禁 (true=已被封禁, false=未被封禁) 
+StpUtil.checkDisable(10001, "<业务标识>");   // 校验：指定账号的指定服务 是否已被封禁，如果被封禁则抛出异常 `DisableServiceException`
+StpUtil.getDisableTime(10001, "<业务标识>");   // 获取：指定账号的指定服务 剩余封禁时间，单位：秒（-1=永久封禁，-2=未被封禁）
+StpUtil.untieDisable(loginId, "<业务标识>");   // 解封：指定账号的指定服务
+```
+
+
+### 13、阶梯封禁
+``` java
+StpUtil.disableLevel(10001, "comment", 3, 10000);   // 分类阶梯封禁，参数：封禁账号、封禁服务、封禁级别、封禁时间 
+StpUtil.getDisableLevel(10001, "comment");   // 获取：指定账号的指定服务 封禁的级别 （如果此账号未被封禁则返回 -2）
+StpUtil.isDisableLevel(10001, "comment", 3);   // 判断：指定账号的指定服务 是否已被封禁到指定级别，返回 true 或 false
+StpUtil.checkDisableLevel(10001, "comment", 2);   // 校验：指定账号的指定服务 是否已被封禁到指定级别（例如 comment服务 已被3级封禁，这里校验是否达到2级），如果已达到此级别，则抛出异常 
+```
+
+
+### 14、身份切换
 ``` java
 StpUtil.switchTo(10044);   // 临时切换身份为指定账号id 
 StpUtil.endSwitch();   // 结束临时切换身份
@@ -168,7 +188,7 @@ StpUtil.switchTo(10044, () -> {});   // 在一个代码段里方法内，临时
 ```


-### 13、二级认证
+### 15、二级认证
 ``` java
 StpUtil.openSafe(safeTime);   // 在当前会话 开启二级认证 
 StpUtil.isSafe();   // 当前会话 是否处于二级认证时间内 
--- a/sa-token-doc/doc/index-backup.html
+++ b/sa-token-doc/doc/index-backup.html
@@ -19,7 +19,7 @@
 					<div class="logo-box">
 						<img src="logo.png" title="logo" />
 						<h1 class="logo-text">Sa-Token</h1>
-						<sub>v1.31.0.RC</sub>
+						<sub>v1.31.0</sub>
 					</div>
 				</a>
 			</div>
@@ -114,7 +114,7 @@
 		<!--  -->
 		<script src="./lib/docsify-plugin.js"></script>
 		<script>
-			var saTokenTopVersion = '1.31.0.RC';	// Sa-Token最新版本 
+			var saTokenTopVersion = '1.31.0';	// Sa-Token最新版本 
 			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>v' + saTokenTopVersion + '</sub>';
 			window.$docsify = {
--- a/sa-token-doc/doc/index.html
+++ b/sa-token-doc/doc/index.html
@@ -20,7 +20,7 @@
 					<div class="logo-box">
 						<img src="logo.png" title="logo" />
 						<h1 class="logo-text">Sa-Token</h1>
-						<sub>v1.31.0.RC</sub>
+						<sub>v1.31.0</sub>
 					</div>
 				</a>
 			</div>
@@ -116,7 +116,7 @@
 		<!--  -->
 		<script src="./lib/docsify-plugin.js"></script>
 		<script>
-			var saTokenTopVersion = '1.31.0.RC';	// Sa-Token最新版本 
+			var saTokenTopVersion = '1.31.0';	// Sa-Token最新版本 
 			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>v' + saTokenTopVersion + '</sub>';
 			window.$docsify = {
--- a/sa-token-doc/doc/more/update-log.md
+++ b/sa-token-doc/doc/more/update-log.md
@@ -1,7 +1,7 @@
 # 更新日志 


-### 2022-8-29 @v1.31.0
+### 2022-9-8 @v1.31.0
 - 文档：新增优秀开源案例展示。
 - 文档：新增博客展示，欢迎大家投稿。 
 - 新增：新增 `SaInterceptor` 综合拦截器。   **[重要]**  **[不向下兼容]**
@@ -16,10 +16,13 @@
 - 修复：解决当权限码为 null 时可能带来的空指针问题。
 - 新增：新增 `StpUtil.getExtra(tokenValue, key)` 方法，用于获取任意 token 的扩展参数。 
 - 优化：优化 `StpLogic#logoutByTokenValue` 方法逻辑，精简代码。
+- 重构：`SaTokenConfig` 配置类字段 `isReadHead` 改为 `isReadHeader`。 **[不向下兼容]** 
 - 修复：修复部分场景下踢人下线会抛出异常 `非Web上下文无法获取Request` 的问题。 
 - 新增：新增方法 `StpLogic#getAnonTokenSession`，可在未登录情况下安全的获取 Token-Session。  **[重要]** 
 - 新增：新增 `SaApplication` 对象，用于全局作用域存取值。   **[重要]** 
 - 重构：将 `SaTokenListener` 改为事件发布订阅模式，允许同时注册多个侦听器。  **[重要]**  **[不向下兼容]**
+- 重构：StpUtil.login(id) 不再强制校验账号是否禁用，需要手动校验。 **[不向下兼容]** 
+- 重构：新增对账号限制、分类封禁、阶梯封禁功能。	 **[重要]** 
 - 新增：会话查询API增加反序获取会话方式。
 - 新增：SSO模块增加 server-url 属性，用于简化各种 url 配置。  **[重要]**
 - 修复：修复单点登录模块 `ssoLogoutCall` 配置项无效的问题。 
@@ -31,9 +34,11 @@
 - 重构：`sa-token-jwt` 模块改为 `Util + Template` 形式，方便针对部分代码重写。  **[重要]** 
 - 新增：在线文档添加API手册。
 - 重构：`sa-token-oauth2` 模块密码模式新增 `client_secret` 参数校验。**[不向下兼容]** 
+- 新增：集成 `jacoco` 插件，核心包单元测试覆盖率提高至 90% 以上。
 - 优化：开源案例分离专属仓库：[Awesome-Sa-Token](https://gitee.com/sa-token/awesome-sa-token)


+
 ### 2022-05-9 @v1.30.0
 - 新增：新增集成 Web-Socket 鉴权示例。 **[重要]**
 - 新增：新增集成 Web-Socket（Spring封装版） 鉴权示例。
--- a/sa-token-doc/doc/up/disable.md
+++ b/sa-token-doc/doc/up/disable.md
@@ -37,7 +37,7 @@ StpUtil.checkDisable(10001);
 StpUtil.login(10001); 
 ```

-!> 旧版本在 `StpUtil.login()` 时会自动校验账号是否被封禁，新版本将 校验封禁 和 登录 两个动作分离成两个方法，不再自动校验，请注意其中的逻辑更改。
+!> 旧版本在 `StpUtil.login()` 时会自动校验账号是否被封禁，v1.31.0 之后将 校验封禁 和 登录 两个动作分离成两个方法，不再自动校验，请注意其中的逻辑更改。

 此模块所有方法：
 ``` java
--- a/sa-token-doc/index.html
+++ b/sa-token-doc/index.html
@@ -23,7 +23,7 @@
 							<img src="./doc/logo.png" title="logo" />
 							<span class="logo-text">Sa-Token</span>
 							<!-- <h1 class="logo-text">Sa-Token</h1> -->
-							<!-- <sub>v1.31.0.RC</sub> -->
+							<!-- <sub>v1.31.0</sub> -->
 						</div>
 					</a>
 				</div>
@@ -70,7 +70,7 @@
 			<div class="main-box">
 				<div class="content-box">
 					<!-- <div class="fenge"></div> -->
-					<h1>Sa-Token<small>v1.31.0.RC</small></h1>
+					<h1>Sa-Token<small>v1.31.0</small></h1>
 					<div class="sub-title">一个轻量级 java 权限认证框架，让鉴权变得简单、优雅！</div>
 					<div class="btn-box">
 						<a class="abtn" href="https://github.com/dromara/sa-token" target="_blank">GitHub</a>