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类型的对象里。

 

 

本站支持 pay for your wishes