lsm/sa-token
1
0
Fork 0
mirror of https://gitee.com/dromara/sa-token.git synced 2026-02-27 16:50:24 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

docs: 文档优化 [路由拦截鉴权] 篇

Browse Source
This commit is contained in:
click33
2025-12-28 17:53:30 +08:00
parent 7e9201584d
commit 5708657f86
6 changed files with 28 additions and 27 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
sa-token-doc/use/route-check.md
View File

@@ -1,16 +1,17 @@
# 路由拦截鉴权
假设我们有如下需求：<u>*项目中所有接口均需要登录校验，只有 “登录接口” 本身对外开放*</u>。
如果给每个接口都手动加上注解鉴权，将会是一件比较麻烦的事情，这时候使用拦截器鉴权模式将大大降低我们的代码量。
<!-- ![基础-拦截器鉴权.svg](../big-file/use/use-route-check.svg 'w-100') -->
<img class="w-100" src="/big-file/doc/use/use-route-check.svg" />
如上图所示，拦截器将拦截除登录以外的所以请求，并进行一道前置审核决定是否通过。
---
假设我们有如下需求：
> [!INFO| label:需求场景]
> 项目中所有接口均需要登录认证，只有 “登录接口” 本身对外开放
我们怎么实现呢？给每个接口加上鉴权注解？手写全局拦截器？似乎都不是非常方便。
在这个需求中我们真正需要的是一种基于路由拦截的鉴权模式，那么在Sa-Token怎么实现路由拦截鉴权呢？
### 1、注册 Sa-Token 路由拦截器
以`SpringBoot2.0`为例，新建配置类`SaTokenConfigure.java`
@@ -35,7 +36,7 @@ public class SaTokenConfigure implements WebMvcConfigurer {
### 2、校验函数详解
自定义认证规则：`new SaInterceptor(handle -> StpUtil.checkLogin())` 是最简单的写法，代表只进行登录校验功能。
我们可以往构造函数塞一个完整的 lambda 表达式，来定义详细的校验规则，例如：
我们可以往构造函数塞一个完整的 lambda 函数，来定义详细的校验规则，例如：
``` java
@Configuration