sa-token/sa-token-doc/start/download.md

10 KiB
Raw Blame History

其它环境引入 Sa-Token 的示例

目前已实现的对接框架综合


Maven依赖

根据不同基础框架引入不同的 Sa-Token 依赖:

如果你使用的框架基于 ServletAPI 构建( SpringMVC、SpringBoot等 ),请引入此包

<!-- Sa-Token 权限认证, 在线文档http://sa-token.dev33.cn/ -->
<dependency>
	<groupId>cn.dev33</groupId>
	<artifactId>sa-token-spring-boot-starter</artifactId>
	<version>${sa.top.version}</version>
</dependency>

注:如果你使用的框架基于 Reactor 模型构建Netty、WebFlux、ShenYu、SC Gateway等请引入此包

<!-- Sa-Token 权限认证Reactor响应式集成, 在线文档http://sa-token.dev33.cn/ -->
<dependency>
	<groupId>cn.dev33</groupId>
	<artifactId>sa-token-reactor-spring-boot-starter</artifactId>
	<version>${sa.top.version}</version>
</dependency>

参考:Solon官网

<!-- Sa-Token 整合 Solon, 在线文档http://sa-token.dev33.cn/ -->
<dependency>
	<groupId>cn.dev33</groupId>
	<artifactId>sa-token-solon-plugin</artifactId>
	<version>${sa.top.version}</version>
</dependency>

参考:JFinal官网

<!-- Sa-Token 整合 JFinal, 在线文档http://sa-token.dev33.cn/ -->
<dependency>
	<groupId>cn.dev33</groupId>
	<artifactId>sa-token-jfinal-plugin</artifactId>
	<version>${sa.top.version}</version>
</dependency>

参考:Jboot官网

<!-- Sa-Token 整合 Jboot, 在线文档http://sa-token.dev33.cn/ -->
<dependency>
	<groupId>cn.dev33</groupId>
	<artifactId>sa-token-jboot-plugin</artifactId>
	<version>${sa.top.version}</version>
</dependency>

参考:quarkus-sa-token

<!-- Sa-Token 整合 Quarkus, 在线文档http://sa-token.dev33.cn/ -->
<dependency>
	<groupId>io.quarkiverse.satoken</groupId>
	<artifactId>quarkus-satoken-resteasy</artifactId>
	<version>1.30.0</version>
</dependency>

如果你的项目没有使用Spring但是Web框架是基于 ServletAPI 规范的,可以引入此包

<!-- Sa-Token 权限认证ServletAPI规范, 在线文档http://sa-token.dev33.cn/ -->
<dependency>
	<groupId>cn.dev33</groupId>
	<artifactId>sa-token-servlet</artifactId>
	<version>${sa.top.version}</version>
</dependency>

引入此依赖需要自定义 SaTokenContext 实现,参考:自定义 SaTokenContext 指南

注:如果你的项目既没有使用 SpringMVC、WebFlux也不是基于 ServletAPI 规范那么可以引入core核心包

<!-- Sa-Token 权限认证core核心包, 在线文档http://sa-token.dev33.cn/ -->
<dependency>
	<groupId>cn.dev33</groupId>
	<artifactId>sa-token-core</artifactId>
	<version>${sa.top.version}</version>
</dependency>

引入此依赖需要自定义 SaTokenContext 实现,参考:自定义 SaTokenContext 指南

Gradle依赖

implementation 'cn.dev33:sa-token-spring-boot-starter:${sa.top.version}'
implementation 'cn.dev33:sa-token-reactor-spring-boot-starter:${sa.top.version}'
implementation 'cn.dev33:sa-token-solon-plugin:${sa.top.version}'
implementation 'cn.dev33:sa-token-jfinal-plugin:${sa.top.version}'
implementation 'cn.dev33:sa-token-jboot-plugin:${sa.top.version}'
implementation 'io.quarkiverse.satoken:quarkus-satoken-resteasy:1.30.0'
implementation 'cn.dev33:sa-token-servlet:${sa.top.version}'
implementation 'cn.dev33:sa-token-core:${sa.top.version}'

JDK版本v1.8+SpringBoot建议2.0以上

测试版

更多内测版本了解:Sa-Token 最新版本

Maven依赖一直无法加载成功参考解决方案

jar包下载

点击下载sa-token-1.6.0.jar

注:当前仅提供 v1.6.0 版本jar包下载更多版本请前往 maven 中央仓库获取,直达链接

获取源码

如果你想深入了解 Sa-Token你可以通过Gitee或者GitHub来获取源码 学习测试请拉取 master 分支dev为正在开发的分支有很多特性并不稳定

── sa-token
	├── sa-token-core                         // [核心] Sa-Token 核心模块
	├── sa-token-starter                      // [整合] Sa-Token 与其它框架整合
		├── sa-token-servlet                      // [整合] Sa-Token 整合 Servlet容器实现类包
		├── sa-token-spring-boot-starter          // [整合] Sa-Token 整合 SpringBoot 快速集成 
		├── sa-token-reactor-spring-boot-starter  // [整合] Sa-Token 整合 Reactor 响应式编程 快速集成 
		├── sa-token-solon-plugin                 // [整合] Sa-Token 整合 Solon 快速集成 
		├── sa-token-jfinal-plugin                // [整合] Sa-Token 整合 JFinal 快速集成 
		├── sa-token-jboot-plugin                 // [整合] Sa-Token 整合 jboot 快速集成 
	├── sa-token-plugin                       // [插件] Sa-Token 插件合集
		├── sa-token-dao-redis                    // [插件] Sa-Token 整合 Redis (使用jdk默认序列化方式)
		├── sa-token-dao-redis-jackson            // [插件] Sa-Token 整合 Redis (使用jackson序列化方式)
		├── sa-token-spring-aop                   // [插件] Sa-Token 整合 SpringAOP 注解鉴权
		├── sa-token-temp-jwt                     // [插件] Sa-Token 整合 jwt 临时令牌鉴权 
		├── sa-token-quick-login                  // [插件] Sa-Token 快速注入登录页插件 
		├── sa-token-alone-redis                  // [插件] Sa-Token 独立Redis插件实现[权限缓存与业务缓存分离]
		├── sa-token-sso                          // [插件] Sa-Token 整合 SSO 单点登录
		├── sa-token-oauth2                       // [插件] Sa-Token 实现 OAuth2.0 模块 
		├── sa-token-dialect-thymeleaf            // [插件] Sa-Token 标签方言Thymeleaf版
		├── sa-token-jwt                          // [插件] Sa-Token 整合 jwt 登录认证
	├── sa-token-demo                         // [示例] Sa-Token 示例合集
		├── sa-token-demo-cases                   // [示例] Sa-Token 各模块示例
		├── sa-token-demo-springboot              // [示例] Sa-Token 整合 SpringBoot 
		├── sa-token-demo-springboot-redis        // [示例] Sa-Token 整合 SpringBoot 整合 Redis 
		├── sa-token-demo-webflux                 // [示例] Sa-Token 整合 WebFlux 
		├── sa-token-demo-jwt                     // [示例] Sa-Token 集成 jwt 
		├── sa-token-demo-solon                   // [示例] Sa-Token 集成 Solon 
		├── sa-token-demo-quick-login             // [示例] Sa-Token 集成 quick-login 模块 
		├── sa-token-demo-alone-redis             // [示例] Sa-Token 集成 alone-redis 模块
		├── sa-token-demo-thymeleaf               // [示例] Sa-Token 集成 Thymeleaf 标签方言
		├── sa-token-demo-jwt                     // [示例] Sa-Token 集成 jwt 登录认证 
		├── sa-token-demo-sso-server              // [示例] Sa-Token 集成 SSO单点登录-Server认证中心
		├── sa-token-demo-sso1-client             // [示例] Sa-Token 集成 SSO单点登录-模式一 应用端 
		├── sa-token-demo-sso2-client             // [示例] Sa-Token 集成 SSO单点登录-模式二 应用端
		├── sa-token-demo-sso3-client             // [示例] Sa-Token 集成 SSO单点登录-模式三 应用端
		├── sa-token-demo-sso3-client-nosdk       // [示例] Sa-Token 集成 SSO单点登录-模式三 应用端 (不使用sdk纯手动对接)
		├── sa-token-demo-sso-server-h5           // [示例] Sa-Token 集成 SSO单点登录-Server认证中心 (前后端分离)
		├── sa-token-demo-sso-client-h5           // [示例] Sa-Token 集成 SSO单点登录-client应用端 (前后端分离)
		├── sa-token-demo-oauth2-server           // [示例] Sa-Token 集成 OAuth2.0 (服务端)
		├── sa-token-demo-oauth2-client           // [示例] Sa-Token 集成 OAuth2.0 (客户端)
		├── sa-token-demo-websocket               // [示例] Sa-Token 集成 Web-Socket 鉴权示例
		├── sa-token-demo-websocket-spring        // [示例] Sa-Token 集成 Web-SocketSpring封装版 鉴权示例
	├── sa-token-test                         // [测试] Sa-Token 单元测试合集
		├── sa-token-core-test                    // [测试] Sa-Token Core核心包单元测试
		├── sa-token-springboot-test              // [测试] Sa-Token SpringBoot 整合测试
		├── sa-token-springboot-integrate-test    // [测试] Sa-Token SpringBoot 整合客户端测试
		├── sa-token-jwt-test                     // [测试] Sa-Token jwt 整合测试
	├── sa-token-doc                          // [文档] Sa-Token 开发文档 
	├──pom.xml                                // [依赖] 顶级pom文件 

运行示例

  • 1、下载代码学习测试用 master 分支)。
  • 2、从根目录导入项目。
  • 3、选择相应的示例添加为 Maven 项目,打开 XxxApplication.java 运行。

运行示例