前言
假如咱们有如下需要: 咱们怎么实现呢?给每个接口加上鉴权注解?手写全局拦截器?仿佛都不是十分不便。在这个需要中咱们真正须要的是一种基于路由拦挡的鉴权模式, 那么在 sa-token 怎么实现路由拦挡鉴权呢?
应用形式
1、注册路由拦截器
以 springboot2.0 为例, 新建配置类MySaTokenConfig.java
@Configuration
public class MySaTokenConfig implements WebMvcConfigurer {
// 注册 sa-token 的登录拦截器
@Override
public void addInterceptors(InterceptorRegistry registry) {
// 注册登录拦截器,并排除登录接口地址
registry.addInterceptor(new SaRouteInterceptor()).addPathPatterns("/**").excludePathPatterns("/user/doLogin");
}
}
以上代码,咱们注册了一个登录验证拦截器,并且排除了 /user/doLogin 接口用来凋谢登录 那么咱们如何进行权限认证拦挡呢,且往下看
2、所有拦截器示例
@Configuration
public class MySaTokenConfig implements WebMvcConfigurer {
// 注册 sa-token 的所有拦截器
@Override
public void addInterceptors(InterceptorRegistry registry) {
// 注册一个登录验证拦截器
registry.addInterceptor(SaRouteInterceptor.createLoginVal()).addPathPatterns("/**").excludePathPatterns("/user/doLogin");
// 注册一个角色认证拦截器
registry.addInterceptor(SaRouteInterceptor.createRoleVal("super-admin")).addPathPatterns("/**");
// 注册一个权限认证拦截器
registry.addInterceptor(SaRouteInterceptor.createPermissionVal("user:add", "user:deelete")).addPathPatterns("/UserController/**");
// 注册一个自定义认证拦截器 (能够写任意认证代码)
registry.addInterceptor(new SaRouteInterceptor((request, response, handler)->{System.out.println("---------- 进入自定义认证 ---------------");
// 你能够在这里写任意认证代码, 例如: StpUtil.checkLogin();})).addPathPatterns("/**");
}
}
(你不用像下面的示例一样注册所有拦截器,只有按需注册即可)
3、让咱们利用自定义拦截器做点快活的事件
你能够依据路由划分模块,不同模块不同鉴权
@Configuration
public class MySaTokenConfig implements WebMvcConfigurer {
// 注册 sa-token 的所有拦截器
@Override
public void addInterceptors(InterceptorRegistry registry) {registry.addInterceptor(new SaRouteInterceptor((request, response, handler)->{
// 依据路由划分模块,不同模块不同鉴权
SaRouterUtil.match("/user/**", () -> StpUtil.checkPermission("user"));
SaRouterUtil.match("/admin/**", () -> StpUtil.checkPermission("admin"));
SaRouterUtil.match("/goods/**", () -> StpUtil.checkPermission("goods"));
SaRouterUtil.match("/orders/**", () -> StpUtil.checkPermission("orders"));
SaRouterUtil.match("/notice/**", () -> StpUtil.checkPermission("notice"));
SaRouterUtil.match("/comment/**", () -> StpUtil.checkPermission("comment"));
})).addPathPatterns("/**");
}
}
4、残缺的示例
最终的代码,可能会相似于上面的样子:
@Configuration
public class MySaTokenConfig implements WebMvcConfigurer {
// 注册 sa-token 的拦截器
@Override
public void addInterceptors(InterceptorRegistry registry) {
// 自定义验证拦截器
registry.addInterceptor(new SaRouteInterceptor((request, response, handler) -> {
// 登录验证 -- 拦挡所有路由,并排除 /user/doLogin 用于凋谢登录
SaRouterUtil.match("/**", "/user/doLogin", () -> StpUtil.checkLogin());
// 角色认证 -- 拦挡以 admin 结尾的路由,必须具备 [admin] 角色或者 [super-admin] 角色才能够通过认证
SaRouterUtil.match("/admin/**", () -> StpUtil.checkRoleOr("admin", "super-admin"));
// 权限认证 -- 不同模块, 校验不同权限
SaRouterUtil.match("/user/**", () -> StpUtil.checkPermission("user"));
SaRouterUtil.match("/admin/**", () -> StpUtil.checkPermission("admin"));
SaRouterUtil.match("/goods/**", () -> StpUtil.checkPermission("goods"));
SaRouterUtil.match("/orders/**", () -> StpUtil.checkPermission("orders"));
SaRouterUtil.match("/notice/**", () -> StpUtil.checkPermission("notice"));
SaRouterUtil.match("/comment/**", () -> StpUtil.checkPermission("comment"));
// 匹配 RESTful 格调路由
SaRouterUtil.match("/article/get/{id}", () -> StpUtil.checkPermission("article"));
})).addPathPatterns("/**");
}
}
写在最初
源码开源,作者不易,如果你喜爱这个框架麻烦你顺手点一颗小星星哦!
- 官网文档:http://sa-token.dev33.cn/
- Gitee 开源地址: https://gitee.com/sz6/sa-token
- GitHub 开源地址: https://github.com/click33/sa-token