Spring4.3.x 浅析xml配置的解析过程（10）——解析aop命名空间之aspectj-autoproxy标签

概述

Spring的AOP命名空间提供了<aop:config>、<aop:aspectj-autoproxy>和<aop:scoped-proxy>三大标签。前两个标签的作用是想指定pointcut（切点）提供adivce（增强）处理，而<aop:scoped-proxy>的作用是对生命周期短的bean提供装饰，使生命周期短的bean能被生命周期长的bean正确调用。这一篇不会探讨<aop:scoped-proxy>标签，而<aop:config>的探讨见解析aop命名空间之config标签，下面我们来探讨spring如何解析<aop:aspectj-autoproxy>标签。

解析<aop:aspectj-autoproxy>标签

<aop:aspectj-autoproxy>的解析器是AspectJAutoProxyBeanDefinitionParser，它直接实现了BeanDefinitionParser接口的parse方法，下面是这个方法的源码。

    @Override
    public BeanDefinition parse(Element element, ParserContext parserContext) {
        AopNamespaceUtils.registerAspectJAnnotationAutoProxyCreatorIfNecessary(parserContext, element);
        extendBeanDefinition(element, parserContext);
        return null;
    }

parse方法就两行代码，它们分别是想容器中注册自动代理构建器对象和解析<aop:aspectj-autoproxy>的子标签<aop:include>。我们分别来看看这两件事情的细节。

1 创建自动代理构建器对象
parse方法调用AOP命名空间工具类AopNamespaceUtils的registerAspectJAnnotationAutoProxyCreatorIfNecessary方法来完成向容器中注册自动代理构建器对象的任务，源码如下。

    public static void registerAspectJAnnotationAutoProxyCreatorIfNecessary(
            ParserContext parserContext, Element sourceElement) {

        // 注册自动代理构建器对象
        BeanDefinition beanDefinition = AopConfigUtils.registerAspectJAnnotationAutoProxyCreatorIfNecessary(
                parserContext.getRegistry(), parserContext.extractSource(sourceElement));
                // 解析proxy-target-class和expose-proxy属性
        useClassProxyingIfNecessary(parserContext.getRegistry(), sourceElement);
        registerComponentIfNecessary(beanDefinition, parserContext);
    }

继续看AOP配置工具类AopConfigUtils的registerAspectJAnnotationAutoProxyCreatorIfNecessary方法，源码如下。

    public static BeanDefinition registerAspectJAnnotationAutoProxyCreatorIfNecessary(BeanDefinitionRegistry registry, Object source) {
        // 向容器中注册一个AnnotationAwareAspectJAutoProxyCreator对象
        return registerOrEscalateApcAsRequired(AnnotationAwareAspectJAutoProxyCreator.class, registry, source);
    }

下面是AopConfigUtils工具类的registerOrEscalateApcAsRequired方法

    private static BeanDefinition registerOrEscalateApcAsRequired(Class<?> cls, BeanDefinitionRegistry registry, Object source) {
        Assert.notNull(registry, "BeanDefinitionRegistry must not be null");
        // 定义有AUTO_PROXY_CREATOR_BEAN_NAME="org.springframework.aop.config.internalAutoProxyCreator"
        if (registry.containsBeanDefinition(AUTO_PROXY_CREATOR_BEAN_NAME)) {
             // 如果容器中已经存在自动代理构建器，则比较两个构建器的优先级
            BeanDefinition apcDefinition = registry.getBeanDefinition(AUTO_PROXY_CREATOR_BEAN_NAME);
            if (!cls.getName().equals(apcDefinition.getBeanClassName())) {
                int currentPriority = findPriorityForClass(apcDefinition.getBeanClassName());
                int requiredPriority = findPriorityForClass(cls);
                // 保存优先级高的构建器
                if (currentPriority < requiredPriority) {
                    apcDefinition.setBeanClassName(cls.getName());
                }
            }
            return null;
        }
        // 如果容器中还没有自动代理构建器
        // 则创建构建器相应的BeanDefinition对象 
        RootBeanDefinition beanDefinition = new RootBeanDefinition(cls);
        beanDefinition.setSource(source);
        beanDefinition.getPropertyValues().add("order", Ordered.HIGHEST_PRECEDENCE);
        beanDefinition.setRole(BeanDefinition.ROLE_INFRASTRUCTURE);
        // 向容器中注册代理构建器的BeanDefinition对象
        registry.registerBeanDefinition(AUTO_PROXY_CREATOR_BEAN_NAME, beanDefinition);
        return beanDefinition;
    }

AopConfigUtils获取代理构建器的优先级方法内容如下。

    private static int findPriorityForClass(Class<?> clazz) {
        return APC_PRIORITY_LIST.indexOf(clazz);
    }

其中AopConfigUtils中定义了如下自动代理构建器

    private static final List<Class<?>> APC_PRIORITY_LIST = new ArrayList<Class<?>>();
    static {
        APC_PRIORITY_LIST.add(InfrastructureAdvisorAutoProxyCreator.class);
        APC_PRIORITY_LIST.add(AspectJAwareAdvisorAutoProxyCreator.class);
        APC_PRIORITY_LIST.add(AnnotationAwareAspectJAutoProxyCreator.class);
    }

从上面代码可以看出AnnotationAwareAspectJAutoProxyCreator的优先级最高，其次是AspectJAwareAdvisorAutoProxyCreator，而InfrastructureAdvisorAutoProxyCreator的优先级最低。

2 解析<aop:include>子标签

AspectJAutoProxyBeanDefinitionParser的parse方法调用这个类的extendBeanDefinition方法来完成解析<aop:include>标签的解析，这个方法的源码如下。

    private void extendBeanDefinition(Element element, ParserContext parserContext) {
        // 获得自动代理构建器的BeanDefinition
        BeanDefinition beanDef =
                parserContext.getRegistry().getBeanDefinition(AopConfigUtils.AUTO_PROXY_CREATOR_BEAN_NAME);
        if (element.hasChildNodes()) {
            addIncludePatterns(element, parserContext, beanDef);
        }
    }

extendBeanDefinition方法的作用是获取自动代理构建器的BeanDefinition对象和判断配置文件中<aop:aspectj-autoproxy>的定义是否还有子节点。下面继续看AspectJAutoProxyBeanDefinitionParser的addIncludePatterns方法，源码如下。

    private void addIncludePatterns(Element element, ParserContext parserContext, BeanDefinition beanDef) {
        ManagedList<TypedStringValue> includePatterns = new ManagedList<TypedStringValue>();
        NodeList childNodes = element.getChildNodes();
        // 遍历子节点
        for (int i = 0; i < childNodes.getLength(); i++) {
            Node node = childNodes.item(i);
            // apsect-autoproxy标签只有一个子标签，那就是include标签
            // 这里判断节点是否为Element对象
            if (node instanceof Element) {
                Element includeElement = (Element) node;
                // 获取include标签的name属性
                TypedStringValue valueHolder = new TypedStringValue(includeElement.getAttribute("name"));
                valueHolder.setSource(parserContext.extractSource(includeElement));
                includePatterns.add(valueHolder);
            }
        }
        if (!includePatterns.isEmpty()) {
            includePatterns.setSource(parserContext.extractSource(element));
            // 使用解析inculde标签获得的includePatterns来设置代理构建器的includePatterns属性。
            beanDef.getPropertyValues().add("includePatterns", includePatterns);
        }
    }

总结

<aop:aspectj-autoproxy>和<aop:config>一样，首先会向spring容器中注册自动代理构建器。<aop:config>注册的是AspectJAwareAdvisorAutoProxyCreator对象，它用于暴露AspectJ的执行上下文和遵从AspectJ判读来自同一个aspect（切面）的多个advice（增强）的执行顺序的规则。<aop:aspectj-autoproxy>注册的是AnnotationAwareAspectJAutoProxyCreator对象，它继承了AspectJAwareAdvisorAutoProxyCreator类，并处理当前所处spring容器中所有的AspectJ注解。