spring 源码分析-IOC器皿初始化六
上一节将xml文档解析为DOM ，并且创建了一个 BeanDefinitionParserDelegate 类型的对象，在这一节，将使用这个对象来完成对bean的装载工作。
2.1.1.1 parseBeanDefinitions (root, delegate): 该方法体完成注册过程。
====================================================================
/**
* Process the given bean element, parsing the bean definition
* and registering it with the registry . 这里对我们最熟悉的 bean 元素进行处理
*/
protected void processBeanDefinition(Element ele, BeanDefinitionParserDelegate delegate) {
/**
* 委托给 BeanDefinitionParserDelegate 来完成对 bean 元素的处理，这个类包含了具
* 体的 bean 解析的过程。把解析 bean 文件得到的信息放到 BeanDefinition 里，他是 bean
* 信息的主要载体，也是 IOC 容器的管理对象。
*/
BeanDefinitionHolder bdHolder = delegate.parseBeanDefinitionElement(ele) ;
if (bdHolder != null ) {
bdHolder = delegate.decorateBeanDefinitionIfRequired(ele, bdHolder);
try {
// 这里是向 IOC 容器注册，实际上是放到 IOC 容器的一个 map 里
BeanDefinitionReaderUtils.registerBeanDefinition (bdHolder, getReaderContext().getRegistry());
} catch (BeanDefinitionStoreException ex) {
getReaderContext().error( "Failed to register bean definition with name '" +bdHolder.getBeanName() + "'" , ele, ex);
}
// 这里向 IOC 容器发送事件，表示解析和注册完成。
getReaderContext().fireComponentRegistered( new BeanComponentDefinition(bdHolder));
}
}
====================================================================
2.1.1.1.1 parseBeanDefinitionElement(Element ele) 定义在类 BeanDefinitionParserDelegate 中：定义如下：
====================================================================
public BeanDefinitionHolder parseBeanDefinitionElement (Element ele, BeanDefinition containingBean) {
//ID_ATTRIBUTE = "id"
String id = ele.getAttribute( ID_ATTRIBUTE );
//NAME_ATTRIBUTE = "name"
String nameAttr = ele.getAttribute( NAME_ATTRIBUTE );
List aliases = new ArrayList ();
if (StringUtils.hasLength (nameAttr)) {
// BEAN_NAME_DELIMITERS = ",; "
String[] nameArr = StringUtils.tokenizeToStringArray (nameAttr, BEAN_NAME_DELIMITERS );
// 添加别名
aliases.addAll(Arrays.asList (nameArr)) ;
}
String beanName = id;
// 如果没有定义 id ，但是定义了 name 属性，则把 name 属性中的第一个做 bean 的名字。
if (!StringUtils.hasText (beanName) && !aliases.isEmpty()) {
beanName = (String) aliases.remove(0);
if ( logger .isDebugEnabled()) {
logger .debug( "No XML 'id' specified - using '" + beanName +
"' as bean name and " + aliases + " as aliases" );
}
}
// 默认为 null
if (containingBean == null ) {
// 保证唯一性，
checkNameUniqueness(beanName, aliases, ele) ;
}
// 自己解析 bean 的定义，出错可能返回 null
AbstractBeanDefinition beanDefinition = parseBeanDefinitionElement(ele, beanName, containingBean) ;
if (beanDefinition != null ) {
/**
* 如果没有 beanname 这根据父 bean 或者生产它的工厂名字产生 beanname
*/
if (!StringUtils.hasText (beanName)) {
try {
if (containingBean != null ) {
beanName = BeanDefinitionReaderUtils.generateBeanName (
beanDefinition, this . readerContext .getRegistry(), true );
} else {
beanName = this . readerContext .generateBeanName(beanDefinition);
// Register an alias for the plain bean class name, if still possible,
// if the generator returned the class name plus a suffix.
// This is expected for Spring 1.2/2.0 backwards compatibility.
String beanClassName = beanDefinition.getBeanClassName();
if (beanClassName != null &&
beanName.startsWith(beanClassName) && beanName.length() > beanClassName.length() && ! this . readerContext .getRegistry().isBeanNameInUse(beanClassName)) {
aliases.add(beanClassName) ;
}
}
if ( logger .isDebugEnabled()) {
logger .debug( "Neither XML 'id' nor 'name' specified - " +
"using generated bean name [" + beanName + "]" );
}
}
catch (Exception ex) {
error(ex.getMessage(), ele);
return null ;
}
}
String[] aliasesArray = StringUtils.toStringArray (aliases);
return new BeanDefinitionHolder(beanDefinition, beanName, aliasesArray);
}
return null ;
}
====================================================================
2.1.1.1.1.1 checkNameUniqueness(beanName, aliases, ele) ：保证 beanname 的唯一性，
====================================================================
protected void checkNameUniqueness(String beanName, List aliases, Element beanElement) {
String foundName = null ;
// 如果 usedNames 集合里面已经有了，报错
if (StringUtils.hasText (beanName) && this . usedNames .contains(beanName)){
foundName = beanName;
}
if (foundName == null ) {
foundName = (String) CollectionUtils.findFirstMatch ( this . usedNames , aliases);
}
if (foundName != null ) {
error( "Bean name '" + foundName + "' is already used in this file" , beanElement);
}
// 如果都 ok 则将当前的 beanname 放到集合中。
this . usedNames .add(beanName) ;
this . usedNames .addAll(aliases) ;
}
====================================================================
2.1.1.1.1.2 parseBeanDefinitionElement(ele, beanName, containingBean)
自己解析 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 );
}
// 通过 BeanDefinitionReaderUtils 类装载 bean 的实例，返回一个
// AbstractBeanDefinition 子类： GenericBeanDefinition
// 设置 beanClass 和 parentName
AbstractBeanDefinition bd = createBeanDefinition(className, parent);
// 设置属性
parseBeanDefinitionAttributes(ele, beanName, containingBean, bd);
bd.setDescription(DomUtils.getChildElementValueByTagName (ele, DESCRIPTION_ELEMENT ));
parseMetaElements(ele, bd);
parseLookupOverrideSubElements(ele, bd.getMethodOverrides());
parseReplacedMethodSubElements(ele, bd.getMethodOverrides());
parseConstructorArgElements(ele, bd);
parsePropertyElements(ele, bd);
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 ;
}
到这里我们将xml里面关于bean的定义封装到一个AbstractBeanDefinition对象里面，并且进一步封装到 BeanDefinitionHolder类型的对象里。