In addition to the schema, we need a NamespaceHandler
that will parse all elements of this specific namespace Spring encounters
while parsing configuration files. The NamespaceHandler should in our case
take care of the parsing of the myns:dateformat element.
The NamespaceHandler interface is pretty simple in that
it only features three methods:
init()- allows for initialization of theNamespaceHandlerand will be called by Spring before the handler is usedBeanDefinition parse(Element element, ParserContext parserContext)- called when Spring encounters a top-level element (not nested inside a bean definition or a different namespace). This method can register bean definitions itself and/or return a bean definition.BeanDefinitionHolder decorate(Node element, BeanDefinitionHolder definition, ParserContext parserContext)- called when Spring encounters an attribute or nested element of a different namespace, inside for example the Spring namespace. The decoration of one or more bean definitions is used for example with the out-of-the-box scopes Spring 2.0 comes with (see 第 3.4 节 “bean的作用域” for more information about scopes). We'll start by highlighting a simple example, without using decoration, after which we will show decoration in a somewhat more advanced example.
Although it is perfectly possible to code your own
NamespaceHandler for the entire namespace
(and hence provide code that parses each and every element in the namespace),
it is often the case that each top-level XML element in a Spring XML
configuration file results in a single bean definition (as in our
case, where the myns:dateformat element results in a
SimpleDateFormat bean definition). Spring features a
couple of convenience classes that support this scenario. In this example,
we'll use the most often used convenience class which is the
NamespaceHandlerSupport class:
package org.springframework.samples.xml;
import org.springframework.beans.factory.xml.NamespaceHandlerSupport;
public class MyNamespaceHandler extends NamespaceHandlerSupport {
public void init() {
registerBeanDefinitionParser("dateformat",
new SimpleDateFormatBeanDefinitionParser());
}
}