Sa-Token 整合Java17和SpringBoot

前言

之前无意中发现Sa-Token权限认证框架，项目十分好用。

• 项目地址： https://github.com/dromara/sa-token
• 官网地址： https://sa-token.cc/doc.html#/start/example

我的个人项目使用的是Kotlin+JDK17+SpringBoo3t ， 于是我也想在这个项目中使用， 可是发现有很多的问题， 无法兼容17的jdk版本，主要原因是17版本都javax.servlet相关的包都更名成jakarta.servlet了， 于是进行了适当的改造。

这个框架也提供了支持SpringBoot3的版本， 现在可以直接使用了。

我的个人项目地址： https://github.com/blanexie/vxph
本次修改的类路径： com.github.blanexie.vxph.common.satoken

感兴趣的可以直接看源码。

引入项目

官网的相关示例如下：
https://sa-token.cc/doc.html#/start/example

很简单，引入包配置好文件就可以了。 这个

开启登录认证

官网的描述很详细， 我就简单贴下图
https://sa-token.cc/doc.html#/use/login-auth

路由拦截鉴权

当然也支持接口注解鉴权， 但是路由鉴权更灵活， 可以自定义鉴权逻辑， 我后期是想把接口和相关权限角色信息全部写入数据库中， 然后自定义鉴权逻辑，访问数据库表来实现权限拦截。 这样可以方便的通过修改表记录就能配置相关权限信息， 比硬编码注解到代码中要灵活

https://sa-token.cc/doc.html#/use/route-check

解决兼容问题

按照上面的配置完成后，启动项目都是没有报错没有问题的， 可是无论怎样弄就是不生效， 不会进行权限拦截。 于是我去看了下引入的jar包和对应的源码。

1. 我在项目中引入的是： implementation("cn.dev33:sa-token-spring-boot-starter:1.37.0")
2. 然后这个包间接引入了三个包
3. 可以看到其中cn.dev33:sa-token-spring-boot-starter 和 cn.dev33:sa-token-spring-boot-autoconfig 明显是和SpringBoot集成相关的。 于是打开两个包查看源码。
4. 发现 cn.dev33:sa-token-spring-boot-starter 是和javax.servlet 相关的， 并且其中的类比较少和简单。 于是我把其中的类全部复制到我的项目的com.github.blanexie.vxph.common.satoken包路径中，并且把其中的javax.servlet 包名全部换成jakarta.servlet包名。
5. 要注意官方包是通过spring.factories文件的方式把SaTokenContextRegister类引入到Spring的容器中来完成集成的。 因此复制了后，需要我们手动把这个类加入到容器中， 很简单直接在这个类上面加上@Configuration注解
   
6. 删除 cn.dev33:sa-token-spring-boot-starter 包的引入， 注意SaToken的其他核心包是通过这个包间接引入的，所以我们还需要手动引入其他包。
7. 至此整个整合动作完成，启动项目，访问相关接口， 生效OK
   
   

总结

Java21已经发布了， 并且包含激动人心的虚拟线程功能， 要跟上时代的脚步。

本文章解决的问题就是 Java17相关包名称修改导致的问题， 需要的了解相关SpringBoot的starter模块的知识。 需要了解Gradle/Maven包依赖引入的关系知识等。

其实只要知道根本底层原理，很多问题都有解决方案的。

下篇文章讲解如何设计权限角色表， 并且配合SaToken来实现权限控制的动态改变。