org.springframework.beans.factory.xml

## 接口 BeanDefinitionParser

- 所有已知实现类:
    AbstractBeanDefinitionParser, AbstractSimpleBeanDefinitionParser, AbstractSingleBeanDefinitionParser

      public interface BeanDefinitionParser

  Interface used by the `DefaultBeanDefinitionDocumentReader` to handle custom, top-level (directly under `<beans/>`) tags.

  Implementations are free to turn the metadata in the custom tag into as many `BeanDefinitions` as required.

  The parser locates a `BeanDefinitionParser` from the associated `NamespaceHandler` for the namespace in which the custom tag resides.

  从以下版本开始:
    2.0
  作者:
    Rob Harrop
  另请参阅:
    `NamespaceHandler`, `AbstractBeanDefinitionParser`

- - ### 方法概要

    所有方法 实例方法 抽象方法
    限定符和类型 | 方法和说明
    --- | ---
    `BeanDefinition` | `parse(Element element, ParserContext parserContext)` Parse the specified `Element` and register the resulting `BeanDefinition(s)` with the `BeanDefinitionRegistry` embedded in the supplied `ParserContext`.

- - ### 方法详细资料

    - #### parse

          @Nullable
          BeanDefinition parse(Element element,
                                          ParserContext parserContext)

      Parse the specified `Element` and register the resulting `BeanDefinition(s)` with the `BeanDefinitionRegistry` embedded in the supplied `ParserContext`.

      Implementations must return the primary `BeanDefinition` that results from the parse if they will ever be used in a nested fashion (for example as an inner tag in a `<property/>` tag). Implementations may return `null` if they will not be used in a nested fashion.

      参数:
        `element` - the element that is to be parsed into one or more `BeanDefinitions`
        `parserContext` - the object encapsulating the current state of the parsing process; provides access to a `BeanDefinitionRegistry`
      返回:
        the primary `BeanDefinition`