news 2026/4/17 9:47:06

SpringBoot + SpEL,轻松搞定复杂权限控制,非常优雅!

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
SpringBoot + SpEL,轻松搞定复杂权限控制,非常优雅!

对于在Springboot中,利用自定义注解+切面来实现接口权限的控制这个大家应该都很熟悉,也有大量的博客来介绍整个的实现过程,整体来说思路如下:

  1. 自定义一个权限校验的注解,包含参数value

  2. 配置在对应的接口上

  3. 定义一个切面类,指定切点

  4. 在切入的方法体里写上权限判断的逻辑

乍一看,没毛病,学到了,学到了~,收藏起来。但是呢,等到实际用到的时候就傻眼了,为什么呢?在实际的开发中,你会发现,对于权限校验的需求场景是很多的,比如:

  1. 只要配置了任何角色,就可以访问

  2. 有某个权限就可以访问

  3. 放行所有请求

  4. 只有超级管理员角色才可以访问

  5. 只有登录后才可以访问

  6. 在指定时间段内可以访问

  7. 有某个角色的情况下才可以访问

  8. 同时具有指定的多个角色情况下才可以访问

傻眼了不,按照上面的实现逻辑的话怎么搞?加注解?写各种判断?这时候,其实我们就可以通过SpEL表达式来帮我们处理这个问题。

SpEL表达式

本文前面提到SpEL,那么到底SpEL是啥呢?

SpEL的全称为Spring Expression Language,即Spring表达式语言。是Spring3.0提供的。他最强大的功能是可以通过运行期间执行的表达式将值装配到我们的属性或构造函数之中。

如果有小伙伴之前没有接触过,不太理解这句话的含义,那么不要紧,继续往下看,通过后续的实践你就能明白他的作用了。

开搞

自定义注解

当然,万变不离其宗,自定义注解我们还是需要滴。这里呢,我们仅需要定义一个value属性用于接收表达式即可。

@Target({ElementType.METHOD, ElementType.TYPE}) @Retention(RetentionPolicy.RUNTIME) public @interface PreAuth { /** * * * permissionAll()-----只要配置了角色就可以访问 * hasPermission("MENU.QUERY")-----有MENU.QUERY操作权限的角色可以访问 * permitAll()-----放行所有请求 * denyAll()-----只有超级管理员角色才可访问 * hasAuth()-----只有登录后才可访问 * hasTimeAuth(1,,10)-----只有在1-10点间访问 * hasRole(‘管理员’)-----具有管理员角色的人才能访问 * hasAllRole(‘管理员’,'总工程师')-----同时具有管理员、总工程师角色的人才能访问 * * Spring el * 文档地址:https://docs.spring.io/spring/docs/5.1.6.RELEASE/spring-framework-reference/core.html#expressions */ String value(); }

定义切面

注解定义好了,我们就需要定义切面了。这里要考虑一个点。我们希望的是如果方法上有注解,则对方法进行限制,若方法上无注解,单是类上有注解,那么类上的权限注解对该类下所有的接口生效。因此,我们切点的话要用@within注解。代码如下:

@Around( "@annotation(PreAuth注解路径) || " + "@within(PreAuth注解路径)" ) public Object preAuth(ProceedingJoinPoint point) throws Throwable { if (handleAuth(point)) { return point.proceed(); } thrownew SecureException(ResultCode.REQ_REJECT); } private boolean handleAuth(ProceedingJoinPoint point) { //TODO 逻辑判断,返回true or false }

权限校验

关键点来了。这里我们要引入SpEL。

首先,引入SpEL:
private static final ExpressionParser EXPRESSION_PARSER = new SpelExpressionParser();
然后,从注解上获取我们需要的表达式:
MethodSignature ms = point.getSignature() instanceof MethodSignature? (MethodSignature) point.getSignature():null; Method method = ms.getMethod(); // 读取权限注解,优先方法上,没有则读取类 PreAuth preAuth = ClassUtil.getAnnotation(method, PreAuth.class); // 判断表达式 String condition = preAuth.value(); if (StringUtil.isNotBlank(condition)) { //TODU 表达式解析 }
表达式解析
private boolean handleAuth(ProceedingJoinPoint point) { MethodSignature ms = point.getSignature() instanceof MethodSignature? (MethodSignature) point.getSignature():null; Method method = ms.getMethod(); // 读取权限注解,优先方法上,没有则读取类 PreAuth preAuth = ClassUtil.getAnnotation(method, PreAuth.class); // 判断表达式 String condition = preAuth.value(); if (StringUtil.isNotBlank(condition)) { Expression expression = EXPRESSION_PARSER.parseExpression(condition); // 方法参数值 Object[] args = point.getArgs(); StandardEvaluationContext context = getEvaluationContext(method, args); //获取解析计算的结果 return expression.getValue(context, Boolean.class); } returnfalse; } /** * 获取方法上的参数 * * @param method 方法 * @param args 变量 * @return {SimpleEvaluationContext} */ private StandardEvaluationContext getEvaluationContext(Method method, Object[] args) { // 初始化Sp el表达式上下文,并设置 AuthFun StandardEvaluationContext context = new StandardEvaluationContext(new AuthFun()); // 设置表达式支持spring bean context.setBeanResolver(new BeanFactoryResolver(applicationContext)); for (int i = 0; i < args.length; i++) { // 读取方法参数 MethodParameter methodParam = ClassUtil.getMethodParameter(method, i); // 设置方法 参数名和值 为spel变量 context.setVariable(methodParam.getParameterName(), args[i]); } return context; }
自定义解析方法

看完上面的解析处理是不是很蒙蔽,只看到了获取表达式,获取参数,设置参数,然后expression.getValue就完事了。有的同学会问,你权限校验的逻辑呢?

别急,关键点在这:StandardEvaluationContext context = new StandardEvaluationContext(new AuthFun());在上文代码中找到了吧。这个AuthFun就是我们进行权限校验的对象。

所以呢,我们还得在定义一下这个对象。进行具体的权限校验逻辑处理,这里定的每一个方法都可以作为表达式在权限注解中使用。代码如下:

public class AuthFun { /** * 判断角色是否具有接口权限 * * @return {boolean} */ public boolean permissionAll() { //TODO } /** * 判断角色是否具有接口权限 * * @param permission 权限编号,对应菜单的MENU_CODE * @return {boolean} */ public boolean hasPermission(String permission) { //TODO } /** * 放行所有请求 * * @return {boolean} */ public boolean permitAll() { returntrue; } /** * 只有超管角色才可访问 * * @return {boolean} */ public boolean denyAll() { return hasRole(RoleConstant.ADMIN); } /** * 是否已授权 * * @return {boolean} */ public boolean hasAuth() { if(Func.isEmpty(AuthUtil.getUser())){ // TODO 返回异常提醒 }else{ returntrue; } } /** * 是否有时间授权 * * @param start 开始时间 * @param end 结束时间 * @return {boolean} */ public boolean hasTimeAuth(Integer start, Integer end) { Integer hour = DateUtil.hour(); return hour >= start && hour <= end; } /** * 判断是否有该角色权限 * * @param role 单角色 * @return {boolean} */ public boolean hasRole(String role) { return hasAnyRole(role); } /** * 判断是否具有所有角色权限 * * @param role 角色集合 * @return {boolean} */ public boolean hasAllRole(String... role) { for (String r : role) { if (!hasRole(r)) { returnfalse; } } returntrue; } /** * 判断是否有该角色权限 * * @param role 角色集合 * @return {boolean} */ public boolean hasAnyRole(String... role) { //获取当前登录用户 BladeUser user = AuthUtil.getUser(); if (user == null) { returnfalse; } String userRole = user.getRoleName(); if (StringUtil.isBlank(userRole)) { returnfalse; } String[] roles = Func.toStrArray(userRole); for (String r : role) { if (CollectionUtil.contains(roles, r)) { returntrue; } } returnfalse; } }

实际使用

在使用的时候,我们只需要在类上或者接口上,加上@PreAuth的直接,value值写的时候要注意一下,value应该是我们在AuthFun类中定义的方法和参数,如我们定义了解析方法hasAllRole(String... role),那么在注解中,我们就可以这样写@PreAuth("hasAllRole('角色1','角色2')"),需要注意的是,参数要用单引号包括。

@PreAuth("hasPermission('LM_QUERY,LM_QUERY_ALL')") public T 接口名称....

原理

根据上面的实际使用,可以看到。SpEL表达式解析将我们注解中的"hasAllRole('角色1','角色2')"这样的字符串,给动态解析为了hasAllRole(参数1,参数1),并调用我们注册类中同名的方法。

总结

通过SpEL的使用,让我们的权限配置校验更加灵活。当出现新的场景时,我们仅需要在自定的表达式解析类中增加对应场景的解析方法即可。相对于之前的实现方式,这不得不说是更好的一个选择。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/16 12:55:01

节省50%算力成本!SenseVoiceSmall低功耗GPU部署实战方案

节省50%算力成本&#xff01;SenseVoiceSmall低功耗GPU部署实战方案 你是否遇到过这样的问题&#xff1a;语音识别服务一上线&#xff0c;GPU显存就飙到95%&#xff0c;推理延迟忽高忽低&#xff0c;批量处理几十条音频就得排队等半天&#xff1f;更别说还要为情感分析、声音事…

作者头像 李华
网站建设 2026/4/16 2:49:57

Z-Image-Turbo日志轮转:防止output.log无限增长的配置方案

Z-Image-Turbo日志轮转&#xff1a;防止output.log无限增长的配置方案 Z-Image-Turbo 是一款集成了图像生成与处理能力的本地化AI工具&#xff0c;其UI界面简洁直观&#xff0c;适合各类用户快速上手。通过图形化操作面板&#xff0c;用户可以轻松完成文生图、图生图、风格迁移…

作者头像 李华
网站建设 2026/4/16 9:40:36

Qwen-Image-2512如何持续集成?CI/CD自动化部署案例

Qwen-Image-2512如何持续集成&#xff1f;CI/CD自动化部署案例 1. 引言&#xff1a;为什么需要为Qwen-Image-2512做CI/CD&#xff1f; 你有没有遇到过这种情况&#xff1a;每次模型更新都要手动拉代码、重新配置环境、重启服务&#xff0c;费时又容易出错&#xff1f;尤其是像…

作者头像 李华
网站建设 2026/4/16 11:17:59

GPT-OSS开源贡献指南:提交PR与issue规范

GPT-OSS开源贡献指南&#xff1a;提交PR与issue规范 1. 引言&#xff1a;为什么参与GPT-OSS的开源共建&#xff1f; 你可能已经听说了&#xff0c;GPT-OSS 正在成为开源社区中备受关注的大模型项目之一。它不仅继承了OpenAI在语言建模上的技术积累&#xff0c;还通过开放协作…

作者头像 李华
网站建设 2026/4/16 9:40:42

GPEN训练loss不收敛?常见问题排查与调参技巧

GPEN训练loss不收敛&#xff1f;常见问题排查与调参技巧 GPEN人像修复增强模型镜像 本镜像基于 GPEN人像修复增强模型 构建&#xff0c;预装了完整的深度学习开发环境&#xff0c;集成了推理及评估所需的所有依赖&#xff0c;开箱即用。 1. 镜像环境说明 组件版本核心框架P…

作者头像 李华
网站建设 2026/4/16 9:40:41

Qwen-Image-2512和SDXL Turbo对比:出图速度实测报告

Qwen-Image-2512和SDXL Turbo对比&#xff1a;出图速度实测报告 1. 引言&#xff1a;为什么这次对比值得关注 你有没有遇到过这样的情况&#xff1a;明明想法已经成型&#xff0c;却卡在生成图片的等待上&#xff1f;等个十几秒还算幸运&#xff0c;有时候动辄半分钟&#xf…

作者头像 李华