Spring Boot之AOP配自定义注解的最佳实践过程
前言
AOP(Aspect Oriented Programming)，即面向切面编程，是Spring框架的大杀器之一。
首先，我声明下，我不是来系统介绍什么是AOP，更不是照本宣科讲解什么是连接点、切面、通知和切入点这些让人头皮发麻的概念。
今天就来说说AOP的一些应用场景以及如何通过和其他特性的结合提升自己的灵活性。下面话不多说了，来一起看看详细的介绍吧
AOP应用举例
AOP的一大好处就是解耦。通过切面，我们可以将那些反复出现的代码抽取出来，放在一个地方统一处理。
同时，抽出来的代码很多是与业务无关的，这样可以方便开发者更加专注自己的业务逻辑的开发。
一个AOP的典型应用场景就是日志打印。
下面是一个极端情况的Controller
@RestController
@RequestMapping("/")
public class HelloController {
private static final Logger LOG = LoggerFactory.getLogger(HelloController.class);
@GetMapping(value = "/index")
public String index(HttpServletRequest request) {
LOG.info("============打印日志开始============");
LOG.info("URL: " + request.getRequestURL().toString());
LOG.info("============打印日志结束============");
return "hello jackie";
}
@GetMapping(value = "/test1")
public String test1(HttpServletRequest request, String var1) {
LOG.info("============打印日志开始============");
LOG.info("URL: " + request.getRequestURL().toString());
LOG.info("============打印日志结束============");
return "test1";
}
@DemoAnnotation
@GetMapping(value = "/test2")
public String test2(HttpServletRequest request, String var1, String var2) {
LOG.info("============打印日志开始============");
LOG.info("URL: " + request.getRequestURL().toString());
LOG.info("============打印日志结束============");
// int i = 1/0;
if (1<2)
throw new IllegalArgumentException("exception");
return "test2";
}
}
HelloController中提供了三个Http接口，由于业务需要，所以每次进入某个方法的时候都需要打印请求的相关信息。
当然，如果只是上面的例子，我们完全可以通过其他手段让代码看着并不这么糟糕。我们可以抽象一个打印方法，将相同的代码封装在这个方法中，之后在各个方法中每次调用即可。
但是，这种处理方法似乎抽象的还不够，因为我们在每个Http接口中还是要调用这个抽象的函数。而且，比较要命的是，这打印日志的代码与其他业务代码显得有些格格不入。
所以，这时候，我们想到了AOP。
如何使用AOP
在Spring Boot项目中，只需要如下几步，就可以轻松上手AOP。
添加maven依赖
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-aop</artifactId> </dependency>
编写切面类
@Aspect
@Component
public class DemoAspect {
private static final Logger LOG = LoggerFactory.getLogger(DemoAspect.class);
@Pointcut("execution(public * com.jackie.springbootdemo.controller.HelloController.test*(..))")
public void addAdvice(){}
@Before("addAdvice()")
public void before(JoinPoint joinPoint){
Object[] args = joinPoint.getArgs();
HttpServletRequest requests = (HttpServletRequest) args[0];
LOG.info("============打印日志开始============");
LOG.info("URL: " + requests.getRequestURL().toString());
LOG.info("============打印日志结束============");
// LOG.info("before....");
}
}
结果验证对比
启动SpringBootDemoApplication，访问url：http://localhost:8080/test2?var1=1&var2=2
未使用切面功能打印日志
使用切面功能打印日志
从上面的结果展示发现，最终的效果是一样的，但是使用切面更加简洁，而且可复用。
如上访问的是test2接口，如果访问test1接口也可以走切面类实现打印日志的需求，但是如果走index请求就不会打印日志了。
这是为什么呢？
AOP的局限
在切面类DemoAspect中，我们看到了切入点的设置
@Pointcut("execution(public * com.jackie.springbootdemo.controller.HelloController.test*(..))")
public void addAdvice(){}
其中Pointcut后面的表达式是用于控制切面的有效影响范围。
**表达式中，第一个表示返回任意类型，第二个表示任意方法名，后面的小括号表示任意参数值，这里是以test为前缀的，所以可以匹配上test1和test2方法。
注意，在第二个之前也可以再有个，即HelloController所在位置，表示任意类名，假如这里是有两个*.则表示包括包里面的子包。**
好了，明白了表达式的含义，我们自然就看到了AOP的局限性。
当我们要使用切面前，就要写好表达式，但是项目一直在做，代码一直在加，那谁能保证后面接收代码的兄弟也正好知道这个test前缀的意义这么重大呢？
如果他非要用hello作为前缀，那么本应该匹配到的接口就匹配不上了，日志也就不能正常打印了。
这时候，自定义注解，就能够很好的解决这个问题。
自定义注解配合AOP
新建一个自定义注解
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface DemoAnnotation {
}
自定义注解的花样也很多，比如可以在注解中声明变量等，但这些不是我们这次讨论的重点。
将该注解添加到Http接口test2方法上
@DemoAnnotation
@GetMapping(value = "/test2")
public String test2(HttpServletRequest request, String var1, String var2) {
// LOG.info("============打印日志开始============");
// LOG.info("URL: " + request.getRequestURL().toString());
// LOG.info("============打印日志结束============");
// int i = 1/0;
if (1<2)
throw new IllegalArgumentException("exception");
return "test2";
}
在切面类中将切入点的表达式改为
@Pointcut("execution(public * com.jackie.springbootdemo.controller.*.*(..)) && @annotation(com.jackie.springbootdemo.annotation.DemoAnnotation)")
public void addAdvice(){}
这样，我们不需要限制在controller类中是以test作为前缀了，只要是在上面定义的类路径下，并且扫描到注解DemoAnnotation就可以让切面生效。
从结果可以看出，访问http://localhost:8080/test1?var1=1并没有经过切面处理，因为不满足切入点中的表达式要求。
这样做的好处在于，控制的粒度更细，也更加灵活，方便切面功能的实现和细分。
代码已提交至rome
总结
以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作具有一定的参考学习价值，如果有疑问大家可以留言交流，谢谢大家对脚本之家的支持。
相关文章
这篇文章主要介绍了Java中的观察者模式实例讲解,本文先是讲解了观察者模式的概念,然后以实例讲解观察者模式的实现,以及给出了UML图,需要的朋友可以参考下2014-12-12
这篇文章主要为大家详细介绍了如何使用Springboot实现获取实时天气功能,文中的示例代码讲解详细,有需要的小伙伴可以跟随小编一起学习一下2024-04-04
SpringBoot基于Mybatis拦截器和JSqlParser实现数据隔离
本文将介绍如何在 Spring Boot 项目中利用Mybatis的强大拦截器机制结合JSqlParser,一个功能丰富的 SQL 解析器,来轻松实现数据隔离的目标,本文根据示例展示如何根据当前的运行环境来实现数据隔离,需要的朋友可以参考下2024-04-04
这篇文章主要为大家介绍了druid连接池的参数配置示例全面解析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪2023-09-09
这篇文章主要为大家详细介绍了Java SpringAOP技术之注解方式，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下，希望能够给你带来帮助2022-02-02
Spring Boot开发时Java对象和Json对象之间的转换
在Spring Boot开发中,我们经常需要处理Java对象和Json对象之间的转换,本文将介绍如何在Spring Boot项目中实现Java对象和Json对象之间的转换,感兴趣的朋友跟随小编一起看看吧2023-09-09![Java实现文件压缩与解压的示例[zip格式,gzip格式]](//img.jbzj.com/images/xgimg/bcimg6.png)
Java实现文件压缩与解压的示例[zip格式,gzip格式]
本篇文章主要介绍了Java实现文件压缩与解压的示例[zip格式,gzip格式],具有一定的参考价值，感兴趣的小伙伴们可以参考一下。2017-01-01
这篇文章主要介绍了springboot运行时新增/更新外部接口的实现方法,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2021-03-03
Spring Boot项目中遇到`if-else`语句七种具体使用方法解析
当在Spring Boot项目中遇到大量if-else语句时,优化这些代码变得尤为重要,因为它们不仅增加了维护难度,还可能影响应用程序的可读性和性能,以下是七种具体的方法,用于在Spring Boot项目中优化和重构if-else语句,感兴趣的朋友一起看看吧2024-07-07
这篇文章主要介绍了JAVA Static关键字的用法，文中讲解非常细致，代码帮助大家更好的理解和学习，感兴趣的朋友可以了解下，希望能给你带来帮助2021-08-08
![Java实现文件压缩与解压的示例[zip格式,gzip格式]](http://img.jbzj.com/images/xgimg/bcimg6.png)
最新评论