Spring源码阅读MethodInterceptor解析

时间:2022-11-03 Pseudocode 人气:0

概述

上一篇详细分析了 ReflectiveMethodInvocation 中的proceed方法的逻辑，它通过递归的方式，完成拦截器链中增强逻辑的逐层执行。当方法中每次根据索引获取到的当前拦截器需要执行增强逻辑的时候，由于proceed方法并没有直接在方法体内调用自身，而是调用了拦截器的invoke方法，之后拦截器的invoke方法又调用了proceed方法，因此，每一次递归都是通过proceed方法和拦截器的invoke方法共同完成的。

所以，这一篇来分析拦截器的invoke方法，针对 5 种增强类型，拦截器的具体类型也有 5 种，它们的invoke方法实现各不相同，本文会逐个分析。

MethodInterceptor 分析

首先，这 5 种拦截器都是 MethodInterceptor 接口的实现，而invoke方法正是在 MethodInterceptor 接口中定义的。

@FunctionalInterface
public interface MethodInterceptor extends Interceptor {
Object invoke(MethodInvocation invocation) throws Throwable;
}

在invoke方法被调用的时候，传入的invocation参数就是之前创建的 ReflectiveMethodInvocation 对象，在invoke方法的具体实现中，正是通过它调用proceed方法完成了递归。

在之前的文章中，分析过 JdkDynamicAopProxy 的invoke方法获取拦截器链的步骤，也从中了解了 5 中增强类型的拦截器的具体类型，它们分别是：

实现了 MethodInterceptor 接口的三个 Advice 实现类 AspectJAroundAdvice / AspectJAfterThrowingAdvice / AspectJAfterAdvice
两个通过适配器封装了 Advice 对象的拦截器类型 MethodBeforeAdviceInterceptor / AfterReturningAdviceInterceptor。

下面进入分析的环节，分析的主要内容是他们的invoke方法。

AspectJAroundAdvice 分析

// org.springframework.aop.aspectj.AspectJAroundAdvice#invoke
@Override
public Object invoke(MethodInvocation mi) throws Throwable {
   if (!(mi instanceof ProxyMethodInvocation)) {
      throw new IllegalStateException("MethodInvocation is not a Spring ProxyMethodInvocation: " + mi);
   }
   ProxyMethodInvocation pmi = (ProxyMethodInvocation) mi;
   ProceedingJoinPoint pjp = lazyGetProceedingJoinPoint(pmi);
   JoinPointMatch jpm = getJoinPointMatch(pmi);
   return invokeAdviceMethod(pjp, jpm, null, null);
}

方法中，首先会确保参数传入的mi是否是是 ProxyMethodInvocation 的实现类，根据前面的逻辑，我们知道这里传入参数的对象是之前创建的 ReflectiveMethodInvocation 对象，前面创建 ReflectiveMethodInvocation 对象的时候，我们曾经分析过它的类关系，它是 ProxyMethodInvocation 接口的实现类。因此，这个方法中后续的流程会正常执行。

接下来，通过lazyGetProceedingJoinPoint方法得到了一个 ProceedingJoinPoint 对象pjp，我们看一下这个方法中作了什么。

// org.springframework.aop.aspectj.AspectJAroundAdvice#lazyGetProceedingJoinPoint
protected ProceedingJoinPoint lazyGetProceedingJoinPoint(ProxyMethodInvocation rmi) {
   return new MethodInvocationProceedingJoinPoint(rmi);
}

这里的逻辑，就是将invoke方法传入的 MethodInvocation 参数，通过构造方法，封装成了一个 MethodInvocationProceedingJoinPoint 对象，它的构造方法中除了把参数赋值给成员变量，并无更多的逻辑。

public MethodInvocationProceedingJoinPoint(ProxyMethodInvocation methodInvocation) {
   Assert.notNull(methodInvocation, "MethodInvocation must not be null");
   this.methodInvocation = methodInvocation;
}

回到invoke方法中，下一步是通过getJoinPointMatch方法获取到一个 JoinPointMatch 对象，它会在之后绑定增强方法的参数值时用到。

方法的最后，就是执行invokeAdviceMethod方法，从它的名字可以看出，这里就是执行增强方法的逻辑，我们进入这个方法查看。

// org.springframework.aop.aspectj.AbstractAspectJAdvice#invokeAdviceMethod(org.aspectj.lang.JoinPoint, org.aspectj.weaver.tools.JoinPointMatch, java.lang.Object, java.lang.Throwable)
protected Object invokeAdviceMethod(JoinPoint jp, @Nullable JoinPointMatch jpMatch,
      @Nullable Object returnValue, @Nullable Throwable t) throws Throwable {
   return invokeAdviceMethodWithGivenArgs(argBinding(jp, jpMatch, returnValue, t));
}

这个方法的实现在父类 AbstractAspectJAdvice 中，方法只有一句，就是执行invokeAdviceMethodWithGivenArgs方法并返回结果，在方法的参数中，argBinding用于根据增强方法的参数列表，来绑定执行增强方法的参数值。我们进入invokeAdviceMethodWithGivenArgs方法查看。

// org.springframework.aop.aspectj.AbstractAspectJAdvice#invokeAdviceMethodWithGivenArgs
protected Object invokeAdviceMethodWithGivenArgs(Object[] args) throws Throwable {
   Object[] actualArgs = args;
   if (this.aspectJAdviceMethod.getParameterCount() == 0) {
      actualArgs = null;
   }
   try {
      ReflectionUtils.makeAccessible(this.aspectJAdviceMethod);
      // TODO AopUtils.invokeJoinpointUsingReflection
return this.aspectJAdviceMethod.invoke(this.aspectInstanceFactory.getAspectInstance(), actualArgs);
   }
   catch (IllegalArgumentException ex) {
      throw new AopInvocationException("Mismatch on arguments to advice method [" +
            this.aspectJAdviceMethod + "]; pointcut expression [" +
            this.pointcut.getPointcutExpression() + "]", ex);
   }
   catch (InvocationTargetException ex) {
      throw ex.getTargetException();
   }
}

这里的逻辑就比较简单了，就是获取到当前拦截器中的增强方法，并通过反射执行这个方法。

我们都知道，AspectJAroundAdvice 是环绕增强，也就是在目标方法执行的前后都有增强逻辑，那么，目标方法（或者下一层拦截器）是什么时候调用的呢？可以通过一个例子来分析。

以下是一个典型的环绕增强的方法：

@Around("point()")
public void around(ProceedingJoinPoint proceedingJoinPoint) throws Throwable {
    System.out.println("Around Before ...");
    // 被增强的方法
    proceedingJoinPoint.proceed();
    System.out.println("Around After ...");
}

在一个环绕增强的方法中，会通过方法参数中，代表当前连接点的 ProceedingJoinPoint 对象的proceed()来执行目标方法（或者下一层拦截器），其实就是调用了我们上一篇中分析的 ReflectiveMethodInvocation 的proceed方法。而这个方法被调用时，参数中的 ProceedingJoinPoint 的值，是在前面的步骤中，argBinding方法中进行绑定的。

加载全部内容