一、简介
BeanDefinition描述了一个Bean的实例,包括属性,构造方法参数,注解等更多信息。为后面实例化Bean提供元数据依据。
BeanDefinition的实现类有:
1. RootBeanDefinition:spring BeanFactory运行期里,内部特殊bean的定义。
2. ConfigurationClassBeanDefinition:继承RootBeanDefinition,ConfigurationClassBeanDefinitionReader内部静态类。上文(2)中提到的Configuration Class内定义的Bean被解析成这个BeanDefinition。
3. ChildBeanDefinition:Spring2.5后弃用。
4. GenericBeanDefinition:@EnableConfigurationProperties和Spring显示创建。@ImportResource
5. ScannedGenericBeanDefinition:上文(2)中提到的ComponentScanAnnotationParser扫描的@Component定义被解析成这个BeanDefinition。
6. AnnotatedGenericBeanDefinition:Spring Boot autoconfigure功能spring.facotries中定义的EnableAutoConfiguration,以及内部子Configuration。@Import
二、创建过程
1.GenericBeanDefinition:
这里主要看一下@ImportResource xml中定义的bean。
ConfigurationClassBeanDefinitionReader解析Configuration Class时会解析ImportResource,XmlBeanDefinitionReader具体解析xml中的Beans,最终由BeanDefinitionParserDelegate解析每个Bean:
public AbstractBeanDefinition parseBeanDefinitionElement(
Element ele, String beanName, BeanDefinition containingBean) {
this.parseState.push(new BeanEntry(beanName));
String className = null;
if (ele.hasAttribute(CLASS_ATTRIBUTE)) {
className = ele.getAttribute(CLASS_ATTRIBUTE).trim();
}
try {
String parent = null;
if (ele.hasAttribute(PARENT_ATTRIBUTE)) {
parent = ele.getAttribute(PARENT_ATTRIBUTE);
}
//构建GenericBeanDefinition并设置className和parentName
AbstractBeanDefinition bd = createBeanDefinition(className, parent);
//对scope、abstract、lazy-init、autowire、dependency-check、depends-on、autowire-candidate、primary、init-method、destroy-method、factory-method、factory-bean属性进行解析。
parseBeanDefinitionAttributes(ele, beanName, containingBean, bd);
bd.setDescription(DomUtils.getChildElementValueByTagName(ele, DESCRIPTION_ELEMENT));
//解析meta数据,用于注入。<meta key="format" value="BLURAY"/>
parseMetaElements(ele, bd);
//解析lookup-method数据,用于abstract方法动态生产bean。<lookup-method name="createCommand" bean="myCommand"/>
parseLookupOverrideSubElements(ele, bd.getMethodOverrides());
/** * 解析replaced-method数据,用于根据参数类型替换方法。 * <replaced-method name="computeValue" replacer="replacementComputeValue"> * <arg-type>String</arg-type> * </replaced-method> **/
parseReplacedMethodSubElements(ele, bd.getMethodOverrides());
// 解析constructor-arg,构造函数参数。可以index,type,name匹配。
parseConstructorArgElements(ele, bd);
// 解析property数据,用于属性赋值或注入。<property name="driverClassName" value="com.mysql.jdbc.Driver"/>
parsePropertyElements(ele, bd);
/** * 解析qualifier数据,用于注入,和meta类似。 * <qualifier type="MovieQualifier"> * <attribute key="format" value="VHS"/> * <attribute key="genre" value="Action"/> * </qualifier> **/
parseQualifierElements(ele, bd);
bd.setResource(this.readerContext.getResource());
bd.setSource(extractSource(ele));
return bd;
}
catch (ClassNotFoundException ex) {
error("Bean class [" + className + "] not found", ele, ex);
}
catch (NoClassDefFoundError err) {
error("Class that bean class [" + className + "] depends on not found", ele, err);
}
catch (Throwable ex) {
error("Unexpected failure during bean definition parsing", ele, ex);
}
finally {
this.parseState.pop();
}
return null;
}
解析完基本BeanDefinition后,需要调用decorateBeanDefinitionIfRequired
对NameSpace属性进行解析如p:name=”test”。
到此定义在xml中Bean解析成GenericBeanDefinition完成。
2.ScannedGenericBeanDefinition
ScannedGenericBeanDefinition通过扫描Component,再通过MetadataReader获取AnnotationMetadata构建。重点关注MetadataReader的获取。
MetadataReader直接通过构造函数构建:
SimpleMetadataReader(Resource resource, ClassLoader classLoader) throws IOException {
InputStream is = new BufferedInputStream(resource.getInputStream());
ClassReader classReader;
try {
classReader = new ClassReader(is);
}
catch (IllegalArgumentException ex) {
throw new NestedIOException("ASM ClassReader failed to parse class file - " +
"probably due to a new Java class file version that isn't supported yet: " + resource, ex);
}
finally {
is.close();
}
AnnotationMetadataReadingVisitor visitor = new AnnotationMetadataReadingVisitor(classLoader);
classReader.accept(visitor, ClassReader.SKIP_DEBUG);
this.annotationMetadata = visitor;
// (since AnnotationMetadataReadingVisitor extends ClassMetadataReadingVisitor)
this.classMetadata = visitor;
this.resource = resource;
}
从源码可以看出, annotationMetadata 直接直接通过读取java class文件获取信息,后面bean的创建,就使用了这个annotationMetadata 。
3.ConfigurationClassBeanDefinition
ConfigurationClassBeanDefinition是定义在Configuration Class中的Bean,在这个bean创建是需要调用到Configuration Class中定义bean的方法。所以这个BeanDefinition的重点(特殊点)在于factoryMethodMetadata,即Configuration Class的对应的MethodMetaData。再通过解析Bean注解和Scope注解设置相应的值。
4.AnnotatedGenericBeanDefinition
@Import中定义的Bean,是作为Configuration Class来进行解析的,在ConfigurationClassParser
时已经解析成一个Configuration Class,并生成了metadata。后续和Component生成ScannedGenericBeanDefinition类似。spring.facotries中的EnableAutoConfiguration也是在ConfigurationClassParser的时候扫描得到Configuration Class。
5.ConfigurationClass
上面几个BeanDefinition创建是需要用的ConfigurationClass, ConfigurationClass是何时创建的,怎么创建的?
ConfigurationClassParser中创建ConfigurationClass源码:
protected final void parse(String className, String beanName) throws IOException {
MetadataReader reader = this.metadataReaderFactory.getMetadataReader(className);
processConfigurationClass(new ConfigurationClass(reader, beanName));
}
protected final void parse(Class<?> clazz, String beanName) throws IOException {
processConfigurationClass(new ConfigurationClass(clazz, beanName));
}
protected final void parse(AnnotationMetadata metadata, String beanName) throws IOException {
processConfigurationClass(new ConfigurationClass(metadata, beanName));
}
public ConfigurationClass asConfigClass(ConfigurationClass importedBy) throws IOException {
if (this.source instanceof Class<?>) {
return new ConfigurationClass((Class<?>) this.source, importedBy);
}
return new ConfigurationClass((MetadataReader) this.source, importedBy);
}
第一个是在递归解析Component时创建。最后一个是在解析内部成员类和Import类。
6.getMergedBeanDefinition
在构建Bean实例是,都会获取MergedBeanDefinition,这个功能是把所有不是RootBeanDefinition实例的转成RootBeanDefinition,进行统一调用。