站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > Spring Framework 2.0.5 API 文档英文版

NamespaceHandlerSupport (Spring Framework API 2.0) - Spring Framework 2.0.5 API 文档英文版

The Spring Framework

org.springframework.beans.factory.xml
Class NamespaceHandlerSupport

java.lang.Object
  extended by org.springframework.beans.factory.xml.NamespaceHandlerSupport
All Implemented Interfaces:
NamespaceHandler
Direct Known Subclasses:
AopNamespaceHandler, JeeNamespaceHandler, LangNamespaceHandler, TxNamespaceHandler, UtilNamespaceHandler

public abstract class NamespaceHandlerSupport
extends Object
implements NamespaceHandler

Support class for implementing custom NamespaceHandlers. Parsing and decorating of individual Nodes is done via BeanDefinitionParser and BeanDefinitionDecorator strategy interfaces respectively. Provides the registerBeanDefinitionParser(java.lang.String, org.springframework.beans.factory.xml.BeanDefinitionParser), registerBeanDefinitionDecorator(java.lang.String, org.springframework.beans.factory.xml.BeanDefinitionDecorator) methods for registering a BeanDefinitionParser or BeanDefinitionDecorator to handle a specific element.

Since:
2.0
Author:
Rob Harrop, Juergen Hoeller
See Also:
registerBeanDefinitionParser(String, BeanDefinitionParser), registerBeanDefinitionDecorator(String, BeanDefinitionDecorator)

Constructor Summary
NamespaceHandlerSupport()
           
 
Method Summary
 BeanDefinitionHolder decorate(Node node, BeanDefinitionHolder definition, ParserContext parserContext)
          Decorates the supplied Node by delegating to the BeanDefinitionDecorator that is registered to handle that Node.
protected  BeanDefinitionDecorator findDecoratorForNode(Node node)
          Deprecated. as of Spring 2.0.2; there should be no need to call this directly.
protected  BeanDefinitionParser findParserForElement(Element element)
          Deprecated. as of Spring 2.0.2; there should be no need to call this directly.
 BeanDefinition parse(Element element, ParserContext parserContext)
          Parses the supplied Element by delegating to the BeanDefinitionParser that is registered for that Element.
protected  void registerBeanDefinitionDecorator(String elementName, BeanDefinitionDecorator decorator)
          Subclasses can call this to register the supplied BeanDefinitionDecorator to handle the specified element.
protected  void registerBeanDefinitionDecoratorForAttribute(String attributeName, BeanDefinitionDecorator decorator)
          Subclasses can call this to register the supplied BeanDefinitionDecorator to handle the specified attribute.
protected  void registerBeanDefinitionParser(String elementName, BeanDefinitionParser parser)
          Subclasses can call this to register the supplied BeanDefinitionParser to handle the specified element.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface org.springframework.beans.factory.xml.NamespaceHandler
init
 

Constructor Detail

NamespaceHandlerSupport

public NamespaceHandlerSupport()
Method Detail

parse

public final BeanDefinition parse(Element element,
                                  ParserContext parserContext)
Parses the supplied Element by delegating to the BeanDefinitionParser that is registered for that Element.

Specified by:
parse in interface NamespaceHandler
Parameters:
element - the element that is to be parsed into one or more BeanDefinitions
parserContext - the object encapsulating the current state of the parsing process
Returns:
the primary BeanDefinition (can be null as explained above)

findParserForElement

protected final BeanDefinitionParser findParserForElement(Element element)
Deprecated. as of Spring 2.0.2; there should be no need to call this directly.

Locate the BeanDefinitionParser from the register implementations using the local name of the supplied Element.


decorate

public final BeanDefinitionHolder decorate(Node node,
                                           BeanDefinitionHolder definition,
                                           ParserContext parserContext)
Decorates the supplied Node by delegating to the BeanDefinitionDecorator that is registered to handle that Node.

Specified by:
decorate in interface NamespaceHandler
Parameters:
node - the source element or attribute that is to be parsed
definition - the current bean definition
parserContext - the object encapsulating the current state of the parsing process
Returns:
the decorated definition (to be registered in the BeanFactory), or simply the original bean definition if no decoration is required. A null value is strictly speaking invalid, but will be leniently treated like the case where the original bean definition gets returned.

findDecoratorForNode

protected final BeanDefinitionDecorator findDecoratorForNode(Node node)
Deprecated. as of Spring 2.0.2; there should be no need to call this directly.

Locate the BeanDefinitionParser from the register implementations using the local name of the supplied Node. Supports both Elements and Attrs.


registerBeanDefinitionParser

protected final void registerBeanDefinitionParser(String elementName,
                                                  BeanDefinitionParser parser)
Subclasses can call this to register the supplied BeanDefinitionParser to handle the specified element. The element name is the local (non-namespace qualified) name.


registerBeanDefinitionDecorator

protected final void registerBeanDefinitionDecorator(String elementName,
                                                     BeanDefinitionDecorator decorator)
Subclasses can call this to register the supplied BeanDefinitionDecorator to handle the specified element. The element name is the local (non-namespace qualified) name.


registerBeanDefinitionDecoratorForAttribute

protected final void registerBeanDefinitionDecoratorForAttribute(String attributeName,
                                                                 BeanDefinitionDecorator decorator)
Subclasses can call this to register the supplied BeanDefinitionDecorator to handle the specified attribute. The attribute name is the local (non-namespace qualified) name.


The Spring Framework

Copyright © 2002-2007 The Spring Framework.