Spring的自定义扩展标签NamespaceHandler解析
自定义扩展标签NamespaceHandler
在很多情况下，我们需要为系统提供可配置化支持，简单的做法可以直接基于Spring的标准Bean来配置，但配置较为复杂或者需要更多丰富控制的时候，会显得非常笨拙。一般的做法会用原生态的方式去解析定义好的xml文件，然后转化为配置对象，这种方式当然可以解决所有问题，但实现起来比较繁琐，特别是是在配置非常复杂的时候，解析工作是一个不得不考虑的负担。Spring提供了可扩展Schema的支持，这是一个不错的折中方案，完成一个自定义
配置一般需要以下步骤：
[1] 设计配置属性和JavaBean
[2] 编写XSD文件
[3] 编写NamespaceHandler和BeanDefinitionParser完成解析工作
[4] 编写spring.handlers和spring.schemas串联起所有部件
[5] 在Bean文件中应用 下面结合一个小例子来实战以上过程
1）设计配置属性和JavaBean
首先当然得设计好配置项，并通过JavaBean来建模，本例中需要配置People实体，配置属性name和age（id是默认需要的）
public class People {
private String id;
private String name;
private Integer age;
} 2）编写XSD文件
为上一步设计好的配置项编写XSD文件，XSD是schema的定义文件，配置的输入和解析输出都是以XSD为契约，本例中XSD如下：
<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema
xmlns="http://blog.csdn.net/cutesource/schema/people"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:beans="http://www.springframework.org/schema/beans"
targetNamespace="http://blog.csdn.net/cutesource/schema/people"
elementFormDefault="qualified"
attributeFormDefault="unqualified">
<xsd:import namespace="http://www.springframework.org/schema/beans" />
<xsd:element name="people">
<xsd:complexType>
<xsd:complexContent>
<xsd:extension base="beans:identifiedType">
<xsd:attribute name="name" type="xsd:string" />
<xsd:attribute name="age" type="xsd:int" />
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
</xsd:element>
</xsd:schema> 关于xsd:schema的各个属性具体含义就不作过多解释，可以参见//www.w3school.com.cn/schema/schema_schema.asp
<xsd:element name=“people”>对应着配置项节点的名称，因此在应用中会用people作为节点名来引用这个配置
<xsd:attribute name=“name” type=“xsd:string” />和<xsd:attribute name=“age” type=“xsd:int” />对应着配置项people的两个属性名，因此在应用中可以配置name和age两个属性，分别是string和int类型
完成后需把xsd存放在classpath下，一般都放在META-INF目录下（本例就放在这个目录下）
3）编写NamespaceHandler和BeanDefinitionParser完成解析工作
下面需要完成解析工作，会用到NamespaceHandler和BeanDefinitionParser这两个概念。具体说来 NamespaceHandler会根据schema和节点名找到某个BeanDefinitionParser，然后由 BeanDefinitionParser完成具体的解析工作。因此需要分别完成NamespaceHandler和 BeanDefinitionParser的实现类，Spring提供了默认实现类NamespaceHandlerSupport和 AbstractSingleBeanDefinitionParser，简单的方式就是去继承这两个类。本例就是采取这种方式：
import org.springframework.beans.factory.xml.NamespaceHandlerSupport;
public class MyNamespaceHandler extends NamespaceHandlerSupport {
public void init() {
registerBeanDefinitionParser("people", new PeopleBeanDefinitionParser());
}
} 其中registerBeanDefinitionParser(“people”, new PeopleBeanDefinitionParser());就是用来把节点名和解析类联系起来，在配置中引用people配置项时，就会用 PeopleBeanDefinitionParser来解析配置。PeopleBeanDefinitionParser就是本例中的解析类：
import org.springframework.beans.factory.support.BeanDefinitionBuilder;
import org.springframework.beans.factory.xml.AbstractSingleBeanDefinitionParser;
import org.springframework.util.StringUtils;
import org.w3c.dom.Element;
public class PeopleBeanDefinitionParser extends AbstractSingleBeanDefinitionParser {
protected Class getBeanClass(Element element) {
return People.class;
}
protected void doParse(Element element, BeanDefinitionBuilder bean) {
String name = element.getAttribute("name");
String age = element.getAttribute("age");
String id = element.getAttribute("id");
if (StringUtils.hasText(id)) {
bean.addPropertyValue("id", id);
}
if (StringUtils.hasText(name)) {
bean.addPropertyValue("name", name);
}
if (StringUtils.hasText(age)) {
bean.addPropertyValue("age", Integer.valueOf(age));
}
}
} 其中element.getAttribute就是用配置中取得属性值，bean.addPropertyValue就是把属性值放到bean中。
4）编写spring.handlers和spring.schemas串联起所有部件
上面几个步骤走下来会发现开发好的handler与xsd还没法让应用感知到，就这样放上去是没法把前面做的工作纳入体系中的，spring提供了 spring.handlers和spring.schemas这两个配置文件来完成这项工作，这两个文件需要我们自己编写并放入META-INF文件夹 中，这两个文件的地址必须是META-INF/spring.handlers和META-INF/spring.schemas，spring会默认去 载入它们，本例中spring.handlers如下所示：
//blog.csdn.net/cutesource/schema/people=study.schemaExt.MyNamespaceHandler 以上表示当使用到名为"//blog.csdn.net/cutesource/schema/people"的schema引用时，会通过study.schemaExt.MyNamespaceHandler来完成解析
spring.schemas如下所示：
//blog.csdn.net/cutesource/schema/people.xsd=META-INF/people.xsd 以上就是载入xsd文件
5）在Bean文件中应用
到此为止一个简单的自定义配置以完成，可以在具体应用中使用了。使用方法很简单，和配置一个普通的spring bean类似，只不过需要基于我们自定义schema，本例中引用方式如下所示：
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:cutesource="http://blog.csdn.net/cutesource/schema/people"
xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
http://blog.csdn.net/cutesource/schema/people http://blog.csdn.net/cutesource/schema/people.xsd">
<cutesource:people id="test" name="test" age="1"/>
</beans> 其中xmlns:cutesource=“//blog.csdn.net/cutesource/schema/people” 是用来指定自定义schema，xsi:schemaLocation用来指定xsd文件。<cutesource:people id=“cutesource” name=“zhijun.yuanzj” age=“27”/>是一个具体的自定义配置使用实例。
最后就可以在具体程序中使用基本的bean载入方式来载入我们的自定义配置对象了，如：
ApplicationContext ctx = new ClassPathXmlApplicationContext("application.xml");
People p = (People)ctx.getBean("cutesource");
System.out.println(p.getId());
System.out.println(p.getName());
System.out.println(p.getAge()); 会输出：
test test 1
到此这篇关于Spring的自定义扩展标签NamespaceHandler解析的文章就介绍到这了,更多相关自定义扩展标签NamespaceHandler内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
这篇文章主要介绍了SpringBoot中使用多线程的方法示例，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2021-03-03
这篇文章主要介绍了深入理解java泛型Generic,文中有非常详细的代码示例,对正在学习java的小伙伴们有非常好的帮助,需要的朋友可以参考下,希望对你有帮助2021-07-07
@Bean注解和@Configuration、@Component注解组合使用的区别
这篇文章主要介绍了@Bean注解和@Configuration、@Component注解组合使用的区别，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2021-11-11
本文主要介绍了java实现求只出现一次的数字，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2023-02-02
这篇文章主要介绍了Java中的HashTable的相关资料，帮助大家更好的理解和使用Java，感兴趣的朋友可以了解下2020-12-12
这篇文章主要介绍了java日期相关类实例详解，小编觉得还是挺不错的，这里分享给大家，供需要的朋友参考。2017-10-10
这篇文章主要介绍了Java数据结构中的栈与队列,在Java的时候，对于栈与队列的应用需要熟练的掌握，这样才能够确保Java学习时候能够有扎实的基础能力。本文小编就来详细说说Java中的栈与队列,需要的朋友可以参考一下2022-01-01
这篇文章主要为大家详细介绍了Spring配置事务的五种方式，感兴趣的小伙伴们可以参考一下2016-06-06
这篇文章主要为大家详细介绍了JavaSe的内部类，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下，希望能够给你带来帮助2022-03-03
这篇文章主要介绍了java中Date和Timestamp类型的相互转换方式，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2023-07-07
最新评论