Spring AOP AspectJ切入点语法详解,execution,within,this_

2024年3月20日发(作者：武松打虎缩写)

6.5.1 Spring AOP支持的AspectJ切入点指示符

切入点指示符用来指示切入点表达式目的，，在Spring AOP中目前只有

执行方法这一个连接点，Spring AOP支持的AspectJ切入点指示符如下：

execution

用于匹配方法执行的连接点；

within

this

用于匹配指定类型内的方法执行；

用于匹配当前

AOP

代理对象类型的执行方法；

注意是

AOP

代理对象的类型匹配，这样就可能

包括引入接口也类型匹配；

用于匹配当前目标对象类型的执行方法；注意是

target

目标对象的类型匹配，这样就不包括引入接口也

类型匹配；

args

@within

@target

@args

@annotat

ion

bean

reference

pointcut

用于匹配当前执行的方法传入的参数为指定类

型的执行方法；

用于匹配所以持有指定注解类型内的方法；

用于匹配当前目标对象类型的执行方法，其中目

标对象持有指定的注解；

用于匹配当前执行的方法传入的参数持有指定

注解的执行；

用于匹配当前执行方法持有指定注解的方法；

Spring AOP

扩展的，

AspectJ

没有对于指示

符，用于匹配特定名称的

Bean

对象的执行方

法；

表示引用其他命名切入点，只有

@ApectJ

风格

支持，

Schema

风格不支持。

AspectJ切入点支持的切入点指示符还有： call、get、t、preinitializatio

n、staticinitialization、initialization、handler、adviceexecution、withi

ncode、cflow、cflowbelow、if、@this、@withincode；但Spring AOP

目前不支持这些指示符，使用这些指示符将抛出IllegalArgumentException

异常。这些指示符Spring AOP可能会在以后进行扩展。

6.5.1 命名及匿名切入点

命名切入点可以被其他切入点引用，而匿名切入点是不可以的。

只有@AspectJ支持命名切入点，而Schema风格不支持命名切入点。

如下所示，@AspectJ使用如下方式引用命名切入点：

6.5.2 ；类型匹配语法

首先让我们来了解下AspectJ类型匹配的通配符：

*：匹配任何数量字符；

..：匹配任何数量字符的重复，如在类型模式中匹配任何数量子包；而

在方法参数模式中匹配任何数量参数。

+：

匹配指定类型的子类型；仅能作为后缀放在类型模式后边。

1. 匹配String类型；

2. java.*.String 匹配java包下的任何“一级子包”下的String类型；

3. 如匹配，但不匹配

4. java..* 匹配java包及任何子包下的任何类型;

5. 如匹配、tion

6. .*ing 匹配任何包下的以ing结尾的类型；

7. + 匹配包下的任何Number的自类型；

8. 如匹配r，也匹配eger

接下来再看一下具体的匹配表达式类型吧：

匹配类型：

使用如下方式匹配

1. 注解？ 类的全限定名字





注解：可选，类型上持有的注解，如@Deprecated；

类的全限定名：必填，可以是任何类全限定名。

匹配方法执行：

使用如下方式匹配：

1. 注解？ 修饰符? 返回值类型 类型声明?方法名(参数列表) 异常列表？













注解：可选，方法上持有的注解，如@Deprecated；

修饰符：可选，如public、protected；

返回值类型：必填，可以是任何类型模式；“*”表示所有类型；

类型声明：可选，可以是任何类型模式；

方法名：必填，可以使用“*”进行模式匹配；

参数列表：“()”表示方法没有任何参数；“(..)”表示匹配接受任意个参数的方法，“(..,)”

表示匹配接受类型的参数结束，且其前边可以接受有任意个参数的方法；“(.

String,..)” 表示匹配接受类型的参数开始，且其后边可以接受任意个参数的方法；“(*,

)” 表示匹配接受类型的参数结束，且其前边接受有一个任意类型参

数的方法；



异常列表：可选，以“throws 异常全限定名列表”声明，异常全限定名列表如有多个以“，”分割，如thro

ws lArgumentException, ndexOutOfBoundsException。

匹配Bean名称：

可以使用Bean的id或name进行匹配，并且可使用通

配符“*”；

6.5.3 组合切入点表达式

AspectJ使用 且（&&）、或（||）、非（！）来组合切入点表达式。

在Schema风格下，由于在XML中使用“&&”需要使用转义字符“&

&”来代替之，所以很不方便，因此Spring ASP 提供了and、or、not

来代替&&、||、！。

6.5.3 切入点使用示例

一、execution：

使用“execution(方法表达式)”匹配方法执行；

模式

public * *(..)

* ..IPointcutService.*()

任何公共方法的执行

描述

包及所有子包下IPointcutService接口中

的任何无参方法

* ..*.*(..)

* ..IPointcutService.*(*)

包及所有子包下任何类的任何方法

包及所有子包下IPointcutService接口的

任何只有一个参数方法

*

(!..IPointcutService+).*(..)

* ..IPointcutService+.*()

非“包及所有子包下IPointcutService接口

及子类型”的任何方法

包及所有子包下IPointcutService接口及

子类型的的任何无参方法

*

..IPointcut*.test*(.

Date)

包及所有子包下IPointcut前缀类型的的以

test开头的只有一个参数类型为的方

法，注意该匹配是根据方法签名的参数类型进行匹配的，

而不是根据执行时传入的参数类型决定的

如定义方法：public void test(Object obj);即使执行

时传入，也不会匹配的；

*

..IPointcut*.test*(..) thro

ws

IllegalArgumentException,

ArrayIndexOutOfBoundsException

* (..IPointcutService+

&& izable+).*(..)

包及所有子包下IPointcut前缀类型的的任

何方法，且抛出IllegalArgumentException和

ArrayIndexOutOfBoundsException异常

任何实现了包及所有子包下

IPointcutService接口和izable接口的

类型的任何方法

@ated * *(..)

@ated

@..Secure * *(..)

@(ated ||

..Secure) * *(..)

(@..Secure *) *(..)

* (@..Secure *).*(..)

* *(@..Secure (*) ,

@..Secure (*))

任何持有@ated注解的方法

任何持有@ated和

@..Secure注解的方法

任何持有@ated或@

..Secure注解的方法

任何返回值类型持有@..Secure的方法

任何定义方法的类型持有@..Secure的方法

任何签名带有两个参数的方法，且这个两个参数都被@

Secure标记了，

如public void test(@Secure String str1,

@Secure String str1);

* *((@ ..Secure *))或

* *(@ ..Secure *)

任何带有一个参数的方法，且该参数类型持有@

..Secure；

如public void test(Model model);且Model类上持

有@Secure注解

* *(

@..Secure

(@..Secure *) ,

@ ..Secure

(@..Secure *))

* *(

<..Model,

..Model>

, ..)

任何带有两个参数的方法，且这两个参数都被@

..Secure标记了；且这两个参数的类型上都

持有@ ..Secure；

任何带有一个参数的方法，且该参数类

型是以< ..Model, ..Model >为

泛型参数；注意只匹配第一个参数为,不

包括子类型；

如public void test(HashMap

map, String str);将不匹配，必须使用“* *(

p<..Model,..

Model>

, ..)”进行匹配；

而public void test(Map map, int i);也将不匹配，因

为泛型参数不匹配

*

*(tion<@..S

ecure *>)

任何带有一个参数（类型为tion）的方

法，且该参数类型是有一个泛型参数，该泛型参数类型

上持有@..Secure注解；

如public void test(Collection

collection);Model类型上持有@..Secure

* *(<? extends

HashMap>)

任何带有一个参数的方法，且传入的参数类型是有一个

泛型参数，该泛型参数类型继承与HashMap；

Spring AOP目前测试不能正常工作

* *(<? super

HashMap>)

任何带有一个参数的方法，且传入的参数类型是有一个

泛型参数，该泛型参数类型是HashMap的基类型；如

public voi test(Map map)；

Spring AOP目前测试不能正常工作

* *(*<@..Secure *>)

任何带有一个参数的方法，且该参数类型是有一个泛型

参数，该泛型参数类型上持有@..Secure注

解；

Spring AOP目前测试不能正常工作

二

、

within：使用“within(类型表达式)”

匹配指定类型内的方法执行；

模式

within(..*)

包及子包下的任何方法执行

描述

within(..IPointcutService+)

包或所有子包下IPointcutService类型及子类型的任何方法

within(@..Secure *)

持有..Secure注解的任何类型的任何方法

必须是在目标对象上声明这个注解，在接口上声明的对它不起作用

三

、

this

：使用

“this(

类型全限定名

)”

匹配当前

AOP

代理对象类型的执行方法；注意

是

AOP

代理对象的类型匹配，这样就可能包括引入接口方法也可以匹配；注意

this

中

使用的表达式必须是类型全限定名，不支持通配符；

模式

this(cutService)

描述

当前AOP对象实现了

IPointcutService接口

的任何方法

this(ductionService)

当前AOP对象实现了

IIntroductionService

接口的任何方法

也可能是引入接口

四、

target

：使用

“target(

类型全限定名

)”

匹配当前目标对象类型的执行方法；注意

是目标对象的类型匹配，这样就不包括引入接口也类型匹配；注意

target

中使用的表

达式必须是类型全限定名，不支持通配符；

模式

target(cutService)

描述

当前目标对象（非AOP

对象）实现了

IPointcutService接

口的任何方法

target(ductionServic

e)

当前目标对象（非AOP

对象） 实现了

IIntroductionServic

e 接口的任何方法

不可能是引入接口

五、

args

：使用

“args(

参数类型列表

)”

匹配当前执行的方法传入的参数为指定类型的

执行方法；注意是匹配传入的参数类型，不是匹配方法签名的参数类型；参数类型列表

中的参数必须是类型全限定名，通配符不支持；

args

属于动态切入点，这种切入点开

销非常大，非特殊情况最好不要使用；

模式

args (izable,..)

描述

任何一个以接受“传入参数类型为 izable” 开

头，且其后可跟任意个任意类型的参数的方法执行，args指

定的参数类型是在运行时动态匹配的

六、

@within

：使用

“@within(

注解类型

)”

匹配所以持有指定注解类型内的方法；注

解类型也必须是全限定类型名；

模式

@within

描述

任何目标对象对应的类型持有Secure注解的类方法；

起作用

在接口上声明的对它不

)

必须是在目标对象上声明这个注解，

七、

@target

：使用

“@target(

注解类型

)”

匹配当前目标对象类型的执行方法，其中

目标对象持有指定的注解；注解类型也必须是全限定类型名；

模式

@target

描述

任何目标对象持有Secure注解的类方法；

不起作用

()

必须是在目标对象上声明这个注解，在接口上声明的对它

八、

@args

：使用

“@args(

注解列表

)”

匹配当前执行的方法传入的参数持有指

定注解的执行；注解类型也必须是全限定类型名；

模式

@args

描述

任何一个只接受一个参数的方法，且方法运行时传入的参

切入点，类似于arg指示符；

()

数持有注解 ；动态

九、

@annotation

：使用

“@annotation(

注解类型

)”

匹配当前执行方法持有

指定注解的方法；注解类型也必须是全限定类型名；

模式 描述

@annotation( )

当前执行方法上持有注解

将被匹配

十、

bean

：使用

“bean(Bean id

或名字通配符

)”

匹配特定名称的

Bean

对象

的执行方法；

Spring ASP

扩展的，在

AspectJ

中无相应概念；

模式

bean(*Service)

描述

匹配所有以Service命名（id或name）结尾的Bean

十一、reference pointcut：

表示引用其他命名切入点，

只有@ApectJ风格支持，Schema风格不支持，

如下所示：

比如我们定义如下切面：

1. package ;

2. import ;

3. import ut;

4. @Aspect

5. public class ReferencePointcutAspect {

6. @Pointcut(value="execution(* *())")

7. public void pointcut() {}

8. }

可以通过如下方式引用：

1. @Before(value = "

cut()")

2. public void referencePointcutTest2(JoinPoint jp) {}

除了可以在@AspectJ风格的切面内引用外，也可以在Schema风格的

切面定义内引用，引用方式与@AspectJ完全一样。

到此我们切入点表达式语法示例就介绍完了，我们这些示例几乎包含了日

常开发中的所有情况，但当然还有更复杂的语法等等，如果以上介绍的不能满足

您的需要，请参考AspectJ文档。

由于测试代码相当长，所以为了节约篇幅本示例代码在

r6. PointcutTest文件中，需要时请参考该文件。

6.6 通知参数

前边章节已经介绍了声明通知，但如果想获取被被通知方法参数并传递给

通知方法，该如何实现呢？接下来我们将介绍两种获取通知参数的方式。



使用JoinPoint获取：Spring AOP提供使用int类型获取连接点数据，任何

通知方法的第一个参数都可以是JoinPoint(环绕通知是ProceedingJoinPoint，JoinPoint子类)，当然第

一个参数位置也可以是Part类型，这个只返回连接点的静态部分。

1) JoinPoint：

提供访问当前被通知方法的目标对象、代理对象、方法参数等数据：

1. package ;

2. import Location;

3. public interface JoinPoint {

4. String toString(); //连接点所在位置的相关信息

5. String toShortString(); //连接点所在位置的简短相关信息

6. String toLongString(); //连接点所在位置的全部相关信息

7. Object getThis(); //返回AOP代理对象

8. Object getTarget(); //返回目标对象

9. Object[] getArgs(); //返回被通知方法参数列表

10. Signature getSignature(); //返回当前连接点签名

11. SourceLocation getSourceLocation();//返回连接点方法所在类文件中的位置

12. String getKind(); //连接点类型

13. StaticPart getStaticPart(); //返回连接点静态部分

14. }

2）

ProceedingJoinPoint：用于环绕通知，使用proceed()方法来执行目标方

法：

1. public interface ProceedingJoinPoint extends JoinPoint {

2. public Object proceed() throws Throwable;

3. public Object proceed(Object[] args) throws Throwable;

4. }

3) Part：

提供访问连接点的静态部分，如被通知方法签

名、连接点类型等：

1. public interface StaticPart {

2. Signature getSignature(); //返回当前连接点签名

3. String getKind(); //连接点类型

4. int getId(); //唯一标识

5. String toString(); //连接点所在位置的相关信息

6. String toShortString(); //连接点所在位置的简短相关信息

7. String toLongString(); //连接点所在位置的全部相关信息

8. }

使用如下方式在通知方法上声明，必须是在第一个参数，然后使用s

()就能获取到被通知方法参数：

1. @Before(value="execution(* sayBefore(*))")

2. public void before(JoinPoint jp) {}

3.

4. @Before(value="execution(* sayBefore(*))")

5. public void before(Part jp) {}



自动获取：通过切入点表达式可以将相应的参数自动传递给通知方法，例如前边章节讲过的

返回值和异常是如何传递给通知方法的。

在Spring AOP中，除了execution和bean指示符不能传递参数给通知方法，

其他指示符都可以将匹配的相应参数或对象自动传递给通知方法。

1. @Before(value="execution(* test(*)) && args(param)", argNames="param")

2. public void before1(String param) {

3. n("===param:" + param);

4. }

切入点表达式execution(* test(*)) && args(param) ：

1）首先execution(* test(*))匹配任何方法名为test，且有一个任何类型的

参数；

2）args(param)将首先查找通知方法上同名的参数，并在方法执行时（运行时）

匹配传入的参数是使用该同名参数类型，即；如果匹配将把

该被通知参数传递给通知方法上同名参数。

其他指示符（除了execution和bean指示符）都可以使用这种方式进行参数

绑定。

在此有一个问题，即前边提到的类似于【3.1.2构造器注入】中的参数名注入限

制：

在class文件中没生成变量调试信息是获取不到方法参数名字的。

所以我们可以使用策略来确定参数名：

1. 如果我们通过“argNames”属性指定了参数名，那么就是要我们指定的；

查看复制到剪贴板打印

1. @Before(value=" args(param)", argNames="param") //明确指定了

2. public void before1(String param) {

3. n("===param:" + param);

4. }

1. 如果第一个参数类型是JoinPoint、ProceedingJoinPoint或Part类型，应该从“argN

ames”属性省略掉该参数名（可选，写上也对），这些类型对象会自动传入的，但必须作为第一个参数；

查看复制到剪贴板打印

1. @Before(value=" args(param)", argNames="param") //明确指定了

2. public void before1(JoinPoint jp, String param) {

3. n("===param:" + param);

4. }

1. 如果“class文件中含有变量调试信息”将使用这些方法签名中的参数名来确定参数名；

查看复制到剪贴板打印

1. @Before(value=" args(param)") //不需要argNames了

2. public void before1(JoinPoint jp, String param) {

3. n("===param:" + param);

4. }

1. 如果没有“class文件中含有变量调试信息”，将尝试自己的参数匹配算法，如果发现参数绑定有二义性将

抛出AmbiguousBindingException异常；对于只有一个绑定变量的切入点表达式，而通知方法只接受

一个参数，说明绑定参数是明确的，从而能配对成功。

查看复制到剪贴板打印

1. @Before(value=" args(param)")

2. public void before1(JoinPoint jp, String param) {

3. n("===param:" + param);

4. }

1. 以上策略失败将抛出IllegalArgumentException。

接下来让我们示例一下组合情况吧：

查看复制到剪贴板打印

1. @Before(args(param) && target(bean) && @annotation(cure)",

2. argNames="jp,param,bean,cure")

3. public void before5(JoinPoint jp, String param,

4. IPointcutService pointcutService, Secure cure) {

5. ……

6. }

该示例的执行步骤如图6-5所示。

图6-5 参数自动获取流程

除了上边介绍的普通方式，也可以对使用命名切入点自动获取参数：

查看复制到剪贴板打印

1. @Pointcut(value="args(param)", argNames="param")

2. private void pointcut1(String param){}

3. @Pointcut(value="@annotation(cure)", argNames="cure")

4. private void pointcut2(Secure cure){}

5.

6. @Before(value = "pointcut1(param) && pointcut2(cure)",

7. argNames="param, cure")

8. public void before6(JoinPoint jp, String param, Secure cure) {

9. ……

10. }

自此给通知传递参数已经介绍完了，示例代码在

terTest文件中。

在Spring配置文件中，所以AOP相关定义必须放在标签

下，该标签下可以有、、标

签，配置顺序不可变。







：用来定义切入点，该切入点可以重用；

：用来定义只有一个通知和一个切入点的切面；

：用来定义切面，该切面可以包含多个切入点和通知，而且标签内部的通知和切入点定义

是无序的；和advisor的区别就在此，advisor只包含一个通知和一个切入点。