mirror of
https://gitee.com/dromara/sa-token.git
synced 2025-05-05 13:17:55 +08:00
116 lines
3.6 KiB
Markdown
116 lines
3.6 KiB
Markdown
# SpringBoot 集成 Sa-Token 示例
|
||
|
||
本篇将带你从零开始集成Sa-Token，从而让你快速熟悉Sa-Token的使用姿势 <br>
|
||
整合示例在官方仓库的`/sa-token-demo/sa-token-demo-springboot`文件夹下，如遇到难点可结合源码进行测试学习
|
||
|
||
---
|
||
|
||
### 1、创建项目
|
||
在IDE中新建一个SpringBoot项目，例如：`sa-token-demo-springboot`（不会的同学请自行百度或者参考github示例）
|
||
|
||
|
||
### 2、设置依赖
|
||
在 `pom.xml` 中添加依赖：
|
||
|
||
``` xml
|
||
<!-- Sa-Token 权限认证, 在线文档：http://sa-token.dev33.cn/ -->
|
||
<dependency>
|
||
<groupId>cn.dev33</groupId>
|
||
<artifactId>sa-token-spring-boot-starter</artifactId>
|
||
<version>1.20.0</version>
|
||
</dependency>
|
||
```
|
||
|
||
|
||
### 3、设置配置文件
|
||
你可以**零配置启动项目** ，但同时你也可以在`application.yml`中增加如下配置，定制性使用框架：
|
||
|
||
``` java
|
||
server:
|
||
# 端口
|
||
port: 8081
|
||
|
||
# Sa-Token配置
|
||
sa-token:
|
||
# token名称 (同时也是cookie名称)
|
||
token-name: satoken
|
||
# token有效期，单位s 默认30天, -1代表永不过期
|
||
timeout: 2592000
|
||
# token临时有效期 (指定时间内无操作就视为token过期) 单位: 秒
|
||
activity-timeout: -1
|
||
# 是否允许同一账号并发登录 (为true时允许一起登录, 为false时新登录挤掉旧登录)
|
||
is-concurrent: false
|
||
# 在多人登录同一账号时，是否共用一个token (为true时所有登录共用一个token, 为false时每次登录新建一个token)
|
||
is-share: false
|
||
# token风格
|
||
token-style: uuid
|
||
# 是否输出操作日志
|
||
is-log: false
|
||
```
|
||
|
||
如果你习惯于 `application.properties` 类型的配置文件，那也很好办: <br>
|
||
百度： [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)
|
||
|
||
|
||
### 4、创建启动类
|
||
在项目中新建包 `com.pj` ，在此包内新建主类 `SaTokenDemoApplication.java`，输入以下代码：
|
||
|
||
``` java
|
||
@SpringBootApplication
|
||
public class SaTokenDemoApplication {
|
||
public static void main(String[] args) throws JsonProcessingException {
|
||
SpringApplication.run(SaTokenDemoApplication.class, args);
|
||
System.out.println("启动成功：Sa-Token配置如下：" + SaManager.getConfig());
|
||
}
|
||
}
|
||
```
|
||
|
||
### 5、创建测试Controller
|
||
``` java
|
||
@RestController
|
||
@RequestMapping("/user/")
|
||
public class UserController {
|
||
|
||
// 测试登录，浏览器访问： http://localhost:8081/user/doLogin?username=zhang&password=123456
|
||
@RequestMapping("doLogin")
|
||
public String doLogin(String username, String password) {
|
||
// 此处仅作模拟示例，真实项目需要从数据库中查询数据进行比对
|
||
if("zhang".equals(username) && "123456".equals(password)) {
|
||
StpUtil.login(10001);
|
||
return "登录成功";
|
||
}
|
||
return "登录失败";
|
||
}
|
||
|
||
// 查询登录状态，浏览器访问： http://localhost:8081/user/isLogin
|
||
@RequestMapping("isLogin")
|
||
public String isLogin(String username, String password) {
|
||
return "当前会话是否登录：" + StpUtil.isLogin();
|
||
}
|
||
|
||
}
|
||
```
|
||
|
||
### 6、运行
|
||
启动代码，从浏览器依次访问上述测试接口：
|
||
|
||
|
||
|
||
|
||
|
||
<!--
|
||
### 普通Spring环境
|
||
普通spring环境与springboot环境大体无异，只不过需要在项目根目录手动创建配置文件`sa-token.properties`来完成配置
|
||
-->
|
||
|
||
|
||
### 详细了解
|
||
通过这个示例，你已经对Sa-Token有了初步的了解，那么现在开始详细了解一下它都有哪些 [能力](/use/login-auth) 吧
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|