点击上方“Thinking曹”，勾选“设为星标”

前言

过去的Web项目开发里，我们使用最多的两种权限框架有Shiro和Spring Security，Shiro轻量级、入门门槛低功能相对也强大；Spring Security背景强大，功能丰富，入门门槛相对高，配置稍微复杂，由Spring团队开源。而现如今将介绍一款轻量级、功能强大且几乎零配置的sa-token权限框架， sa-token是一个JavaWeb权限认证框架，强大、简单、好用。

一、核心知识

1. 什么是sa-token

sa-token是一个JavaWeb权限认证框架，强大、简单、好用

登录验证、权限验证、自定义session会话、踢人下线、持久层扩展、无cookie模式、模拟他人账号、多账号体系、注解式鉴权、Spring集成…

零配置开箱即用，覆盖所有应用场景，你所需要的功能，这里都有

与其它权限认证框架相比，sa-token有以下两点优点：

上手简单：能自动化的配置全部自动化，不让你费脑子

功能强大：能涵盖的功能全部涵盖，不让你用个框架还要自己给框架打各种补丁

2. sa-token 😋

在线文档：http://sa-token.dev33.cn/

3. 框架优点

与其它权限认证框架相比，sa-token尽力保证两点：

上手简单：能自动化的配置全部自动化，不让你费脑子功能强大：能涵盖的功能全部涵盖，不让你用个框架还要自己给框架打各种补丁

二、涵盖功能

登录验证
权限验证
自定义session会话
踢人下线
模拟他人账号
持久层扩展（集成redis）
多账号认证体系（比如一个商城项目的user表和admin表）
无cookie模式（APP、小程序等前后台分离场景）
注解式鉴权（优雅的将鉴权与业务代码分离）
零配置与Spring等框架集成
…

三、集成

1. maven依赖

在项目中直接通过 pom.xml导入 sa-token的依赖即可

<dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token</artifactId>
    <version>1.4.0</version>
</dependency>

2. 获取源码

github地址： https://github.com/click33/sa-token
gitee地址： https://gitee.com/sz6/sa-token

3. jar包下载

点击下载：sa-token-1.4.0.jar

四、准备工作

本篇将带你从零开始集成sa-token，从而让你快速熟悉sa-token的使用姿势，以maven + springboot为例

五、工程搭建

1. 创建SpringBoot项目

手把手教你SpringBoot整合sa-token权限框架 — 在这里插入图片描述

1.2 引入sa-token的依赖

<!-- sa-token 权限认证, 在线文档：http://sa-token.dev33.cn/ -->
<dependency>
   <groupId>cn.dev33</groupId>
   <artifactId>sa-token</artifactId>
   <version>1.4.0</version>
</dependency>

2. 引入jar包依赖

在 pom.xml 中添加依赖，完整pom如下：

<!-- web应用依赖 -->
<dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<!-- lombok代码简化工具 -->
<dependency>
   <groupId>org.projectlombok</groupId>
   <artifactId>lombok</artifactId>
   <optional>true</optional>
</dependency>

<!-- sa-token 权限认证, 在线文档：http://sa-token.dev33.cn/ -->
<dependency>
   <groupId>cn.dev33</groupId>
   <artifactId>sa-token</artifactId>
   <version>1.4.0</version>
</dependency>

3. 配置文件

你可以零配置启动项目
但同时你也可以在application.yml中增加如下配置，定制性使用框架：

server:
  port: 8070

spring:
  # sa-token配置
  sa-token:
    # token名称（同时也是cookie名称）
    token-name: satoken
    # token有效期，单位s 默认30天
    timeout: 2592000
    # 在多人登录同一账号时，是否共享会话（为true时共用一个，为false时新登录挤掉旧登录）
    is-share: true
    # 是否在cookie读取不到token时，继续从请求header里继续尝试读取
    is-read-head: true
    #  是否在header读取不到token时，继续从请求题参数里继续尝试读取
    is-read-body: true
    # 是否在初始化配置时打印版本字符画
    is-v: true

如果你习惯于 application.properties 类型的配置文件，那也很好办:
百度：springboot properties与yml 配置文件的区别

4. 创建主类

在项目中新建包 com.pj ，在此包内新建主类 SaTokenDemoApplication.java，输入以下代码：

@SaTokenSetup // 标注启动 sa-token
@SpringBootApplication
public class SaTokenDemoApplication {
    public static void main(String[] args) throws JsonProcessingException {
        SpringApplication.run(SaTokenDemoApplication.class, args); // run-->
        System.out.println("启动成功：sa-token配置如下：" + SaTokenManager.getConfig());
    }
}