v1.12.0 版本更新

ba640295 · shengzhang_ · 1ce7b945 · ba640295 · ba640295 · ba640295
23 changed file
--- a/README.md
+++ b/README.md
 <p align="center">
    <img alt="logo" src="https://gitee.com/sz6/sa-token/raw/master/sa-token-doc/doc/logo.png" width="150" height="150" style="margin-bottom: 10px;">
 </p>
-<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">sa-token v1.11.0</h1>
+<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">sa-token v1.12.0</h1>
 <h4 align="center">这可能是史上功能最全的Java权限认证框架！</h4>
 <h4 align="center">
 	<a href="https://gitee.com/sz6/sa-token/stargazers"><img src="https://gitee.com/sz6/sa-token/badge/star.svg"></a>
-	<a href="https://github.com/click33/sa-token"><img src="https://img.shields.io/badge/sa--token-v1.11.0-2B9939"></a>
+	<a href="https://github.com/click33/sa-token"><img src="https://img.shields.io/badge/sa--token-v1.12.0-2B9939"></a>
 	<a href="https://github.com/click33/sa-token/stargazers"><img src="https://img.shields.io/github/stars/click33/sa-token"></a>
 	<a href="https://github.com/click33/sa-token/watchers"><img src="https://img.shields.io/github/watchers/click33/sa-token"></a>
 	<a href="https://github.com/click33/sa-token/network/members"><img src="https://img.shields.io/github/forks/click33/sa-token"></a>
@@ -71,6 +71,7 @@ StpUtil.getSessionByLoginId(10001); // 获取账号id为10001的Session
 StpUtil.getTokenValueByLoginId(10001);  // 获取账号id为10001的token令牌值
 StpUtil.setLoginId(10001, "PC");        // 指定设备标识登录
 StpUtil.logoutByLoginId(10001, "PC");   // 指定设备标识进行强制注销 (不同端不受影响)
+StpUtil.switchTo(10044);                // 将当前会话身份临时切换为其它账号 
 ```
 sa-token的API众多，请恕此处无法为您逐一展示，更多示例请戳官方在线文档


--- a/pom.xml
+++ b/pom.xml
@@ -8,7 +8,7 @@
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-parent</artifactId>
 	<packaging>pom</packaging>
-	<version>1.11.0</version>
+	<version>1.12.0</version>
 	
 	<!-- 项目介绍 -->
 	<name>sa-token</name>

--- 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.11.0</version>
+        <version>1.12.0</version>
    </parent>
    <packaging>jar</packaging>


--- a/sa-token-core/src/main/java/cn/dev33/satoken/stp/StpLogic.java
+++ b/sa-token-core/src/main/java/cn/dev33/satoken/stp/StpLogic.java
@@ -95,8 +95,8 @@ public class StpLogic {
 		String tokenValue = null;
 		
 		// 1. 尝试从request里读取 
-		if(request.getAttribute(getJustCreatedSaveKey()) != null) {
-			tokenValue = String.valueOf(request.getAttribute(getJustCreatedSaveKey()));
+		if(request.getAttribute(getKeyJustCreatedSave()) != null) {
+			tokenValue = String.valueOf(request.getAttribute(getKeyJustCreatedSave()));
 		}
 		// 2. 尝试从请求体里面读取 
 		if(tokenValue == null && config.getIsReadBody() == true){
@@ -201,7 +201,7 @@ public class StpLogic {
 		
 		// ------ 4. 持久化其它数据 
 		dao.setValue(getKeyTokenValue(tokenValue), String.valueOf(loginId), config.getTimeout());	// token -> uid 
-		request.setAttribute(getJustCreatedSaveKey(), tokenValue);	// 将token保存到本次request里  
+		request.setAttribute(getKeyJustCreatedSave(), tokenValue);	// 将token保存到本次request里  
 		setLastActivityToNow(tokenValue);  	// 写入 [最后操作时间]
 		if(config.getIsReadCookie() == true){	// cookie注入 
 			SaTokenManager.getSaTokenCookie().addCookie(SaTokenManager.getSaTokenServlet().getResponse(), getTokenName(), tokenValue, "/", (int)config.getTimeout());		
@@ -554,7 +554,7 @@ public class StpLogic {
 			if(tokenValue == null || Objects.equals(tokenValue, "")) {
 				// 随机一个token送给ta 
 				tokenValue = createTokenValue(null);
-				SaTokenManager.getSaTokenServlet().getRequest().setAttribute(getJustCreatedSaveKey(), tokenValue);
+				SaTokenManager.getSaTokenServlet().getRequest().setAttribute(getKeyJustCreatedSave(), tokenValue);
 				setLastActivityToNow(tokenValue);  	// 写入 [最后操作时间]
 				if(getConfig().getIsReadCookie() == true){	// cookie注入 
 					SaTokenManager.getSaTokenCookie().addCookie(SaTokenManager.getSaTokenServlet().getResponse(), getTokenName(), tokenValue, "/", (int)getConfig().getTimeout());		
@@ -1059,6 +1059,7 @@ public class StpLogic {

 	/**
 	 * 在进行身份切换时，使用的存储key 
+	 * @return key
 	 */
 	public String getKeySwitch() {
 		return SaTokenConsts.SWITCH_TO_SAVE_KEY + getLoginKey();
@@ -1066,8 +1067,9 @@ public class StpLogic {

 	/**
 	 * 如果token为本次请求新创建的，则以此字符串为key存储在当前request中 
+	 * @return key
 	 */
-	public String getJustCreatedSaveKey() {
+	public String getKeyJustCreatedSave() {
 		return SaTokenConsts.JUST_CREATED_SAVE_KEY + getLoginKey();
 	}
 	
@@ -1164,6 +1166,7 @@ public class StpLogic {

 	/**
 	 * 当前是否正处于[身份临时切换]中 
+	 * @return 是否正处于[身份临时切换]中 
 	 */
 	public boolean isSwitch() {
 		return SaTokenManager.getSaTokenServlet().getRequest().getAttribute(getKeySwitch()) != null;
@@ -1171,6 +1174,7 @@ public class StpLogic {
 	
 	/**
 	 * 返回[身份临时切换]的loginId 
+	 * @return 返回[身份临时切换]的loginId 
 	 */
 	public Object getSwitchLoginId() {
 		return SaTokenManager.getSaTokenServlet().getRequest().getAttribute(getKeySwitch());
@@ -1179,6 +1183,7 @@ public class StpLogic {
 	/**
 	 * 在一个代码段里方法内，临时切换身份为指定loginId
 	 * @param loginId 指定loginId 
+	 * @param function 要执行的方法 
 	 */
 	public void switchTo(Object loginId, SaFunction function) {
 		try {

--- a/sa-token-core/src/main/java/cn/dev33/satoken/stp/StpUtil.java
+++ b/sa-token-core/src/main/java/cn/dev33/satoken/stp/StpUtil.java
@@ -506,14 +506,16 @@ public class StpUtil {

 	/**
 	 * 当前是否正处于[身份临时切换]中 
+	 * @return 是否正处于[身份临时切换]中 
 	 */
 	public static boolean isSwitch() {
 		return stpLogic.isSwitch();
 	}
-	
+
 	/**
-	 * 在一个代码段里方法内，临时切换身份为指定loginId 
+	 * 在一个代码段里方法内，临时切换身份为指定loginId
 	 * @param loginId 指定loginId 
+	 * @param function 要执行的方法 
 	 */
 	public static void switchTo(Object loginId, SaFunction function) {
 		stpLogic.switchTo(loginId, function);

--- 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
@@ -10,7 +10,7 @@ public class SaTokenConsts {
 	/**
 	 * sa-token 版本号 
 	 */
-	public static final String VERSION_NO = "v1.11.0";
+	public static final String VERSION_NO = "v1.12.0";

 	/**
 	 * sa-token 开源地址 

--- a/sa-token-dao-redis-jackson/pom.xml
+++ b/sa-token-dao-redis-jackson/pom.xml
@@ -7,7 +7,7 @@
 	<parent>
        <groupId>cn.dev33</groupId>
        <artifactId>sa-token-parent</artifactId>
-        <version>1.11.0</version>
+        <version>1.12.0</version>
    </parent>
    <packaging>jar</packaging>

@@ -20,7 +20,7 @@
 		<dependency>
            <groupId>cn.dev33</groupId>
            <artifactId>sa-token-spring-boot-starter</artifactId>
-            <version>1.11.0</version>
+            <version>1.12.0</version>
        </dependency>
 		<!-- RedisTemplate 相关操作API -->
        <dependency>

--- a/sa-token-dao-redis/pom.xml
+++ b/sa-token-dao-redis/pom.xml
@@ -7,7 +7,7 @@
 	<parent>
        <groupId>cn.dev33</groupId>
        <artifactId>sa-token-parent</artifactId>
-        <version>1.11.0</version>
+        <version>1.12.0</version>
    </parent>
    <packaging>jar</packaging>

@@ -20,7 +20,7 @@
 		<dependency>
            <groupId>cn.dev33</groupId>
            <artifactId>sa-token-spring-boot-starter</artifactId>
-            <version>1.11.0</version>
+            <version>1.12.0</version>
        </dependency>
 		<!-- RedisTemplate 相关操作API -->
        <dependency>

--- a/sa-token-demo-jwt/pom.xml
+++ b/sa-token-demo-jwt/pom.xml
@@ -29,7 +29,7 @@
 		<dependency>
            <groupId>cn.dev33</groupId>
            <artifactId>sa-token-spring-boot-starter</artifactId>
-            <version>1.11.0</version>
+            <version>1.12.0</version>
        </dependency>
        
        <!-- jwt -->
@@ -43,14 +43,14 @@
 		<!-- <dependency>
            <groupId>cn.dev33</groupId>
            <artifactId>sa-token-dao-redis</artifactId>
-            <version>1.11.0</version>
+            <version>1.12.0</version>
        </dependency> -->
 		
 		<!-- sa-token整合redis (使用jackson序列化方式) -->
 		<!-- <dependency>
            <groupId>cn.dev33</groupId>
            <artifactId>sa-token-dao-redis-jackson</artifactId>
-            <version>1.11.0</version>
+            <version>1.12.0</version>
        </dependency> -->
        
 		<!-- 提供redis连接池 -->
@@ -63,7 +63,7 @@
 		<!-- <dependency>
            <groupId>cn.dev33</groupId>
            <artifactId>sa-token-spring-aop</artifactId>
-            <version>1.11.0</version>
+            <version>1.12.0</version>
        </dependency> -->

 		<!-- @ConfigurationProperties -->

--- a/sa-token-demo-jwt/src/main/java/com/pj/satoken/jwt/SaTokenJwtUtil.java
+++ b/sa-token-demo-jwt/src/main/java/com/pj/satoken/jwt/SaTokenJwtUtil.java
@@ -128,7 +128,7 @@ public class SaTokenJwtUtil {
    			SaTokenConfig config = getConfig();
    			// ------ 2、生成一个token 
    			String tokenValue = createTokenValue(loginId);
-    			request.setAttribute(SaTokenConsts.JUST_CREATED_SAVE_KEY, tokenValue);	// 将token保存到本次request里  
+    			request.setAttribute(getKeyJustCreatedSave(), tokenValue);	// 将token保存到本次request里  
    			if(config.getIsReadCookie() == true){	// cookie注入 
    				SaTokenManager.getSaTokenCookie().addCookie(SaTokenManager.getSaTokenServlet().getResponse(), getTokenName(), tokenValue, "/", (int)config.getTimeout());		
    			}

--- a/sa-token-demo-springboot/pom.xml
+++ b/sa-token-demo-springboot/pom.xml
@@ -29,21 +29,21 @@
 		<dependency>
            <groupId>cn.dev33</groupId>
            <artifactId>sa-token-spring-boot-starter</artifactId>
-            <version>1.11.0</version>
+            <version>1.12.0</version>
        </dependency>
 		
 		<!-- sa-token整合redis (使用jdk默认序列化方式) -->
 		<!-- <dependency>
            <groupId>cn.dev33</groupId>
            <artifactId>sa-token-dao-redis</artifactId>
-            <version>1.11.0</version>
+            <version>1.12.0</version>
        </dependency> -->
 		
 		<!-- sa-token整合redis (使用jackson序列化方式) -->
 		<!-- <dependency>
            <groupId>cn.dev33</groupId>
            <artifactId>sa-token-dao-redis-jackson</artifactId>
-            <version>1.11.0</version>
+            <version>1.12.0</version>
        </dependency> -->
        
 		<!-- 提供redis连接池 -->
@@ -56,7 +56,7 @@
 		<!-- <dependency>
            <groupId>cn.dev33</groupId>
            <artifactId>sa-token-spring-aop</artifactId>
-            <version>1.11.0</version>
+            <version>1.12.0</version>
        </dependency> -->

 		<!-- @ConfigurationProperties -->

--- a/sa-token-demo-springboot/src/main/java/com/pj/SaTokenDemoApplication.java
+++ b/sa-token-demo-springboot/src/main/java/com/pj/SaTokenDemoApplication.java
@@ -11,7 +11,6 @@ public class SaTokenDemoApplication {
 	public static void main(String[] args) {
 		SpringApplication.run(SaTokenDemoApplication.class, args); 
 		System.out.println("\n启动成功：sa-token配置如下：" + SaTokenManager.getConfig());
-		
 	}
 	
 }
\ No newline at end of file
--- a/sa-token-doc/doc/README.md
+++ b/sa-token-doc/doc/README.md
 <p align="center">
    <img alt="logo" src="https://gitee.com/sz6/sa-token/raw/master/sa-token-doc/doc/logo.png" width="150" height="150" style="margin-bottom: 10px;">
 </p>
-<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">sa-token v1.11.0</h1>
+<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">sa-token v1.12.0</h1>
 <h4 align="center">这可能是史上功能最全的Java权限认证框架！</h4>
 <h4 align="center">
 	<a href="https://gitee.com/sz6/sa-token/stargazers"><img src="https://gitee.com/sz6/sa-token/badge/star.svg"></a>
-	<a href="https://github.com/click33/sa-token"><img src="https://img.shields.io/badge/sa--token-v1.11.0-2B9939"></a>
+	<a href="https://github.com/click33/sa-token"><img src="https://img.shields.io/badge/sa--token-v1.12.0-2B9939"></a>
 	<a href="https://github.com/click33/sa-token/stargazers"><img src="https://img.shields.io/github/stars/click33/sa-token"></a>
 	<a href="https://github.com/click33/sa-token/watchers"><img src="https://img.shields.io/github/watchers/click33/sa-token"></a>
 	<a href="https://github.com/click33/sa-token/network/members"><img src="https://img.shields.io/github/forks/click33/sa-token"></a>
@@ -71,6 +71,7 @@ StpUtil.getSessionByLoginId(10001); // 获取账号id为10001的Session
 StpUtil.getTokenValueByLoginId(10001);  // 获取账号id为10001的token令牌值
 StpUtil.setLoginId(10001, "PC");        // 指定设备标识登录
 StpUtil.logoutByLoginId(10001, "PC");   // 指定设备标识进行强制注销 (不同端不受影响)
+StpUtil.switchTo(10044);                // 将当前会话身份临时切换为其它账号 
 ```
 sa-token的API众多，请恕此处无法为您逐一展示，更多示例请戳官方在线文档


--- a/sa-token-doc/doc/index.html
+++ b/sa-token-doc/doc/index.html
@@ -22,6 +22,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.11.0/doc/index.html">v1.11.0</option>
 				<option value="http://sa-token.dev33.cn/v/v1.10.0/doc/index.html">v1.10.0</option>
 				<option value="http://sa-token.dev33.cn/v/v1.9.0/doc/index.html">v1.9.0</option>
 				<option value="http://sa-token.dev33.cn/v/v1.8.0/doc/index.html">v1.8.0</option>
@@ -40,7 +41,7 @@
 		</div>
 		<script>
 			var name = '<img style="width: 50px; height: 50px; vertical-align: middle;" src="logo.png" alt="logo" /> ';
-			name += '<b style="font-size: 24px; vertical-align: middle;">sa-token</b> <sub>v1.11.0</sub>'
+			name += '<b style="font-size: 24px; vertical-align: middle;">sa-token</b> <sub>v1.12.0</sub>'
 			window.$docsify = {
 				name: name, // 名字 
 				repo: 'https://github.com/click33/sa-token', // github地址 

--- a/sa-token-doc/doc/more/update-log.md
+++ b/sa-token-doc/doc/more/update-log.md
 # 更新日志 


+### 2021-1-12 @v1.12.0
+- 新增：提供JWT集成示例 **[重要]**
+- 新增：新增路由式鉴权，可方便的根据路由匹配鉴权  **[重要]**
+- 新增：新增身份临时切换功能，可在一个代码段内将会话临时切换为其它账号  **[重要]**
+- 优化：将`SaCheckInterceptor.java`更名为`SaAnnotationInterceptor.java`，更语义化的名称 
+- 优化：优化文档
+
+
 ### 2021-1-10 @v1.11.0
 - 新增：提供AOP注解鉴权方案 **[重要]**
 - 优化自动生成token的算法

--- a/sa-token-doc/doc/start/download.md
+++ b/sa-token-doc/doc/start/download.md
@@ -9,10 +9,15 @@
 <dependency>
 	<groupId>cn.dev33</groupId>
 	<artifactId>sa-token-spring-boot-starter</artifactId>
-	<version>1.11.0</version>
+	<version>1.12.0</version>
 </dependency>
 ```

+## Gradle依赖
+Gradle用户引入依赖：
+```
+implementation 'cn.dev33:sa-token-spring-boot-starter:1.12.0'
+```




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


--- a/sa-token-doc/doc/use/at-check.md
+++ b/sa-token-doc/doc/use/at-check.md
@@ -90,7 +90,7 @@ mode有两种取值：
 <dependency>
 	<groupId>cn.dev33</groupId>
 	<artifactId>sa-token-spring-aop</artifactId>
-	<version>1.11.0</version>
+	<version>1.12.0</version>
 </dependency>
 ```


--- a/sa-token-doc/doc/use/dao-extend.md
+++ b/sa-token-doc/doc/use/dao-extend.md
@@ -11,7 +11,7 @@
 	<dependency>
 		<groupId>cn.dev33</groupId>
 		<artifactId>sa-token-dao-redis</artifactId>
-		<version>1.11.0</version>
+		<version>1.12.0</version>
 	</dependency>
 ```
 优点：兼容性好，缺点：session序列化后基本不可读，对开发者来讲等同于乱码
@@ -23,7 +23,7 @@
 	<dependency>
 		<groupId>cn.dev33</groupId>
 		<artifactId>sa-token-dao-redis-jackson</artifactId>
-		<version>1.11.0</version>
+		<version>1.12.0</version>
 	</dependency>
 ```
 优点：session序列化后可读性强，可灵活手动修改，缺点：兼容性稍差

--- a/sa-token-doc/index.html
+++ b/sa-token-doc/index.html
@@ -43,7 +43,7 @@
 			<!-- 内容部分 -->
 			<div class="main-box">
 				<div class="content-box">
-					<h1>sa-token<small>v1.11.0</small></h1>
+					<h1>sa-token<small>v1.12.0</small></h1>
 					<div class="sub-title">这可能是史上功能最全的Java权限认证框架！</div>
 					<!-- <p>0配置开箱即用，低学习成本</p> -->
 					<p>登录验证、权限验证、Session会话、踢人下线、集成Redis、前后台分离、模拟他人账号、临时身份切换、多账号体系、注解式鉴权、路由拦截式鉴权、花式token、自动续签、同端互斥登录、会话治理、Spring集成...</p>

--- a/sa-token-spring-aop/pom.xml
+++ b/sa-token-spring-aop/pom.xml
@@ -7,7 +7,7 @@
 	<parent>
        <groupId>cn.dev33</groupId>
        <artifactId>sa-token-parent</artifactId>
-        <version>1.11.0</version>
+        <version>1.12.0</version>
    </parent>
    <packaging>jar</packaging>

@@ -20,7 +20,7 @@
 		<dependency>
            <groupId>cn.dev33</groupId>
            <artifactId>sa-token-spring-boot-starter</artifactId>
-            <version>1.11.0</version>
+            <version>1.12.0</version>
        </dependency>
 		<!-- spring-boot-starter-aop -->
 		<dependency>

--- a/sa-token-spring-boot-starter/pom.xml
+++ b/sa-token-spring-boot-starter/pom.xml
@@ -7,7 +7,7 @@
 	<parent>
        <groupId>cn.dev33</groupId>
        <artifactId>sa-token-parent</artifactId>
-        <version>1.11.0</version>
+        <version>1.12.0</version>
    </parent>
    <packaging>jar</packaging>

@@ -19,7 +19,7 @@
 		<dependency>
 			<groupId>cn.dev33</groupId>
 			<artifactId>sa-token-core</artifactId>
-			<version>1.11.0</version>
+			<version>1.12.0</version>
 		</dependency>
 		<dependency>
 			<groupId>org.springframework.boot</groupId>

--- a/sa-token-spring-boot-starter/src/main/java/cn/dev33/satoken/interceptor/SaRouteInterceptor.java
+++ b/sa-token-spring-boot-starter/src/main/java/cn/dev33/satoken/interceptor/SaRouteInterceptor.java
@@ -186,7 +186,7 @@ public class SaRouteInterceptor implements HandlerInterceptor {
 	
 	/**
 	 * 构建一个模式为角色认证的sa路由拦截器 
-	 * @param roles 需要验证的数组标识列表
+	 * @param roles 需要验证的角色标识列表
 	 * @return sa拦截器 
 	 */
 	public static SaRouteInterceptor createRoleVal(String... roles) {
@@ -195,7 +195,7 @@ public class SaRouteInterceptor implements HandlerInterceptor {
 	
 	/**
 	 * 构建一个模式为权限认证的sa路由拦截器 
-	 * @param permissions 需要验证的数组权限列表 
+	 * @param permissions 需要验证的权限列表 
 	 * @return sa拦截器 
 	 */
 	public static SaRouteInterceptor createPermissionVal(String... permissions) {