说说 Spring 支持的 AspectJ 语法

本文以 AspectJ5.0 为基础。

1 切点表达式

AspectJ5.0 的切点表达式由关键字和操作参数组成。比如 execution(* rent(..)) 中,execution 为关键字,而 * rent(..) 为操作参数。

Spring 支持 9 个 AspectJ 切点表达式关键字,它们用不同的方式描述目标类的连接点 。根据描述对象的不同,可以分为 4 类。

关键字类别 说明
方法切点 通过目标类的方法信息来定义连接点。
方法入参切点 通过目标类的方法入参信息来定义连接点。
目标类切点 通过目标类的类型信息来定义连接点。
代理类切点 通过目标类的代理类信息来定义连接点。

切点表达式关键字说明如下:

关键字 类别 操作参数 说明
execution() 方法切点 方法匹配模式字符串 表示满足某一匹配模式的所有目标类方法。比如 execution(* rent(..)) 表示目标类中的所有 rent() 方法。
@annotation() 方法切点 注解类 表示标注了某特定注解的目标类方法。比如 @annotation(net.deniro.spring4.anno.Log) 表示任何标注了 @Log 注解的目标类方法 。
args() 方法入参切点 类名 表示具有入参对象类型的方法。比如 args(net.deniro.spring4.aspectj.User) 表示有且仅有一个 User 类型入参的所有方法 。
@args() 方法入参切点 注解类 表示标注了某个特定注解入参类型的方法。比如 @args(net.deniro.spring4.anno.Log) 表示这样的方法,它具有一个入参对象,且入参对象的类标注了 @Log 注解。
within() 目标类切点 类名匹配字符串 表示特定包路径下的所有类中的所有方法。比如 net.deniro.service.* 表示 net.deniro.service 包下所有类中的所有方法。
target() 目标类切点 类名或接口名 表示指定的类(包括子类)或接口(包括实现类)中的所有方法。
@within() 目标类切点 注解类 假如目标类 A 按类型匹配于某个类 B ,且类 B 标注了指定的注解,那么这里就表示这个目标类及其子类的所有方法 。 比如 @within(net.deniro.spring4.anno.Log) 定义的切点,且 User 类标注了 @Log 注解,那么 Waiter 及 Waiter 的实现类 NaiveWaiter 的说哟连接点都匹配这个切点。
@target() 目标类切点 注解类 表示标注了某个指定注解的目标类(包括继承或实现关系的类)中的所有方法。比如:@target(net.deniro.spring4.anno.Log),假设 User 标注了 @Log,那么这个表示式表示 User 类及其子类中的所有方法。
this() 代理类切点 类名 表示的是这样一个类,它的代理类匹配了指定的类。

2 在操作参数中使用通配符

AspectJ 支持三种通配符:

通配符 说明
* 匹配任意字符,但它只能匹配上下文中的一个元素。
.. 匹配任意字符,可以匹配上下文中的多个元素。在表示操作参数时可以单独使用,但在标识类时,必须和 * 联合使用。
+ 表示按类型匹配指定类(包括继承的子类或实现类)。

切点表达式关键字对于通配符的支持情况:

关键字 * .. +
execution() 支持 支持 支持
@annotation() 不支持 不支持 不支持
args() 不支持 不支持 支持
@args() 不支持 不支持 不支持
within() 不支持 不支持 不支持
target() 不支持 不支持 支持
@within() 支持 支持 支持
@target() 不支持 不支持 不支持
this() 不支持 不支持 支持
  • args()、this() 与 target() 虽然本身支持 +,但加还是不加,它们的效果都是一样的。
  • @annotation() 、args()、@args()、target()、@within()、@target()和 this() 这 7 个函数除了可以指定类名外,还可以指定变量名,并将目标对象中的变量绑定到增强的方法中。

3 逻辑运算符

切点表达式由切点关键字组成,切点关键字之间可以进行逻辑运算,组合成为复合切点。

逻辑运算符 说明 示例
&& 与运算符,执行交集运算。Spring 提供了一个等效的运算符 and within(net.deniro..*) and args(String) 表示在 net.deniro 包下所有类中(当前包以及子孙包)拥有一个String入参的方法。
|| 或运算符,执行并集运算,等效的运算符是 or within(net.deniro..*) or args(String)表示在 net.deniro 包下的所有类的方法,或者是所有拥有一个String入参的方法。
! 或运算符,执行并集运算,等效的运算符是 not !within(net.deniro.*) 表示所有不在 net.deniro 包下的方法 。

注意: andornot只是 Spring 提供的等效运算符。虽然 Spring 允许在使用这些运算符时,不在前面添加空格,但了程序的可读性,建议还是在这些操作符的前后加上空格哦O(∩_∩)O哈哈~

4 增强类型

AspectJ 提供了 6 种增强类型的注解类,它们都在 org.aspectj.lang.annotation.*包中。它们的存留期限都是 RetentionPolicy.RUNTIME ,标注目标都是 ElementType.METHOD

4.1 @Before

前置增强,相当于 BeforeAdvice。

成员变量 说明
value 定义切点。
argNames 因为无法通过 Java 反射获取方法的入参名,所有如果需要在运行期解析切点,那么就必须通过这个成员变量来指定注解所标注增强方法的参数名,多个以逗号分隔 。

4.2 @AfterReturning

后置增强,相当于 AfterReturningAdvice。

成员变量 说明
value 定义切点。
pointcut 定义切点,如果显式指定该值,它将覆盖 value 的值,可以将 pointcut 看成是 value 的同义词。
returning 将目标对象方法的返回值传递给增强的方法。
argNames 与 @Before 的 argNames 相同。

4.3 @Around

环绕增强,相当于 MethodInterceptor 。

成员变量 说明
value 定义切点。
argNames 与 @Before 的 argNames 相同。

4.4 @AfterThrowing

抛出增强,相当于ThrowsAdvice。

成员变量 说明
value 定义切点。
pointcut 定义切点,如果显式指定该值,它将覆盖 value 的值,可以将 pointcut 看成是 value 的同义词。
throwing 将抛出的异常传递到增强的方法中。
argNames 与 @Before 的 argNames 相同。

4.5 @After

Final 增强,不管是抛出异常或者是正常退出,该增强都会得到执行,相当于 try{} finally{} 的控制流。该增强没有对应的增强接口,可以把它看成是 ThrowsAdviceAfterReturningAdvice 的混合物,一般用于释放资源。

成员变量 说明
value 定义切点。
argNames 与 @Before 的 argNames 相同。

4.6 @DeclareParents

引介增强,相当于IntroductionInterceptor。

成员变量 说明
value 定义切点。
defaultImpl 默认的接口实现类。

假设,有以下这些类继承关系,包括厨师接口与作家接口,每个接口都有一个实现类:

Cook 接口:

public interface Cook {

    /**
     * 制作食品
     */
    void make();

}

Cook 实现类:

public class CookA implements Cook {
    public void make() {
        System.out.println("制作食品");
    }
}

Writer 接口:

public interface Writer {

    /**
     * 写作
     */
    void write();
}

Writer 实现类:

public class WriterA implements Writer {
    public void write() {
        System.out.println("写作");
    }
}

我们希望通过引介增强,能够让 CookA 具有写作的能力!O(∩_∩)O哈哈~

切面类:

@Aspect
public class EnableWriteAspect {

    @DeclareParents(value = "net.deniro.spring4.aspectj.CookA", defaultImpl = WriterA.class)
    public Writer writer;

}

配置文件:




    
    

    
    


单元测试:

Cook cook = (Cook) context.getBean("cook");
cook.make();
Writer writer = (Writer) cook;//强制转换
writer.write();

输出结果:

制作食品
写作

引介增强是不是很强大呀O(∩_∩)O哈哈~

你可能感兴趣的:(说说 Spring 支持的 AspectJ 语法)