Spring中pointcut切入点表达式

北极无雪

已于 2024-05-12 09:35:31 修改

阅读量1k

点赞数 11

文章标签： spring 数据库 java

于 2024-05-12 08:36:11 首次发布

本文链接：https://blog.csdn.net/small_kai/article/details/138742375

版权

前言

标准的AspectJ Aop的pointcut的表达式类型是很丰富的，但是Spring Aop只支持其中的10种，外加Spring Aop自己扩充的一种一共是11(10+1)种类型的表达式，分别如下。

execution：一般用于指定方法的执行，用的最多。
within：指定某些类型的全部方法执行，也可用来指定一个包。
this：Spring Aop是基于动态代理的，生成的bean也是一个代理对象，this就是这个代理对象，当这个对象可以转换为指定的类型时，对应的切入点就是它了，Spring Aop将生效。
target：当被代理的对象可以转换为指定的类型时，对应的切入点就是它了，Spring Aop将生效。
args：当执行的方法的参数是指定类型时生效。
@target：当代理的目标对象上拥有指定的注解时生效。
@args：当执行的方法参数类型上拥有指定的注解时生效。
@within：与@target类似，看官方文档和网上的说法都是@within只需要目标对象的类或者父类上有指定的注解，则@within会生效，而@target则是必须是目标对象的类上有指定的注解。而根据笔者的测试这两者都是只要目标类或父类上有指定的注解即可。
@annotation：当执行的方法上拥有指定的注解时生效。
reference pointcut：(经常使用)表示引用其他命名切入点，只有@ApectJ风格支持，Schema风格不支持
bean：当调用的方法是指定的bean的方法时生效。(Spring AOP自己扩展支持的)

execution

参数解析：

修饰符匹配（modifier-pattern?）
返回值匹配（ret-type-pattern）可以为*表示任何返回值,全路径的类名等
类路径匹配（declaring-type-pattern?）
方法名匹配（name-pattern）可以指定方法名或者 代表所有, set 代表以set开头的所有方法
参数匹配（(param-pattern)）可以指定具体的参数类型，多个参数间用“,”隔开，各个参数也可以用“”来表示匹配任意类型的参数，如(String)表示匹配一个String参数的方法；(,String) 表示匹配有两个参数的方法，第一个参数可以是任意类型，而第二个参数是String类型；可以用(…)表示零个或多个任意参数
异常类型匹配（throws-pattern?）
其中后面跟着“?”的是可选项

例如：

//表示匹配所有方法  
1）execution(* *(..))  
//表示匹配com.fsx.run.UserService中所有的公有方法  
2）execution(public * com.fsx.run.UserService.*(..))  
//表示匹配com.fsx.run包及其子包下的所有方法
3）execution(* com.fsx.run..*.*(..))

Pointcut定义时，还可以使用&&、||、! 这三个运算。进行逻辑运算

// 签名：消息发送切面
@Pointcut("execution(* com.fsx.run.MessageSender.*(..))")
private void logSender(){}
// 签名：消息接收切面
@Pointcut("execution(* com.fsx.run.MessageReceiver.*(..))")
private void logReceiver(){}
// 只有满足发送  或者  接收  这个切面都会切进去
@Pointcut("logSender() || logReceiver()")
private void logMessage(){}

这个例子中，logMessage()将匹配任何MessageSender和MessageReceiver中的任何方法。

当我们的切入点很多的时候，我们可以把所有的切入点放到单独的一个类去，进行统一管理，比如下面：

//集中管理所有的切入点表达式
public class Pointcuts {

	@Pointcut("execution(* *Message(..))")
	public void logMessage(){}

	@Pointcut("execution(* *Attachment(..))")
	public void logAttachment(){}

	@Pointcut("execution(* *Service.*(..))")
	public void auth(){}
}

这样别的切面使用时，采用全类名+方法名的方式

@Before("com.fsx.run.Pointcuts.logMessage()")
public void before(JoinPoint joinPoint) {
    System.out.println("Logging before " +          joinPoint.getSignature().getName());
}

within

within是用来指定类型的，指定类型中的所有方法将被拦截。

// AService下面所有外部调用方法，都会拦截。备注：只能是AService的方法，子类不会拦截的
@Pointcut("within(com.fsx.run.service.AService)")
public void pointCut() {
}

匹配包以及子包内的所有类：

@Pointcut("within(com.fsx.run.service..*)")
public void pointCut() {
}

this

Spring Aop是基于代理的，this就表示代理对象。this类型的Pointcut表达式的语法是this(type)，当生成的代理对象可以转换为type指定的类型时则表示匹配。基于JDK接口的代理和基于CGLIB的代理生成的代理对象是不一样的。（注意和上面within的区别）

// 这样子，就可以拦截到AService所有的子类的所有外部调用方法
@Pointcut("this(com.fsx.run.service.AService*)")
public void pointCut() {
}

target

Spring Aop是基于代理的，target则表示被代理的目标对象。当被代理的目标对象可以被转换为指定的类型时则表示匹配。注意：和上面不一样，这里是target，因此如果要切入，只能写实现类了

 @Pointcut("target(com.fsx.run.service.impl.AServiceImpl)")
public void pointCut() {
}

args

args用来匹配方法参数的。

“args()”匹配任何不带参数的方法。
“args(java.lang.String)”匹配任何只带一个参数，而且这个参数的类型是String的方法。
“args(…)”带任意参数的方法。
“args(java.lang.String,…)”匹配带任意个参数，但是第一个参数的类型是String的方法。
“args(…,java.lang.String)”匹配带任意个参数，但是最后一个参数的类型是String的方法。

@Pointcut("args()")
public void pointCut() {
}

PS : 这个匹配的范围非常广，所以一般和别的表达式结合起来使用

@targe

@target匹配当被代理的目标对象对应的类型及其父类型上拥有指定的注解时。

 //能够切入类上（非方法上）标准了MyAnno注解的所有外部调用方法
@Pointcut("@target(com.fsx.run.anno.MyAnno)")
public void pointCut() {
}

@args

@args匹配被调用的方法上含有参数，且对应的参数类型上拥有指定的注解的情况。例如：

// 匹配**方法参数类型上**拥有MyAnno注解的方法调用。//如我们有一个方法add(MyParam param)接收一个MyParam类型的参数，而MyParam这个类是拥有注解MyAnno的，则它可以被Pointcut表达式匹配上
@Pointcut("@args(com.fsx.run.anno.MyAnno)")
    public void pointCut() {
}

@within

@within用于匹配被代理的目标对象对应的类型或其父类型拥有指定的注解的情况，但只有在调用拥有指定注解的类上的方法时才匹配。

@within(com.fsx.run.anno.MyAnno)匹配被调用的方法声明的类上拥有MyAnno注解的情况。比如有一个ClassA上使用了注解MyAnno标注，并且定义了一个方法a()，那么在调用ClassA.a()方法时将匹配该Pointcut；如果有一个ClassB上没有MyAnno注解，但是它继承自ClassA，同时它上面定义了一个方法b()，那么在调用ClassB().b()方法时不会匹配该Pointcut，但是在调用ClassB().a()时将匹配该方法调用，因为a()是定义在父类型ClassA上的，且ClassA上使用了MyAnno注解。但是如果子类ClassB覆写了父类ClassA的a()方法，则调用ClassB.a()方法时也不匹配该Pointcut。

@annotation

@annotation用于匹配方法上拥有指定注解的情况。

  // 可以匹配所有方法上标有此注解的方法
@Pointcut("@annotation(com.fsx.run.anno.MyAnno)")
public void pointCut() {
}

我们还可以这么写，非常方便的获取到方法上面的注解

  @Before("@annotation(myAnno)")
    public void doBefore(JoinPoint joinPoint, MyAnno myAnno) {
        System.out.println(myAnno); //@com.fsx.run.anno.MyAnno()
        System.out.println("AOP Before Advice...");
    }

reference pointcut

切入点引用（使用得非常多）

@Aspect
public class HelloAspect {
    @Pointcut("execution(* com.fsx.service.*.*(..)) ")
    public void point() {
    }
    // 这个就是一个`reference pointcut`  甚至还可以这样 @Before("point1() && point2()")
    @Before("point()")  
    public void before() {
        System.out.println("this is from HelloAspect#before...");
    }
}

bean

bean用于匹配当调用的是指定的Spring的某个bean的方法时。

“bean(abc)”匹配Spring Bean容器中id或name为abc的bean的方法调用。
“bean(user*)”匹配所有id或name为以user开头的bean的方法调用。

// 这个就能切入到AServiceImpl类的所有的外部调用的方法里
@Pointcut("bean(AServiceImpl)")
public void pointCut() {
}

应用细节

类型匹配语法

' * '：匹配任何数量字符。
' .. '：匹配任何数量字符的重复，如在类型模式中匹配任何数量子包；而在方法参数模式中匹配任何数量参数。
' + '：匹配指定类型的子类型；仅能作为后缀放在类型模式后边。

java.lang.String    匹配String类型； 
java.*.String       匹配java包下的任何“一级子包”下的String类型； 如匹配java.lang.String，但不匹配java.lang.ss.String 
java..*            匹配java包及任何子包下的任何类型。如匹配java.lang.String、java.lang.annotation.Annotation 
java.lang.*ing      匹配任何java.lang包下的以ing结尾的类型；
java.lang.Number+  匹配java.lang包下的任何Number的子类型； 如匹配java.lang.Integer，也匹配java.math.BigInteger

表达式的组合

表达式的组合其实就是对应的表达式的逻辑运算，与、或、非。可以通过它们把多个表达式组合在一起。

“bean(userService) && args()”匹配id或name为userService的bean的所有无参方法。
“bean(userService) || @annotation(MyAnnotation)”匹配id或name为userService的bean的方法调用，或者是方法上使用了MyAnnotation注解的方法调用。
“bean(userService) && !args()”匹配id或name为userService的bean的所有有参方法调用。

复用切入点表达式

所谓的复用其实就是 “一次定义，反复使用” ，这里其实就是上面的reference pointcut

操作步骤：

定义一个方法，用于声明切入点表达式
在方法上使用 @Pointcut来声明切入点表达式
使用方法名来引用当前的切入点表达式
- 本类中调用（直接调用方法名）：@Before("xxx()")
- 跨类调用（加类名）：@Before("xxx.xxx()")
- 跨包调用（加全类名）：@Before("com.xxx.xxx.xxx()")