写点什么

AOP 切入点表达式及五种通知类型解析

作者:王小凡
  • 2022 年 7 月 26 日
  • 本文字数:6367 字

    阅读完需:约 21 分钟

AOP切入点表达式及五种通知类型解析

一、AOP 切入点表达式

对于 AOP 中切入点表达式,总共有三个大的方面,分别是语法格式通配符书写技巧

1.1 语法格式

首先我们先要明确两个概念:

切入点:要进行增强的方法

切入点表达式:要进行增强的方法的描述方式

对于切入点的描述,我们其实是有两种方式的,先来看下面的例子


描述方式一:执行 com.itheima.dao 包下的 BookDao 接口中的无参数 update 方法

execution(void com.itheima.dao.BookDao.update())
复制代码

描述方式二:执行 com.itheima.dao.impl 包下的 BookDaoImpl 类中的无参数 update 方法

execution(void com.itheima.dao.impl.BookDaoImpl.update())
复制代码

因为调用接口方法的时候最终运行的还是其实现类的方法,所以上面两种描述方式都是可以的。

对于切入点表达式的语法为:

切入点表达式标准格式:动作关键字(访问修饰符 返回值 包名.类/接口名.方法名(参数) 异常名)

对于这个格式,我们不需要硬记,通过一个例子,理解它:

execution(public User com.itheima.service.UserService.findById(int))
复制代码


execution:动作关键字,描述切入点的行为动作,例如execution表示执行到指定切入点public:访问修饰符,还可以是public,private等,可以省略User:返回值,写返回值类型com.itheima.service:包名,多级包使用点连接UserService:类/接口名称findById:方法名int:参数,直接写参数的类型,多个类型用逗号隔开异常名:方法定义中抛出指定异常,可以省略
复制代码

切入点表达式就是要找到需要增强的方法,所以它就是对一个具体方法的描述,但是方法的定义会有很多,所以如果每一个方法对应一个切入点表达式,想想这块就会觉得将来编写起来会比较麻烦,有没有更简单的方式呢?

就需要用到下面的通配符。

1.2 通配符

我们使用通配符描述切入点,主要的目的就是简化之前的配置,具体都有哪些通配符可以使用?

*:单个独立的任意符号,可以独立出现,也可以作为前缀或者后缀的匹配符出现

execution(public * com.itheima.*.UserService.find*(*))
复制代码

匹配 com.itheima 包下的任意包中的 UserService 类或接口中所有 find 开头的带有一个参数的方法

..:多个连续的任意符号,可以独立出现,常用于简化包名与参数的书写

execution(public User com..UserService.findById(..))
复制代码

匹配 com 包下的任意包中的 UserService 类或接口中所有名称为 findById 的方法

:专用于匹配子类类型

execution(* *..*Service+.*(..))
复制代码

这个使用率较低,描述子类的,咱们做 Java 开发,继承机会就一次,使用都很慎重,所以很少用它。*Service+,表示所有以 Service 结尾的接口的子类。

接下来,我们把使用到的切入点表达式来分析下:



execution(void com.itheima.dao.BookDao.update())匹配接口,能匹配到execution(void com.itheima.dao.impl.BookDaoImpl.update())匹配实现类,能匹配到execution(* com.itheima.dao.impl.BookDaoImpl.update())返回值任意,能匹配到execution(* com.itheima.dao.impl.BookDaoImpl.update(*))返回值任意,但是update方法必须要有一个参数,无法匹配,要想匹配需要在update接口和实现类添加参数execution(void com.*.*.*.*.update())返回值为void,com包下的任意包三层包下的任意类的update方法,匹配到的是实现类,能匹配execution(void com.*.*.*.update())返回值为void,com包下的任意两层包下的任意类的update方法,匹配到的是接口,能匹配execution(void *..update())返回值为void,方法名是update的任意包下的任意类,能匹配execution(* *..*(..))匹配项目中任意类的任意方法,能匹配,但是不建议使用这种方式,影响范围广execution(* *..u*(..))匹配项目中任意包任意类下只要以u开头的方法,update方法能满足,能匹配execution(* *..*e(..))匹配项目中任意包任意类下只要以e结尾的方法,update和save方法能满足,能匹配execution(void com..*())返回值为void,com包下的任意包任意类任意方法,能匹配,*代表的是方法execution(* com.itheima.*.*Service.find*(..))将项目中所有业务层方法的以find开头的方法匹配execution(* com.itheima.*.*Service.save*(..))将项目中所有业务层方法的以save开头的方法匹配
复制代码

后面两种更符合我们平常切入点表达式的编写规则

1.3 书写技巧

对于切入点表达式的编写其实是很灵活的,那么在编写的时候,有没有什么好的技巧让我们用用:

所有代码按照标准规范开发,否则以下技巧全部失效描述切入点通常描述接口,而不描述实现类,如果描述到实现类,否则就出现紧耦合了访问控制修饰符针对接口开发均采用public描述(可省略访问控制修饰符描述)返回值类型对于增删改类使用精准类型加速匹配,对于查询类使用*通配快速描述包名书写尽量不使用..匹配,效率过低,常用*做单个包描述匹配,或精准匹配接口名/类名书写名称与模块相关的采用*匹配,例如UserService书写成*Service,绑定业务层接口名方法名书写以动词进行精准匹配,名词采用匹配,例如getById书写成getBy,selectAll书写成selectAll参数规则较为复杂,根据业务方法灵活调整通常不使用异常作为匹配规则
复制代码

二、AOP 通知类型



它所代表的含义是将通知添加到切入点方法执行的前面。

除了这个注解外,还有没有其他的注解,换个问题就是除了可以在前面加,能不能在其他的地方加?

2.1 类型介绍

我们先来回顾下 AOP 通知:

AOP 通知描述了抽取的共性功能,根据共性功能抽取的位置不同,最终运行代码时要将其加入到合理的位置通知具体要添加到切入点的哪里?

共提供了 5 种通知类型:


前置通知后置通知环绕通知(重点)返回后通知(了解)抛出异常后通知(了解)
复制代码

为了更好的理解这几种通知类型,我们来看一张图



(1)前置通知,追加功能到方法执行前,类似于在代码 1 或者代码 2 添加内容

(2)后置通知,追加功能到方法执行后,不管方法执行的过程中有没有抛出异常都会执行,类似于在代码 5 添加内容

(3)返回后通知,追加功能到方法执行后,只有方法正常执行结束后才进行,类似于在代码 3 添加内容,如果方法执行抛出异常,返回后通知将不会被添加

(4)抛出异常后通知,追加功能到方法抛出异常后,只有方法执行出异常才进行,类似于在代码 4 添加内容,只有方法抛出异常后才会被添加

(5)环绕通知,环绕通知功能比较强大,它可以追加功能到方法执行的前后,这也是比较常用的方式,它可以实现其他四种通知类型的功能,具体是如何实现的,需要我们往下学习。

2.2 环境准备

创建一个 Maven 项目

pom.xml 添加 Spring 依赖

<dependencies>    <dependency>        <groupId>org.springframework</groupId>        <artifactId>spring-context</artifactId>        <version>5.2.10.RELEASE</version>    </dependency>    <dependency>      <groupId>org.aspectj</groupId>      <artifactId>aspectjweaver</artifactId>      <version>1.9.4</version>    </dependency></dependencies>
复制代码


添加 BookDao 和 BookDaoImpl 类

public interface BookDao {    public void update();    public int select();}@Repositorypublic class BookDaoImpl implements BookDao {    public void update(){        System.out.println("book dao update ...");    }    public int select() {        System.out.println("book dao select is running ...");        return 100;    }}
复制代码

创建 Spring 的配置类

@Configuration@ComponentScan("com.itheima")@EnableAspectJAutoProxypublic class SpringConfig {}
复制代码

创建通知类

@Component@Aspectpublic class MyAdvice {    @Pointcut("execution(void com.itheima.dao.BookDao.update())")    private void pt(){}    public void before() {        System.out.println("before advice ...");    }    public void after() {        System.out.println("after advice ...");    }    public void around(){        System.out.println("around before advice ...");        System.out.println("around after advice ...");    }    public void afterReturning() {        System.out.println("afterReturning advice ...");    }        public void afterThrowing() {        System.out.println("afterThrowing advice ...");    }}
复制代码

编写 App 运行类

public class App {    public static void main(String[] args) {        ApplicationContext ctx = new AnnotationConfigApplicationContext(SpringConfig.class);        BookDao bookDao = ctx.getBean(BookDao.class);        bookDao.update();    }}
复制代码

最终创建好的项目结构如下:



2.3 通知类型的使用

前置通知

修改 MyAdvice,在 before 方法上添加 @Before 注解

@Component@Aspectpublic class MyAdvice {    @Pointcut("execution(void com.itheima.dao.BookDao.update())")    private void pt(){}        @Before("pt()")    //此处也可以写成 @Before("MyAdvice.pt()"),不建议    public void before() {        System.out.println("before advice ...");    }}
复制代码


后置通知

@Component@Aspectpublic class MyAdvice {    @Pointcut("execution(void com.itheima.dao.BookDao.update())")    private void pt(){}        @Before("pt()")    public void before() {        System.out.println("before advice ...");    }    @After("pt()")    public void after() {        System.out.println("after advice ...");    }}
复制代码



环绕通知

基本使用

@Component@Aspectpublic class MyAdvice {    @Pointcut("execution(void com.itheima.dao.BookDao.update())")    private void pt(){}        @Around("pt()")    public void around(){        System.out.println("around before advice ...");        System.out.println("around after advice ...");    }}
复制代码


运行结果中,通知的内容打印出来,但是原始方法的内容却没有被执行。

因为环绕通知需要在原始方法的前后进行增强,所以环绕通知就必须要能对原始操作进行调用,具体如何实现?

@Component@Aspectpublic class MyAdvice {    @Pointcut("execution(void com.itheima.dao.BookDao.update())")    private void pt(){}        @Around("pt()")    public void around(ProceedingJoinPoint pjp) throws Throwable{        System.out.println("around before advice ...");        //表示对原始操作的调用        pjp.proceed();        System.out.println("around after advice ...");    }}
复制代码

说明:proceed()为什么要抛出异常?

主要原因原始方法不清楚到底执行会不会有异常,所以直接先抛出异常。原因很简单,看下源码就知道了

再次运行,程序可以看到原始方法已经被执行了


注意事项

(1)原始方法有返回值的处理

修改 MyAdvice,对 BookDao 中的 select 方法添加环绕通知,

@Component@Aspectpublic class MyAdvice {    @Pointcut("execution(void com.itheima.dao.BookDao.update())")    private void pt(){}        @Pointcut("execution(int com.itheima.dao.BookDao.select())")    private void pt2(){}        @Around("pt2()")    public void aroundSelect(ProceedingJoinPoint pjp) throws Throwable {        System.out.println("around before advice ...");        //表示对原始操作的调用        pjp.proceed();        System.out.println("around after advice ...");    }}
复制代码

修改 App 类,调用 select 方法

public class App {    public static void main(String[] args) {        ApplicationContext ctx = new AnnotationConfigApplicationContext(SpringConfig.class);        BookDao bookDao = ctx.getBean(BookDao.class);        int num = bookDao.select();        System.out.println(num);    }}
复制代码

运行后会报错,错误内容为:

Exception in thread "main" org.springframework.aop.AopInvocationException: Null return value from advice does not match primitive return type for: public abstract int com.itheima.dao.BookDao.select() at org.springframework.aop.framework.JdkDynamicAopProxy.invoke(JdkDynamicAopProxy.java:226) at com.sun.proxy.$Proxy19.select(Unknown Source) at com.itheima.App.main(App.java:12)

错误大概的意思是:空的返回不匹配原始方法的int返回

void 就是返回 Null

原始方法就是 BookDao 下的 select 方法

所以如果我们使用环绕通知的话,要根据原始方法的返回值来设置环绕通知的返回值,具体解决方案为:

@Component@Aspectpublic class MyAdvice {    @Pointcut("execution(void com.itheima.dao.BookDao.update())")    private void pt(){}        @Pointcut("execution(int com.itheima.dao.BookDao.select())")    private void pt2(){}        @Around("pt2()")    public Object aroundSelect(ProceedingJoinPoint pjp) throws Throwable {        System.out.println("around before advice ...");        //表示对原始操作的调用        Object ret = pjp.proceed();        System.out.println("around after advice ...");        return ret;    }}
复制代码

说明:

为什么返回的是 Object 而不是 int 的主要原因是 Object 类型更通用。所以更一般的写法环绕通知的返回类型写 object 而不是 void,如果没有返回值,那么 object 就为空

在环绕通知中是可以对原始方法返回值就行修改的。

返回后通知

@Component@Aspectpublic class MyAdvice {    @Pointcut("execution(void com.itheima.dao.BookDao.update())")    private void pt(){}        @Pointcut("execution(int com.itheima.dao.BookDao.select())")    private void pt2(){}        @AfterReturning("pt2()")    public void afterReturning() {        System.out.println("afterReturning advice ...");    }}
复制代码


注意:返回后通知是需要在原始方法select正常执行后才会被执行,如果select()方法执行的过程中出现了异常,那么返回后通知是不会被执行。后置通知是不管原始方法有没有抛出异常都会被执行。

异常后通知
@Component@Aspectpublic class MyAdvice {    @Pointcut("execution(void com.itheima.dao.BookDao.update())")    private void pt(){}        @Pointcut("execution(int com.itheima.dao.BookDao.select())")    private void pt2(){}        @AfterReturning("pt2()")    public void afterThrowing() {        System.out.println("afterThrowing advice ...");    }}
复制代码


注意:异常后通知是需要原始方法抛出异常,可以在select()方法中添加一行代码int i = 1/0即可。如果没有抛异常,异常后通知将不会被执行。

介绍完这 5 种通知类型,我们来思考下环绕通知是如何实现其他通知类型的功能的?

因为环绕通知是可以控制原始方法执行的,所以我们把增强的代码写在调用原始方法的不同位置就可以实现不同的通知类型的功能,如:

通知类型总结

知识点 1:@After


知识点 2:@AfterReturning


环绕通知注意事项

环绕通知必须依赖形参ProceedingJoinPoint才能实现对原始方法的调用,进而实现原始方法调用前后同时添加通知通知中如果未使用ProceedingJoinPoint对原始方法进行调用将跳过原始方法的执行对原始方法的调用可以不接收返回值,通知方法设置成void即可,如果接收返回值,最好设定为Object类型原始方法的返回值如果是void类型,通知方法的返回值类型可以设置成void,也可以设置成Object由于无法预知原始方法运行后是否会抛出异常,因此环绕通知方法必须要处理Throwable异常,推荐直接抛出异常
复制代码


用户头像

王小凡

关注

还未添加个人签名 2022.07.26 加入

还未添加个人简介

评论

发布
暂无评论
AOP切入点表达式及五种通知类型解析_王小凡_InfoQ写作社区