⚡ v1.7.0 版本更新

2025-09-22 12:09:21 +08:00 · 2020-12-24 22:51:57 +08:00
parent 5c684ac7f1
commit d9836f00ca
18 changed files with 117 additions and 101 deletions
--- a/sa-token-doc/doc/README.md
+++ b/sa-token-doc/doc/README.md
@@ -1,11 +1,11 @@
 <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.6.0</h1>
+<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">sa-token v1.7.0</h1>
 <h4 align="center">一个JavaWeb轻量级权限认证框架，功能全面，上手简单</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.6.0-2B9939"></a>
+	<a href="https://github.com/click33/sa-token"><img src="https://img.shields.io/badge/sa--token-v1.7.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>
--- a/sa-token-doc/doc/index.html
+++ b/sa-token-doc/doc/index.html
@@ -35,7 +35,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.6.0</sub>'
+			name += '<b style="font-size: 24px; vertical-align: middle;">sa-token</b> <sub>v1.7.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
@@ -1,6 +1,16 @@
 # 更新日志 


+### 2020-12-24 @v1.7.0
+- 优化：项目架构改为maven多模块形式，方便增加新模块 **[重要]**
+- 优化：与`springboot`的集成改为`springboot-starter`模式，无需`@SaTokenSetup`注解即可完成自动装配 **[重要]**
+- 新增：新增`activity-timeout`配置，可控制token临时过期与续签功能 **[重要]**
+- 新增：`timeout`过期时间新增-1值，代表永不过期 
+- 新增：`StpUtil.getTokenInfo()`改为对象形式，新增部分常用字段 
+- 优化：解决在无cookie模式下，不集成redis时会话无法主动过期的问题 
+- 修复：修复文档首页样式问题 
+
+
 ### 2020-12-17 @v1.6.0
 - 新增：花式token生成方案 **[重要]** 
 - 优化：优化`readme.md` 
--- a/sa-token-doc/doc/start/download.md
+++ b/sa-token-doc/doc/start/download.md
@@ -8,8 +8,8 @@
 <!-- sa-token 权限认证, 在线文档：http://sa-token.dev33.cn/ -->
 <dependency>
 	<groupId>cn.dev33</groupId>
-	<artifactId>sa-token</artifactId>
-	<version>1.6.0</version>
+	<artifactId>sa-token-spring-boot-starter</artifactId>
+	<version>1.7.0</version>
 </dependency>
 ```

--- a/sa-token-doc/doc/start/example.md
+++ b/sa-token-doc/doc/start/example.md
@@ -17,8 +17,8 @@
 <!-- sa-token 权限认证, 在线文档：http://sa-token.dev33.cn/ -->
 <dependency>
 	<groupId>cn.dev33</groupId>
-	<artifactId>sa-token</artifactId>
-	<version>1.6.0</version>
+	<artifactId>sa-token-spring-boot-starter</artifactId>
+	<version>1.7.0</version>
 </dependency>
 ```

--- a/sa-token-doc/doc/use/config.md
+++ b/sa-token-doc/doc/use/config.md
@@ -1,52 +1,12 @@
 # 框架配置
- 你可以零配置启动框架
+- 你可以**零配置启动框架**
 - 但同时你也可以通过配置，定制性使用框架，`sa-token`支持多种方式配置框架信息

--- 
-### 所有可配置项
-| 参数名称		| 类型		| 默认值	| 说明																				|
-| :--------		| :--------	| :--------	| :--------																			|
-| tokenName		| String	| satoken	| token名称（同时也是cookie名称）													|
-| timeout		| long		| 2592000	| token有效期，单位s 默认30天														|
-| isShare		| Boolean	| true		|  在多人登录同一账号时，是否共享会话（为true时共用一个，为false时新登录挤掉旧登录）|
-| isReadBody	| Boolean	| true		| 是否尝试从请求体里读取token														|
-| isReadHead	| Boolean	| true		| 是否尝试从header里读取token														|
-| isReadCookie	| Boolean	| true		| 是否尝试从cookie里读取token														|
-| tokenStyle	| String	| uuid		| token风格, 参考：[花式token](/use/token-style)										|
-| isV			| Boolean	| true		| 是否在初始化配置时打印版本字符画													|




-
-### 方式1、通过代码配置
-``` java 
-	/**
-	 * sa-token代码方式进行配置
-	 */
-	@Configuration
-	public class MySaTokenConfig {
-	
-		// 获取配置Bean (以代码的方式配置sa-token)
-		@Primary
-		@Bean(name="MySaTokenConfig")
-		public SaTokenConfig getSaTokenConfig() {
-			SaTokenConfig config = new SaTokenConfig();
-			config.setTokenName("satoken");		// token名称 (同时也是cookie名称)
-			config.setTimeout(30 * 24 * 60 * 60); 	// token有效期，单位s 默认30天
-			config.setIsShare(true);				// 在多人登录同一账号时，是否共享会话 (为true时共用一个，为false时新登录挤掉旧登录)
-			config.setIsReadBody(true);		// 是否尝试从请求体里读取token
-			config.setIsReadHead(true);		// 是否尝试从header里读取token
-			config.setIsReadCookie(true);		// 是否尝试从cookie里读取token
-			config.setTokenStyle("uuid"); 		// token风格 
-			config.setIsV(true);					// 是否在初始化配置时打印版本字符画
-			return config;
-		}
-		
-	}
-```
-
-### 方式2、在`application.yml`配置
+### 方式1、在`application.yml`配置

 ``` java
 spring: 
@@ -54,8 +14,10 @@ spring:
    sa-token: 
        # token名称 (同时也是cookie名称)
        token-name: satoken
-        # token有效期，单位s 默认30天
+        # token有效期，单位s 默认30天, -1代表永不过期 
        timeout: 2592000
+		# token临时有效期, 默认-1 代表不限制	
+		activity-timeout: -1
        # 在多人登录同一账号时，是否共享会话 (为true时共用一个，为false时新登录挤掉旧登录)
        is-share: true
        # 是否尝试从请求体里读取token
@@ -74,3 +36,45 @@ spring:
 - 百度： [springboot properties与yml 配置文件的区别](https://www.baidu.com/s?ie=UTF-8&wd=springboot%20properties%E4%B8%8Eyml%20%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E7%9A%84%E5%8C%BA%E5%88%AB)


+### 方式2、通过代码配置
+``` java 
+	/**
+	 * sa-token代码方式进行配置
+	 */
+	@Configuration
+	public class MySaTokenConfig {
+	
+		// 获取配置Bean (以代码的方式配置sa-token)
+		@Primary
+		@Bean(name="MySaTokenConfig")
+		public SaTokenConfig getSaTokenConfig() {
+			SaTokenConfig config = new SaTokenConfig();
+			config.setTokenName("satoken");			// token名称 (同时也是cookie名称)
+			config.setTimeout(30 * 24 * 60 * 60); 	// token有效期，单位s 默认30天, -1代表永不过期 
+			config.setActivityTimeout(-1); 			//  token临时有效期, 默认-1 代表不限制	
+			config.setIsShare(true);				// 在多人登录同一账号时，是否共享会话 (为true时共用一个，为false时新登录挤掉旧登录)
+			config.setIsReadBody(true);				// 是否尝试从请求体里读取token
+			config.setIsReadHead(true);				// 是否尝试从header里读取token
+			config.setIsReadCookie(true);			// 是否尝试从cookie里读取token
+			config.setTokenStyle("uuid"); 			// token风格 
+			config.setIsV(true);					// 是否在初始化配置时打印版本字符画
+			return config;
+		}
+		
+	}
+```
+
+
+--- 
+### 所有可配置项
+| 参数名称			| 类型		| 默认值		| 说明																				|
+| :--------			| :--------	| :--------	| :--------																			|
+| tokenName			| String	| satoken	| token名称（同时也是cookie名称）													|
+| timeout			| long		| 2592000	| token有效期，单位/秒 默认30天，-1代表永久有效										|
+| activityTimeout	| long		| -1		| token临时有效期 (指定时间内无操作就视为token过期) 单位: 秒, 默认-1 代表不限制 (例如可以设置为1800代表30分钟内无操作就过期) 														|
+| isShare			| Boolean	| true		|  在多人登录同一账号时，是否共享会话（为true时共用一个，为false时新登录挤掉旧登录）	|
+| isReadBody		| Boolean	| true		| 是否尝试从请求体里读取token														|
+| isReadHead		| Boolean	| true		| 是否尝试从header里读取token														|
+| isReadCookie		| Boolean	| true		| 是否尝试从cookie里读取token														|
+| tokenStyle		| String	| uuid		| token风格, [参考：花式token](/use/token-style)										|
+| isV				| Boolean	| true		| 是否在初始化配置时打印版本字符画													|
--- 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.6.0</small></h1>
+					<h1>sa-token<small>v1.7.0</small></h1>
 					<div class="sub-title">一个JavaWeb轻量级权限认证框架，功能全面，上手简单</div>
 					<!-- <p>0配置开箱即用，低学习成本</p> -->
 					<p>登录验证、权限验证、自定义session会话、踢人下线、持久层扩展、无cookie模式、模拟他人账号、多账号体系、注解式鉴权、花式token、Spring集成...</p>