v1.31.0.RC 发布

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.30.0</h1>
+<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">Sa-Token v1.31.0.RC</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>

pom.xml

@@ -37,7 +37,7 @@
 	
 	<!-- 一些属性 -->
 	<properties>
-		<revision>1.30.0</revision>
+		<revision>1.31.0.RC</revision>
         <jdk.version>1.8</jdk.version>
 		<project.build.sourceEncoding>utf-8</project.build.sourceEncoding>
 		<project.reporting.outputEncoding>utf-8</project.reporting.outputEncoding>

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.30.0";
+	public static final String VERSION_NO = "v1.31.0.RC";
 
 	/**
 	 * Sa-Token 开源地址 Gitee 

sa-token-demo/sa-token-demo-alone-redis/pom.xml

@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>

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

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

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.30.0</sa-token-version>
+        <sa-token-version>1.31.0.RC</sa-token-version>
     </properties>
 
     <dependencies>
@@ -48,7 +48,7 @@
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-data-redis</artifactId>
-            <version>2.7.2</version>
+            <!-- <version>2.7.2</version> -->
         </dependency>
 
         <dependency>

sa-token-demo/sa-token-demo-jwt/pom.xml

@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>

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

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

sa-token-demo/sa-token-demo-quick-login/pom.xml

@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>

sa-token-demo/sa-token-demo-solon/pom.xml

@@ -9,7 +9,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>

sa-token-demo/sa-token-demo-springboot-redis/pom.xml

@@ -17,7 +17,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>

sa-token-demo/sa-token-demo-springboot/pom.xml

@@ -17,7 +17,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>

sa-token-demo/sa-token-demo-sso-server/pom.xml

@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>

sa-token-demo/sa-token-demo-sso1-client/pom.xml

@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>

sa-token-demo/sa-token-demo-sso2-client/pom.xml

@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>

sa-token-demo/sa-token-demo-sso3-client/pom.xml

@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>

sa-token-demo/sa-token-demo-thymeleaf/pom.xml

@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>

sa-token-demo/sa-token-demo-webflux/pom.xml

@@ -16,7 +16,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>

sa-token-demo/sa-token-demo-websocket-spring/pom.xml

@@ -17,7 +17,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>

sa-token-demo/sa-token-demo-websocket/pom.xml

@@ -17,7 +17,7 @@
 	
 	<!-- 定义sa-token版本号 -->
 	<properties>
-		<sa-token-version>1.30.0</sa-token-version>
+		<sa-token-version>1.31.0.RC</sa-token-version>
 	</properties>
 
 	<dependencies>

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.30.0</h1>
+<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">Sa-Token v1.31.0.RC</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>

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.30.0</sub>
+						<sub>v1.31.0.RC</sub>
 					</div>
 				</a>
 			</div>
@@ -114,7 +114,7 @@
 		<!--  -->
 		<script src="./lib/docsify-plugin.js"></script>
 		<script>
-			var saTokenTopVersion = '1.30.0';	// Sa-Token最新版本 
+			var saTokenTopVersion = '1.31.0.RC';	// 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 = {
@@ -167,6 +167,7 @@
 
 		<!-- jqeury -->
 		<script src="https://unpkg.com/jquery@3.4.1/dist/jquery.min.js"></script>
+		<script src="https://www.layuicdn.com/layer-v3.1.1/layer.js"></script>
 		
 		<script>
 			if(window.jQuery === undefined || window.Docsify === undefined) {
@@ -205,5 +206,12 @@
 			})();
 		</script>
 		
+		<script type="text/javascript">
+			// 预览版提示 
+			if(location.host === 'rc.sa-token.dev33.cn') {
+				const newTips = '<b>当前文档为RC预览版文档，仅做学习测试使用，正式项目请使用正式版：<a href="https://sa-token.dev33.cn/" target="_blank">https://sa-token.dev33.cn/</a></b>';
+				layer.alert(newTips);
+			}
+		</script>
 	</body>
 </html>

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.30.0</sub>
+						<sub>v1.31.0.RC</sub>
 					</div>
 				</a>
 			</div>
@@ -30,6 +30,7 @@
 				</div>
 				<select class="p-none" 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.30.0/doc/index.html">v1.30.0</option>
 					<option value="http://sa-token.dev33.cn/v/v1.29.0/doc/index.html">v1.29.0</option>
 					<option value="http://sa-token.dev33.cn/v/v1.28.0/doc/index.html">v1.28.0</option>
 					<option value="http://sa-token.dev33.cn/v/v1.27.0/doc/index.html">v1.27.0</option>
@@ -115,7 +116,7 @@
 		<!--  -->
 		<script src="./lib/docsify-plugin.js"></script>
 		<script>
-			var saTokenTopVersion = '1.30.0';	// Sa-Token最新版本 
+			var saTokenTopVersion = '1.31.0.RC';	// 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 = {
@@ -168,6 +169,7 @@
 
 		<!-- jqeury -->
 		<script src="https://unpkg.zhimg.com/jquery@3.4.1/dist/jquery.min.js"></script>
+		<script src="https://www.layuicdn.com/layer-v3.1.1/layer.js"></script>
 		
 		<script>
 			if(window.jQuery === undefined || window.Docsify === undefined) {
@@ -206,5 +208,12 @@
 			})();
 		</script>
 		
+		<script type="text/javascript">
+			// 预览版提示 
+			if(location.host === 'rc.sa-token.dev33.cn') {
+				const newTips = '<b>当前文档为RC预览版文档，仅做学习测试使用，正式项目请使用正式版：<a href="https://sa-token.dev33.cn/" target="_blank">https://sa-token.dev33.cn/</a></b>';
+				layer.alert(newTips);
+			}
+		</script>
 	</body>
 </html>

sa-token-doc/doc/more/update-log.md

@@ -1,6 +1,39 @@
 # 更新日志 
 
 
+### 2022-8-29 @v1.31.0
+- 文档：新增优秀开源案例展示。
+- 文档：新增博客展示，欢迎大家投稿。 
+- 新增：新增 `SaInterceptor` 综合拦截器。   **[重要]**  **[不向下兼容]**
+- 新增：新增 新增 `@SaIgnore` 忽略鉴权注解。   **[重要]** 
+- 新增：新增插件 `sa-token-dao-redis-fastjson`，感谢 `@sikadai` 提交的pr。  **[重要]**
+- 新增：新增插件 `sa-token-context-grpc`，感谢 `@LiYiMing666` 提交的pr。  **[重要]**
+- 重构：SaSession 取消 `tokenSignList` 的 final 修饰符。
+- 新增：SaSession 添加 `setTokenSignList` 方法。
+- 重构：TokenSign 新增 `setValue` 和 `setDevice` 方法。
+- 修复：修复多账号模式下不能正确重置 `StpLogic` 的问题。
+- 修复：修复 SaSession 对象中 TokenSign 判断有可能空指针的问题。 
+- 修复：解决当权限码为 null 时可能带来的空指针问题。
+- 新增：新增 `StpUtil.getExtra(tokenValue, key)` 方法，用于获取任意 token 的扩展参数。 
+- 优化：优化 `StpLogic#logoutByTokenValue` 方法逻辑，精简代码。
+- 修复：修复部分场景下踢人下线会抛出异常 `非Web上下文无法获取Request` 的问题。 
+- 新增：新增方法 `StpLogic#getAnonTokenSession`，可在未登录情况下安全的获取 Token-Session。  **[重要]** 
+- 新增：新增 `SaApplication` 对象，用于全局作用域存取值。   **[重要]** 
+- 重构：将 `SaTokenListener` 改为事件发布订阅模式，允许同时注册多个侦听器。  **[重要]**  **[不向下兼容]**
+- 新增：会话查询API增加反序获取会话方式。
+- 新增：SSO模块增加 server-url 属性，用于简化各种 url 配置。  **[重要]**
+- 修复：修复单点登录模块 `ssoLogoutCall` 配置项无效的问题。 
+- 优化：优化 `SaSsoHandle.checkTicket(ticket, currUri);` 方法，使其不提供 currUri 参数时将不再注册单点注销回调。
+- 修复：修复 `SaOAuth2Handle` 类中 `doLogin` 方法没有使用 `Param.pwd` 常量的问题。 
+- 新增：新增 `SaOAuth2Util.checkClientTokenScope(clientToken, scopes)` 方法，校验 Client-Token 是否含有指定 Scope。
+- 删除：删除 `sa-token-jwt` 模块过期 class。
+- 重构：`sa-token-jwt` 模块依赖改为 `hutool-jwt`，并升级版本为 5.8.5。
+- 重构：`sa-token-jwt` 模块改为 `Util + Template` 形式，方便针对部分代码重写。  **[重要]** 
+- 新增：在线文档添加API手册。
+- 重构：`sa-token-oauth2` 模块密码模式新增 `client_secret` 参数校验。**[不向下兼容]** 
+- 优化：开源案例分离专属仓库：[Awesome-Sa-Token](https://gitee.com/sa-token/awesome-sa-token)
+
+
 ### 2022-05-9 @v1.30.0
 - 新增：新增集成 Web-Socket 鉴权示例。 **[重要]**
 - 新增：新增集成 Web-Socket（Spring封装版） 鉴权示例。

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.30.0</sub> -->
+							<!-- <sub>v1.31.0.RC</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.30.0</small></h1>
+					<h1>Sa-Token<small>v1.31.0.RC</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>
@@ -630,5 +630,13 @@
 			
 		</script>
 
+		<script type="text/javascript">
+			// 预览版提示 
+			if(location.host === 'rc.sa-token.dev33.cn') {
+				const newTips = '<b>当前文档为RC预览版文档，仅做学习测试使用，正式项目请使用正式版：<a href="https://sa-token.dev33.cn/" target="_blank">https://sa-token.dev33.cn/</a></b>';
+				layer.alert(newTips);
+			}
+		</script>
+
 	</body>
 </html>

sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/constants/GrpcContextConstants.java

@@ -5,10 +5,11 @@ import cn.dev33.satoken.util.SaTokenConsts;
 import io.grpc.Metadata;
 
 /**
+ * 常量 
+ * 
  * @author lym
- * @description
+ * @since: 2022/8/26 14:27
- * @date 2022/8/26 14:27
+ */
- **/
 public class GrpcContextConstants {
     public static final Metadata.Key<String> SA_ID_TOKEN =
             Metadata.Key.of(SaIdUtil.ID_TOKEN, Metadata.ASCII_STRING_MARSHALLER);

sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/context/SaTokenGrpcContext.java

@@ -7,7 +7,7 @@ import java.util.Map;
 
 /**
  * @author lym
- * @date 2022/8/25 11:02
+ * @since 2022/8/25 11:02
  **/
 public class SaTokenGrpcContext {
     /**

sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/interceptor/SaTokenContextGrpcServerInterceptor.java

@@ -6,9 +6,10 @@ import net.devh.boot.grpc.server.interceptor.GrpcGlobalServerInterceptor;
 import org.springframework.core.Ordered;
 
 /**
+ * 处理请求前，创建上下文
+ * 
  * @author lym
- * @date 2022/8/24 10:09
+ * @since 2022/8/24 10:09
- * @description 处理请求前，创建上下文
  */
 @GrpcGlobalServerInterceptor
 public class SaTokenContextGrpcServerInterceptor implements ServerInterceptor, Ordered {

sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/interceptor/SaTokenGrpcClientInterceptor.java

@@ -12,9 +12,10 @@ import org.springframework.core.Ordered;
 
 
 /**
+ * 客户端请求的时候，带上token
+ * 
  * @author lym
- * @date 2022/8/24 15:45
+ * @since 2022/8/24 15:45
- * @description 客户端请求的时候，带上token
  */
 @GrpcGlobalClientInterceptor
 public class SaTokenGrpcClientInterceptor implements ClientInterceptor, Ordered {

sa-token-plugin/sa-token-context-grpc/src/main/java/cn/dev33/satoken/context/grpc/interceptor/SaTokenGrpcServerInterceptor.java

@@ -9,9 +9,10 @@ import io.grpc.*;
 import net.devh.boot.grpc.server.interceptor.GrpcGlobalServerInterceptor;
 
 /**
+ * 鉴权，设置token
+ * 
  * @author lym
- * @description 鉴权，设置token
+ * @since 2022/8/25 11:33
- * @date 2022/8/25 11:33
  **/
 @GrpcGlobalServerInterceptor
 public class SaTokenGrpcServerInterceptor implements ServerInterceptor {