目录
前言
之前无意中发现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包和对应的源码。
- 我在项目中引入的是:
implementation("cn.dev33:sa-token-spring-boot-starter:1.37.0")
- 然后这个包间接引入了三个包
- 可以看到其中
cn.dev33:sa-token-spring-boot-starter
和cn.dev33:sa-token-spring-boot-autoconfig
明显是和SpringBoot集成相关的。 于是打开两个包查看源码。 - 发现
cn.dev33:sa-token-spring-boot-starter
是和javax.servlet
相关的, 并且其中的类比较少和简单。 于是我把其中的类全部复制到我的项目的com.github.blanexie.vxph.common.satoken
包路径中,并且把其中的javax.servlet
包名全部换成jakarta.servlet
包名。 - 要注意官方包是通过
spring.factories
文件的方式把SaTokenContextRegister
类引入到Spring的容器中来完成集成的。 因此复制了后,需要我们手动把这个类加入到容器中, 很简单直接在这个类上面加上@Configuration
注解
- 删除
cn.dev33:sa-token-spring-boot-starter
包的引入, 注意SaToken的其他核心包是通过这个包间接引入的,所以我们还需要手动引入其他包。 - 至此整个整合动作完成,启动项目,访问相关接口, 生效OK
总结
Java21已经发布了, 并且包含激动人心的虚拟线程功能, 要跟上时代的脚步。
本文章解决的问题就是 Java17相关包名称修改导致的问题, 需要的了解相关SpringBoot
的starter
模块的知识。 需要了解Gradle/Maven
包依赖引入的关系知识等。
其实只要知道根本底层原理,很多问题都有解决方案的。
下篇文章讲解如何设计权限角色表, 并且配合SaToken来实现权限控制的动态改变。