# 10.2.2. 编码一个NamespaceHandler

除了模式之外，我们还需要`NamespaceHandler`解析 Spring 在解析配置文件时遇到的这个特定命名空间的所有元素。对于这个例子， `NamespaceHandler`应该负责`myns:dateformat` 元素的解析。

`NamespaceHandler`接口具有三种方法：

* `init()`: 允许初始化 `NamespaceHandler` 并在使用处理程序之前由 Spring 调用。
* `BeanDefinition parse(Element, ParserContext)`：当 Spring 遇到顶级元素（未嵌套在 bean 定义或不同的命名空间内）时调用。此方法本身可以注册 bean 定义、返回 bean 定义或两者兼而有之。
* `BeanDefinitionHolder decorate(Node, BeanDefinitionHolder, ParserContext)`：当 Spring 遇到不同命名空间的属性或嵌套元素时调用。一个或多个 bean 定义的装饰（例如）与 [Spring 支持的范围](https://docs.spring.io/spring-framework/docs/current/reference/html/core.html#beans-factory-scopes)一起使用。我们首先突出一个简单的例子，不使用装饰，然后我们在一个更高级的例子中展示装饰。

尽管您可以为整个命名空间编写自己的`NamespaceHandler`代码（并因此提供解析命名空间中每个元素的代码），但通常情况下，Spring XML 配置文件中的每个顶级 XML 元素都会导致单个 bean 定义（在我们的例子中，单个`<myns:dateformat/>` 元素导致单个`SimpleDateFormat`bean 定义）。Spring 提供了许多支持这种场景的便利类。在以下示例中，我们使用`NamespaceHandlerSupport`该类：

```java
package org.springframework.samples.xml;

import org.springframework.beans.factory.xml.NamespaceHandlerSupport;

public class MyNamespaceHandler extends NamespaceHandlerSupport {

    public void init() {
        registerBeanDefinitionParser("dateformat", new SimpleDateFormatBeanDefinitionParser());
    }
}
```

您可能会注意到，此类中实际上并没有很多解析逻辑。事实上，`NamespaceHandlerSupport` 类有一个内置的委托概念。它支持注册任意数量的`BeanDefinitionParser`实例，当需要解析其名称空间中的元素时，它会委托给这些实例。这种干净的关注点分离让 `NamespaceHandler` 能够处理其命名空间中所有自定义元素的解析编排，同时委托 `BeanDefinitionParsers` 来完成 XML 解析的繁重工作。这意味着每个`BeanDefinitionParser`仅包含解析单个自定义元素的逻辑，正如我们在下一步中看到的那样。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.shiker.tech/spring-he-xin-gong-neng/10.-fu-lu/10.2.-zi-ding-yi-xml-schema/10.2.2.-bian-ma-yi-ge-namespacehandler.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.