Sa-Token 开源项目使用教程
1. 项目介绍
Sa-Token 是一个轻量级的 Java 权限认证框架,旨在让鉴权变得简单、优雅。它目前拥有五大核心模块:登录认证、权限认证、单点登录、OAuth2.0 和微服务鉴权。Sa-Token 支持多种 Web 框架,如 SpringBoot、Solon、JFinal 等,并提供集成包,实现开箱即用。
2. 项目快速启动
以下以 SpringBoot 项目为例,展示如何快速集成 Sa-Token。
首先,在项目的 pom.xml
文件中添加 Sa-Token 的依赖:
<dependency>
<groupId>cn.dev33</groupId>
<artifactId>sa-token-spring-boot-starter</artifactId>
<version>1.41.0</version>
</dependency>
然后,在 SpringBoot 主类中添加 Sa-Token 的配置:
import cn.dev33.satoken.SaManager;
import cn.dev33.satoken.stp.StpUtil;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class SaTokenApplication {
public static void main(String[] args) {
SpringApplication.run(SaTokenApplication.class, args);
// 初始化 Sa-Token
SaManager.init();
}
// 示例:登录接口
public void login(Integer userId) {
StpUtil.login(userId);
}
// 示例:校验登录接口
public void checkLogin() {
StpUtil.checkLogin();
}
}
这样,就完成了 Sa-Token 的基本配置和登录校验。
3. 应用案例和最佳实践
- 登录认证:使用 Sa-Token 实现用户登录,可支持单端登录、多端登录、同端互斥登录等模式。
- 权限认证:通过 Sa-Token 的注解式鉴权,优雅地将鉴权与业务代码分离。
- 会话管理:利用 Sa-Token 的会话管理功能,实现全端共享Session或单端独享Session。
- 单点登录:采用 Sa-Token 的 SSO 单点登录功能,支持多种架构模式,如同域、跨域、共享Redis等。
4. 典型生态项目
- Snowy:国内首个国密前后分离快速开发平台,采用 Vue3 + AntDesignVue3 + Vite + SpringBoot + Mp + HuTool + SaToken。
- RuoYi-Vue-Plus:重写RuoYi-Vue所有功能,集成 Sa-Token + Mybatis-Plus + Jackson + Xxl-Job + knife4j + Hutool + OSS。
- Smart-Admin:国内首个以“高质量代码”为核心,“简洁、高效、安全”的中后台快速开发平台。
- 灯灯:专注于多租户解决方案的微服务中后台快速开发平台。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考