Spring系列-XML schema扩展机制

原文地址: www.jianshu.com/p/8639e5e9f…

从Spring 2.0版本开始,Spring提供了XML Schema可扩展机制,用于定义和配置Bean。完成XML自定义扩展,需要下面几个步骤:

NamespaceHandler
BeanDefinitionParser

按照上面的步骤,实现如下可扩展XML元素:

<myns:dateformat id="dateFormat" pattern="yyyy-MM-dd HH:mm" lenient="true"/>
复制代码

等价于

<bean id="dateFormat" class="java.text.SimpleDateFormat">
    <constructor-arg value="yyyy-HH-dd HH:mm"/>
    <property name="lenient" value="true"/>
</bean>
复制代码

1.自定义 XML Schema 文件

<!-- myns.xsd (inside package org/springframework/samples/xml) -->
<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns="http://www.mycompany.com/schema/myns"
        xmlns:xsd="http://www.w3.org/2001/XMLSchema"
        xmlns:beans="http://www.springframework.org/schema/beans"
        targetNamespace="http://www.mycompany.com/schema/myns"
        elementFormDefault="qualified"
        attributeFormDefault="unqualified">

    <xsd:import namespace="http://www.springframework.org/schema/beans"/>

    <xsd:element name="dateformat">
        <xsd:complexType>
            <xsd:complexContent>
                <xsd:extension base="beans:identifiedType">
                    <xsd:attribute name="lenient" type="xsd:boolean"/>
                    <xsd:attribute name="pattern" type="xsd:string" use="required"/>
                </xsd:extension>
            </xsd:complexContent>
        </xsd:complexType>
    </xsd:element>
</xsd:schema>
复制代码

2.自定义NamespaceHandler

NamespacespaceHandler
用于解析配置文件时遇到的特定命名空间的所有元素。在我们的例子中, NamespaceHandler
应该处理 myns:dateformat
元素的解析。

NamespaceHandler
提供如下三个方法:

init()
BeanDefinition parse(Element, ParserContext)
BeanDefinition decorate(Node,BeanDefinitionHandler,ParserContext)

Spring提供了一个默认的实现类 NamespaceHandlerSupport
,我们只需要在init的时候注册每个元素的解析器即可。

public class DateformatNamespaceHandler extends NamespaceHandlerSupport { 

    public void init() { 
        registerBeanDefinitionParser("dateformat", new DeteformatDefinitionParser()); 
    }
}
复制代码

这里实际用到了代理委托的概念, NamespaceHandlerSupport
可以注册任意个 BeanDefinitionParser
NamespaceHandlerSupport
负责所有自定义元素的编排,而解析XML的工作委托给各个 BeanDefinitionParser
负责。

3.自定义BeanDefinitionParser

如果 NamespapceHandler
遇到元素类型(如: dateformat
)已经有对应注册的parser,则 DateformatDefinitionParser
会被调用,解析相应的属性设置到Bean中。BeanDefinitionParser负责解析一个顶级元素。

Spring提供了 AbstractSingleBeanDefinitionParser
来处理繁重的解析工作,只需要实现两个方法:

Class<?> getBeanClass(Element)
void doParse(Element element,BeanDefinitionBuilder builder)
ppackage org.springframework.samples.xml;

import org.springframework.beans.factory.support.BeanDefinitionBuilder;
import org.springframework.beans.factory.xml.AbstractSingleBeanDefinitionParser;
import org.springframework.util.StringUtils;
import org.w3c.dom.Element;

import java.text.SimpleDateFormat;

public class SimpleDateFormatBeanDefinitionParser extends AbstractSingleBeanDefinitionParser {

    protected Class getBeanClass(Element element) {
        return SimpleDateFormat.class;
    }

    protected void doParse(Element element, BeanDefinitionBuilder bean) {
        // this will never be null since the schema explicitly requires that a value be supplied
        String pattern = element.getAttribute("pattern");
        bean.addConstructorArg(pattern);

        // this however is an optional property
        String lenient = element.getAttribute("lenient");
        if (StringUtils.hasText(lenient)) {
            bean.addPropertyValue("lenient", Boolean.valueOf(lenient));
        }
    }

}
复制代码

4.注册handler和schema

为了让Spring在解析xml的时候能够感知到我们的自定义元素,我们需要把 NamespaceHandler
xsd文件
放到2个指定的配置文件中,这2个文件都位于 META-INF
目录

  • 'META-INF/spring.handlers'
    :包含XML Schema URI到命名空间处理程序类的映射。因此,对于我们的示例,我们需要编写以下内容:

    http/://www.mycompany.com/schema/myns=org.springframework.samples.xml.DateformatNamespaceHandler
    复制代码
  • META-INF/spring.schemas
    :包含XML Schema xsd到类路径资源的映射。

    http/://www.mycompany.com/schema/myns/myns.xsd=org/springframework/samples/xml/myns.xsd
    复制代码

5.在Spring XML配置中使用自定义扩展

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:myns="http://www.mycompany.com/schema/myns"
    xsi:schemaLocation="
        http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.mycompany.com/schema/myns http://www.mycompany.com/schema/myns/myns.xsd">

    <!-- as a top-level bean -->
    <myns:dateformat id="defaultDateFormat" pattern="yyyy-MM-dd HH:mm" lenient="true"/>

    <bean id="jobDetailTemplate" abstract="true">
        <property name="dateFormat">
            <!-- as an inner bean -->
            <myns:dateformat pattern="HH:mm MM-dd-yyyy"/>
        </property>
    </bean>

</beans>
复制代码

原文 

https://juejin.im/post/5cb1ef136fb9a0689b6ed691

本站部分文章源于互联网,本着传播知识、有益学习和研究的目的进行的转载,为网友免费提供。如有著作权人或出版方提出异议,本站将立即删除。如果您对文章转载有任何疑问请告之我们,以便我们及时纠正。

PS:推荐一个微信公众号: askHarries 或者qq群:474807195,里面会分享一些资深架构师录制的视频录像:有Spring,MyBatis,Netty源码分析,高并发、高性能、分布式、微服务架构的原理,JVM性能优化这些成为架构师必备的知识体系。还能领取免费的学习资源,目前受益良多

转载请注明原文出处:Harries Blog™ » Spring系列-XML schema扩展机制

赞 (0)
分享到:更多 ()

评论 0

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址