Spring高手之路21——深入剖析Spring AOP代理对象的创建

创建代理对象核心动作的三个步骤

本文将详细介绍创建代理对象的三个核心步骤。关于AOP的基本调试，可以参考前文介绍的调试代码（任何涉及AOP的代码均可，如前置通知），这里不再详细说明。

1. 判断 Bean 是否需要增强（源码分析时序图说明）

本节源码基于 spring-aop-5.3.16。

在Spring AOP中，这一步骤主要通过检查目标bean是否实现了特定接口或已是代理对象来完成。关键的方法是在AbstractAutoProxyCreator类的postProcessBeforeInstantiation中实现，该方法是 Spring AOP 的核心，属于 Spring Bean 生命周期的一部分，特别是在后置处理器(BeanPostProcessor)机制中起重要作用。

主要功能：

拦截Bean的创建：在实际的 Bean 实例化之前拦截创建过程，这使得开发者可以在对象实际创建之前注入特定的行为或逻辑。
条件判断：基于特定条件（例如Bean的类型或注解）来确定是否需要对该 Bean 应用代理或其他增强，特定条件比如(切点表达式)
创建代理：如果条件满足，这个方法可以用来创建一个代理实例代替原来的 Bean，以便在运行时应用如安全、事务、日志等横切关注点。

作用流程：

1. 获取缓存键：首先通过 Bean 的类和名称构造一个缓存键，用于后续的快速查找和决策。2. 初步检查：检查缓存是否已经有该 Bean 的信息，检查Bean是否为基础设施类或是否标记为不应代理。如果缓存中未找到对应键且Bean需要代理，将进入代理创建步骤。3. 决定是否创建代理：如果 Bean 不在上述类别中，进一步检查是否存在自定义的 TargetSource（一个控制如何获取或创建被代理对象的组件）。如果存在，表示这个 Bean 需要被增强或代理。4. 代理创建：如果需要，创建一个代理实例，这个代理会封装原始 Bean，加入额外的行为如拦截方法调用。5. 结果返回：返回创建的代理实例或者在不需要代理的情况下返回 null。

来看看对应的源码：

源码提出来分析：

代码语言：javascript复制

@Override
public Object postProcessBeforeInstantiation(Class<?> beanClass, String beanName) {
    // 获取beanClass和beanName组合的缓存键
    Object cacheKey = getCacheKey(beanClass, beanName);

    // 检查beanName是否有效，并且当前bean是否已经有一个自定义的TargetSource
    if (!StringUtils.hasLength(beanName) || !this.targetSourcedBeans.contains(beanName)) {
        // 如果当前bean已经被处理过，直接返回null，不再处理
        if (this.advisedBeans.containsKey(cacheKey)) {
            return null;
        }
        // 判断当前类是否是基础设施类或者是否应该跳过代理
        if (isInfrastructureClass(beanClass) || shouldSkip(beanClass, beanName)) {
            // 标记为不需要代理，并返回null
            this.advisedBeans.put(cacheKey, Boolean.FALSE);
            return null;
        }
    }

    // 获取自定义的TargetSource，如果存在，则创建代理
    TargetSource targetSource = getCustomTargetSource(beanClass, beanName);
    if (targetSource != null) {
        // 如果beanName有效，将其加入到管理自定义TargetSource的集合中
        if (StringUtils.hasLength(beanName)) {
            this.targetSourcedBeans.add(beanName);
        }
        // 获取适用于当前bean的advice和advisor
        Object[] specificInterceptors = getAdvicesAndAdvisorsForBean(beanClass, beanName, targetSource);
        // 创建代理对象
        Object proxy = createProxy(beanClass, beanName, specificInterceptors, targetSource);
        // 缓存代理对象的类型
        this.proxyTypes.put(cacheKey, proxy.getClass());
        return proxy;
    }

    return null;
}

源码分析说明：

获取缓存键：通过 beanClass 和 beanName 组合生成缓存键。
检查 beanName 和 TargetSource：确保 beanName 有效且 bean 未被处理过，若已处理则返回 null。
判断基础设施类或跳过代理：检查 bean 是否为基础设施类或应跳过代理，若是则返回 null。
获取自定义 TargetSource 并创建代理：如果存在自定义 TargetSource，则创建代理对象并缓存其类型。

这里为什么要获取自定义的 TargetSource？

在Spring AOP中，创建代理对象时，TargetSource起着关键作用。它主要决定了如何获取或创建将被代理的目标对象。默认情况下，Spring 使用简单的目标源，即直接引用具体的 Bean 实例。但在某些情况下，开发者可能需要通过自定义TargetSource来改变目标对象的获取逻辑，以适应特定的增强需求。

在AbstractAutoProxyCreator类的postProcessBeforeInstantiation方法中，我们可以决定是否使用自定义的TargetSource。如果存在，这意味着Bean需要特殊的处理或增强。自定义的TargetSource还可以实现很多复杂的逻辑，比如：

池化目标对象：为了提高性能，可以使用对象池来管理目标对象的实例。
延迟初始化：只有在真正需要时才创建目标对象，可以减少资源使用和启动时间。
远程对象访问：目标对象可能在远程服务器上，需要通过网络调用。
多租户支持：基于当前用户或会话信息返回不同的目标对象实例。

用时序图表示如下：

总体流程 这个时序图描述了Spring AOP在创建代理对象时的核心过程。主要涉及的组件包括：调用者、postProcessBeforeInstantiation方法、缓存与条件检查、自定义TargetSource管理以及代理创建与返回。

步骤解析1. 调用开始：

调用者调用postProcessBeforeInstantiation方法，开始代理对象的创建过程。
这个方法主要负责在bean实例化之前判断并创建其代理。

2. 获取缓存键和初步条件检查：

方法首先通过beanClass和beanName获取一个cacheKey。
接着检查beanName是否有效（非空且长度大于0）和当前bean是否已经有自定义的TargetSource。
如果bean已经存在于advisedBeans缓存中，或者属于基础设施类（如配置类等），或已指定为跳过代理，则不会进行进一步处理。

3. 尝试获取自定义TargetSource：

如果通过了初步的条件检查，将尝试获取一个针对当前bean的自定义TargetSource。
这一步是检查是否有特定于该bean的增强配置，如果有，则可以继续创建代理。

4. 代理对象的创建：

如果存在自定义的TargetSource，则使用相关的advisors（增强器）和这个TargetSource来创建一个代理对象。
这个代理对象将能够在运行时拦截对bean的调用，并应用定义的增强逻辑（如安全检查、事务管理等）。

5. 返回结果：

如果成功创建了代理对象，则返回这个对象给调用者。
如果没有自定义的TargetSource或者不需要创建代理，方法将返回null。

条件判断

缓存键不存在或bean需要代理：这个分支处理创建代理所需的条件检查和配置获取。
自定义TargetSource存在：只有当自定义的TargetSource存在时，才会尝试创建代理对象。
自定义TargetSource不存在或缓存键存在且bean不需要代理：这些情况将导致方法返回null，不进行代理的创建。

2. 匹配增强器 Advisors（源码分析时序图说明）

增强器（或称为 "advisors"）定义何时以及如何增强目标对象。源码中的AbstractAdvisorAutoProxyCreator类继承自AbstractAutoProxyCreator，添加处理Advisor的功能。特别是findEligibleAdvisors方法，它用于找出适用于特定bean的所有advisors。

来看看源码

提取关键代码分析

代码语言：javascript复制

// 重写getAdvicesAndAdvisorsForBean方法，用于获取适用于特定bean的advisors和advices
@Override
@Nullable
protected Object[] getAdvicesAndAdvisorsForBean(
        Class<?> beanClass, String beanName, @Nullable TargetSource targetSource) {

    // 调用findEligibleAdvisors方法获取所有适用的advisors
    List<Advisor> advisors = findEligibleAdvisors(beanClass, beanName);
    // 如果没有找到任何适用的advisor，则返回DO_NOT_PROXY（不进行代理）
    if (advisors.isEmpty()) {
        return DO_NOT_PROXY;
    }
    // 将找到的advisors转换为数组并返回
    return advisors.toArray();
}

/**
 * 查找所有适合自动代理的advisors。
 * @param beanClass 需要查找advisors的bean的类
 * @param beanName 当前被代理的bean的名称
 * @return 如果没有找到适用的pointcuts或interceptors，返回空列表，而不是null
 * @see #findCandidateAdvisors 查找候选的advisors
 * @see #sortAdvisors 对advisors进行排序
 * @see #extendAdvisors 扩展advisors
 */
protected List<Advisor> findEligibleAdvisors(Class<?> beanClass, String beanName) {
    // 查找所有候选的advisors
    List<Advisor> candidateAdvisors = findCandidateAdvisors();
    // 从候选advisors中找出可以应用于当前bean的advisors
    List<Advisor> eligibleAdvisors = findAdvisorsThatCanApply(candidateAdvisors, beanClass, beanName);
    // 可选操作：扩展advisors列表
    extendAdvisors(eligibleAdvisors);
    // 如果找到了适用的advisors，则对它们进行排序
    if (!eligibleAdvisors.isEmpty()) {
        eligibleAdvisors = sortAdvisors(eligibleAdvisors);
    }
    // 返回最终确定的适用于当前bean的advisors列表
    return eligibleAdvisors;
}

用时序图表示如下：

时序图详解

1. 客户端请求Bean实例:

客户端向AbstractAutoProxyCreator发出请求以获取Bean实例。这通常发生在Spring的应用上下文中，当一个Bean被请求时，Spring会检查这个Bean是否需要代理。

2. 调用findEligibleAdvisors方法:

AbstractAutoProxyCreator调用findEligibleAdvisors方法，传入beanClass和beanName。这个方法负责找出所有可能适用于这个特定Bean的Advisors。

3. 查找所有候选Advisors:

findEligibleAdvisors进一步调用findCandidateAdvisors，这个方法从Spring的应用上下文中检索所有配置的Advisors。

4. 筛选适用于Bean的Advisors:

返回的候选Advisors列表会传给findAdvisorsThatCanApply，这个方法根据当前Bean的类型和名称筛选出适用的Advisors。

5. 对Advisors进行排序:

适用的Advisors会传给sortAdvisors，以确保在代理中按正确的顺序应用它们。

6. 返回适用的Advisors列表:

findEligibleAdvisors将排序后的Advisors列表返回给AbstractAutoProxyCreator。

7. 决策点 - 是否存在适用的Advisors:

如果找到适用的Advisors，将继续创建Bean的代理；如果没有找到，直接返回原始的Bean实例。

8. 创建Bean的代理:

代理工厂根据返回的Advisors创建Bean的代理实例，并将Advisors注入到代理中。

9. 客户端调用Bean的方法:

客户端通过代理实例调用Bean的方法。如果Bean被代理，Advisors中定义的额外逻辑（例如，拦截、事务管理）会在调用实际Bean方法之前或之后执行。

10. 返回方法执行结果:

方法执行完成后，结果通过代理返回给客户端。

3. 创建代理对象（源码分析时序图说明）

如果发现有合适的advisors，Spring将使用AOP代理工厂来创建代理对象。这部分的处理通常涉及到多种代理的创建策略，如JDK动态代理或CGLIB代理。

查看AbstractAutoProxyCreator中的createProxy方法。这个方法负责根据给定的bean、其对应的bean名称、匹配到的advisors等信息来创建代理对象。

源代码如下：

提出代码分析：

代码语言：javascript复制

/**
 * 创建给定bean的AOP代理。
 * @param beanClass bean的类
 * @param beanName bean的名称
 * @param specificInterceptors 针对这个bean的一组拦截器（可能为空，但不为null）
 * @param targetSource 为代理配置的目标源
 * @return bean的AOP代理
 * @see #buildAdvisors 构建advisor的方法
 */
protected Object createProxy(Class<?> beanClass, @Nullable String beanName,
        @Nullable Object[] specificInterceptors, TargetSource targetSource) {

    // 检查bean工厂是否为ConfigurableListableBeanFactory类型，如果是，则暴露bean的目标类
    if (this.beanFactory instanceof ConfigurableListableBeanFactory) {
        AutoProxyUtils.exposeTargetClass((ConfigurableListableBeanFactory) this.beanFactory, beanName, beanClass);
    }

    // 创建ProxyFactory对象，并从当前实例复制配置
    ProxyFactory proxyFactory = new ProxyFactory();
    proxyFactory.copyFrom(this);

    // 判断是否应该使用代理目标类，而不是只使用接口代理
    if (proxyFactory.isProxyTargetClass()) {
        // 如果beanClass是一个JDK代理类，处理引入通知场景
        if (Proxy.isProxyClass(beanClass)) {
            // 允许引入，不能仅设置接口为代理的接口
            for (Class<?> ifc : beanClass.getInterfaces()) {
                proxyFactory.addInterface(ifc);
            }
        }
    } else {
        // 如果没有强制代理目标类标志，则进行默认检查
        if (shouldProxyTargetClass(beanClass, beanName)) {
            // 如果决定代理目标类，则设置相应标志
            proxyFactory.setProxyTargetClass(true);
        } else {
            // 否则，评估并设置需要代理的接口
            evaluateProxyInterfaces(beanClass, proxyFactory);
        }
    }

    // 构建适用于此bean的advisors数组
    Advisor[] advisors = buildAdvisors(beanName, specificInterceptors);
    // 将advisors添加到代理工厂
    proxyFactory.addAdvisors(advisors);
    // 设置代理的目标源
    proxyFactory.setTargetSource(targetSource);
    // 根据需要自定义代理工厂
    customizeProxyFactory(proxyFactory);

    // 设置代理是否冻结，即之后是否允许更改代理的配置
    proxyFactory.setFrozen(this.freezeProxy);
    // 如果advisors已经预过滤，设置代理为预过滤状态
    if (advisorsPreFiltered()) {
        proxyFactory.setPreFiltered(true);
    }

    // 获取代理的类加载器
    ClassLoader classLoader = getProxyClassLoader();
    if (classLoader instanceof SmartClassLoader && classLoader != beanClass.getClassLoader()) {
        // 如果类加载器为SmartClassLoader且与bean的类加载器不同，使用原始类加载器
        classLoader = ((SmartClassLoader) classLoader).getOriginalClassLoader();
    }
    // 获取并返回代理对象
    return proxyFactory.getProxy(classLoader);
}

时序图如下：

时序图详解：

1. 客户端请求创建代理

动作：客户端向Spring容器请求创建一个代理对象。这通常是因为客户端需要一个被AOP增强的Bean，比如添加了事务管理、性能监控或安全控制等。
背景：这通常发生在Spring应用启动时或者第一次请求Bean时，Spring容器会根据Bean的定义和AOP配置决定是否需要创建代理。

2. Spring容器调用createProxy方法

动作：Spring容器调用createProxy方法开始代理创建过程。
背景：createProxy是实现代理逻辑的核心方法，它负责集成所有相关配置并生成代理对象。

3. 检查BeanFactory类型并暴露目标类

动作：createProxy方法首先检查Bean工厂的类型，如果是ConfigurableListableBeanFactory，则调用AutoProxyUtils.exposeTargetClass来暴露Bean的目标类。
目的：这一步骤是为了在需要时能够获取Bean的实际类信息，尤其是当代理需要基于类而非接口创建时。

4. 创建ProxyFactory实例

动作：createProxy方法创建一个ProxyFactory实例。
目的：ProxyFactory是用于创建实际代理对象的工具，它支持对代理的各种配置，如代理的类型、拦截器链等。

5. 判断并处理代理策略

动作：根据是否使用代理目标类来决定代理方式，包括是否为JDK动态代理或CGLIB代理。
条件分支：
如果目标类已是JDK代理类，将添加所有实现的接口到代理。
如果不是JDK代理类，将根据shouldProxyTargetClass的结果决定是否代理目标类或仅代理特定接口。

6. 构建Advisors并配置ProxyFactory

动作：调用buildAdvisors方法构建适用于此Bean的advisors数组，然后将这些advisors添加到ProxyFactory。
目的：Advisors包含了增强的定义，这些增强定义了如何拦截方法调用及在调用前后执行特定的操作。

7. 自定义ProxyFactory并创建代理对象

动作：设置代理的目标源、自定义配置，冻结配置以确保在运行时不被修改，设置预过滤以优化匹配过程，最后通过ProxyFactory获取代理对象。
目的：完成所有代理配置后，最终生成代理对象，该对象将在运行时代表原始Bean，增加了指定的AOP功能。

8. 返回代理对象

动作：createProxy方法将代理对象返回给Spring容器，容器再返回给客户端。
结果：客户端接收到的Bean是一个被代理增强过的对象，具备了额外的AOP功能，如事务控制、安全检查等。

欢迎一键三连~

有问题请留言，大家一起探讨学习

----------------------Talk is cheap, show me the code-----------------------

java spring spring-aop

0 人点赞

Spring高手之路21——深入剖析Spring AOP代理对象的创建

创建代理对象核心动作的三个步骤

1. 判断 Bean 是否需要增强（源码分析 时序图说明）

2. 匹配增强器 Advisors（源码分析 时序图说明）

3. 创建代理对象（源码分析 时序图说明）

1. 判断 Bean 是否需要增强（源码分析时序图说明）

2. 匹配增强器 Advisors（源码分析时序图说明）

3. 创建代理对象（源码分析时序图说明）