概要
过度
我们上面介绍了Spring的AOP实现的整体思路,其中第一部分是动态代理的构建,流程图如下:
我们本节主要介绍扫描配置项并生成对应的增强器。
内容简介
本文主要介绍切面的扫描和增强器的生成、注册。
所属环节
扫描配置、生成增强器。
上下环节
上文: 无
下文: 实例化Bean时根据增强器生成动态代理
源码解析
入口
还是从概述一文提出的例子入手。
激活Spring扫描@Aspect
的功能:
<aop:aspectj-autoproxy />
自行定义一个类来声明一个切面:
@Aspect
@Component
public class LogAspect {
private Logger logger = LoggerFactory.getLogger(LogAspect.class);
@Around(value = "@annotation(com.LogPoint)")
public Object executeAnnotation(ProceedingJoinPoint jp) throws Throwable {
// do something
Object obj = jp.proceed();
// do something
return obj;
}
}
我们发现,这里是从一个xml标签的解读开始的,根据我们之前阅读XmlBeanFactory
的思路,应该从对自定义标签的解读入手,我们解读思路如下:
- 根据标签的命名空间找到对应的解析器
- 找到这个标签的解析逻辑,然后看看这个标签做了些什么
确认命名空间解析逻辑
我们从"/META-INF/spring.handlers"中找到命名空间和解析器的对应关系:
http\://www.springframework.org/schema/aop=org.springframework.aop.config.AopNamespaceHandler
我们进入AopNamespaceHandler
类下:
public void init() {
// In 2.0 XSD as well as in 2.1 XSD.
// 直接从这里读取并配置 AOP 切面
registerBeanDefinitionParser("config", new ConfigBeanDefinitionParser());
// 配置可以使用 AspectJ 的相关注解生成 AOP 切面
registerBeanDefinitionParser("aspectj-autoproxy", new AspectJAutoProxyBeanDefinitionParser());
registerBeanDefinitionDecorator("scoped-proxy", new ScopedProxyBeanDefinitionDecorator());
// Only in 2.0 XSD: moved to context namespace as of 2.1
registerBeanDefinitionParser("spring-configured", new SpringConfiguredBeanDefinitionParser());
}
我们找到了<aop:aspectj-autoproxy />
标签对应的解析器是AspectJAutoProxyBeanDefinitionParser
。
确认标签解析的主逻辑
我们进入AspectJAutoProxyBeanDefinitionParser
看看他的解析逻辑:
public BeanDefinition parse(Element element, ParserContext parserContext) {
// 根据 <aop:aspectj-autoproxy> 的属性进行 Creator 的 BD 及相关配置的设置
AopNamespaceUtils.registerAspectJAnnotationAutoProxyCreatorIfNecessary(parserContext, element);
// 根据 <aop:aspectj-autoproxy> 的子节点进行 Creator 的 BD 及相关配置的完善
// 一般配置的是 Creator 的 BD 的属性自动注入
extendBeanDefinition(element, parserContext);
return null;
}
先注册实现aspectj-autoproxy
逻辑的后处理器,方便在后面实例化 Bean 时能根据情况创建动态代理。然后对该标签的子节点进行相关处理。
我们在最开始的概述里说明白了,这里只是创建一个后处理器,方便在实例化Bean时根据情况创建动态代理,不需要创建什么新的BD,所以返回null
。
标签注册的后处理器
public static void registerAspectJAnnotationAutoProxyCreatorIfNecessary(
ParserContext parserContext, Element sourceElement) {
// 确保对应的 Creator BD 已经创建
BeanDefinition beanDefinition = AopConfigUtils.registerAspectJAnnotationAutoProxyCreatorIfNecessary(
parserContext.getRegistry(), parserContext.extractSource(sourceElement));
// 将<aop:aspectj-autoproxy>中的属性同步至上面的 BD 中
useClassProxyingIfNecessary(parserContext.getRegistry(), sourceElement);
// TODO 此处注册有点不明所以
registerComponentIfNecessary(beanDefinition, parserContext);
}
委托注册后处理器
我们这里从AopConfigUtils.registerAspectJAnnotationAutoProxyCreatorIfNecessary()
介入。
委托的注册如下:
@Nullable
public static BeanDefinition registerAspectJAnnotationAutoProxyCreatorIfNecessary(
BeanDefinitionRegistry registry, @Nullable Object source) {
return registerOrEscalateApcAsRequired(AnnotationAwareAspectJAutoProxyCreator.class, registry, source);
}
AOP动态代理的生成委托的后处理器是AnnotationAwareAspectJAutoProxyCreator
。我们在下一篇文章中详细介绍。
这里为了防止重复注册,还引入了优先级的判断,重复注册情况保留最高优先级的Creator
:
private static BeanDefinition registerOrEscalateApcAsRequired(
Class<?> cls, BeanDefinitionRegistry registry, @Nullable Object source) {
Assert.notNull(registry, "BeanDefinitionRegistry must not be null");
// 已经创建过 Creator ,比较优先级
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) {
//传入的优先级比现在的高,改个class name 就行了, BD 么。。。。。别疑神疑鬼了
apcDefinition.setBeanClassName(cls.getName());
}
}
return null;
}
// 还没创建过,注册 bean
// 都是保存高优先级的 bd ,这就行了
RootBeanDefinition beanDefinition = new RootBeanDefinition(cls);
beanDefinition.setSource(source);
beanDefinition.getPropertyValues().add("order", Ordered.HIGHEST_PRECEDENCE);
// 用来创建代理的,角色为后台服务
beanDefinition.setRole(BeanDefinition.ROLE_INFRASTRUCTURE);
registry.registerBeanDefinition(AUTO_PROXY_CREATOR_BEAN_NAME, beanDefinition);
return beanDefinition;
}
根据标签属性设置AOP策略
我们这里从useClassProxyingIfNecessary()
介入。
private static void useClassProxyingIfNecessary(BeanDefinitionRegistry registry, @Nullable Element sourceElement) {
if (sourceElement != null) {
// 是否强制使用 CGLIB 创建代理【代理类,jdk是代理接口】
boolean proxyTargetClass = Boolean.parseBoolean(sourceElement.getAttribute(PROXY_TARGET_CLASS_ATTRIBUTE));
if (proxyTargetClass) { // 如果设置了,就同步到对应的 BD 中
AopConfigUtils.forceAutoProxyCreatorToUseClassProxying(registry);
}
boolean exposeProxy = Boolean.parseBoolean(sourceElement.getAttribute(EXPOSE_PROXY_ATTRIBUTE));
if (exposeProxy) { // 如果设置了,就同步到对应的 BD 中
AopConfigUtils.forceAutoProxyCreatorToExposeProxy(registry);
}
// 我们此函数设置的 BD 和上面注册的 BD 是一个,这个 BD 后面会进行代码的扫描和Advisor的创建
}
}
有人可能会疑惑为什么不传BD,这怎么设置?因为支持AOP的BeanID是固定的,所以知道registry和要解析的dom节点即可获得指定的BD,并进行解析和设置。
标签对子节点和相关属性的处理
这里不再进行细述,毕竟我们配置<aop:aspectj-autoproxy />
是用来扫描代码的,不是在这下面的子节点继续配什么乱七八糟的东西的。框架支持的功能太多了,我们关注主干逻辑即可。