完成一个自定义配置一般需要以下步骤:
1)设计配置属性和JavaBean
2)编写XSD文件
3)编写NamespaceHandler和BeanDefinitionParser完成解析工作
4)编写spring.handlers和spring.schemas串联起所有文件
5)应用
下面写一个实例来完成以上的步骤:
1)建一个JavaBean
public class Customer { private String id; /** 客户名称 */ private String custName; /** 联系电话 */ private String contactPhone; /** 联系邮箱 */ private String email; }
2)编写XSD文件
为上一步的JavaBean编写XSD文件,XSD是schema的定义文件,配置的输入和解析输出都是以XSD为契约。
<?xml version="1.0" encoding="UTF-8"?> <xsd:schema xmlns="http://jishuaige.iteye.com/admin/blogs/schema/customer" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:beans="http://www.springframework.org/schema/beans" targetNamespace="http://jishuaige.iteye.com/admin/blogs/schema/customer" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xsd:import namespace="http://www.springframework.org/schema/beans" /> <xsd:element name="customer"> <xsd:complexType> <xsd:complexContent> <xsd:extension base="beans:identifiedType"> <xsd:attribute name="custName" type="xsd:string" /> <xsd:attribute name="contactPhone" type="xsd:string" /> <xsd:attribute name="email" type="xsd:string" /> </xsd:extension> </xsd:complexContent> </xsd:complexType> </xsd:element> </xsd:schema>
关于xsd:schema的各个属性具体含义可以参考:http://www.w3school.com.cn/schema
<xsd:element name="customer">配置项节点的名称,在应用中会使用这个名字来引用配置。
<xsd:attribute/>配置bean的属性和类型
完成XSD文件后,把xsd存放在classpath下,一般都放在META-INF目录下。
3)编写NamespaceHandler和BeanDefinitionParser完成解析工作
NamespaceHandler:会根据XSD文件中的节点名称找到自己制定的BeanDefinitionParser,然后由BeanDefinitionParser完成具体的解析工作。spring提供了这个2个类的默认实现类:NamespaceHandlerSupport和AbstractSingleBeanDefinitionParser,最简单的就是直接继承这2个类。
import org.springframework.beans.factory.xml.NamespaceHandlerSupport; public class CustomerNamespaceHandlerSupport extends NamespaceHandlerSupport { @Override public void init() { registerBeanDefinitionParser("customer", new CustomerBeanDefinitionParser()); } }
registerBeanDefinitionParser("customer", new CustomerBeanDefinitionParser());方法就是把节点名称customer和解析类联系起来。配置项中的customer使用CustomerBeanDefinitionParser类解析配置。
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 CustomerBeanDefinitionParser extends AbstractSingleBeanDefinitionParser { @Override protected void doParse(Element element, BeanDefinitionBuilder builder) { String custName = element.getAttribute("custName"); String contactPhone = element.getAttribute("contactPhone"); String email = element.getAttribute("email"); String id = element.getAttribute("id"); if (StringUtils.hasText(id)) { builder.addPropertyValue("id", id); } if (StringUtils.hasText(custName)) { builder.addPropertyValue("custName", custName); } if (StringUtils.hasText(contactPhone)) { builder.addPropertyValue("contactPhone", contactPhone); } if (StringUtils.hasText(email)) { builder.addPropertyValue("email", email); } } @Override protected Class<?> getBeanClass(Element element) { return Customer.class; } }
element.getAttribute:获取配置文件中的值,bean.addPropertyValue:把属性值放到bean中。
4)编写spring.handlers和spring.schemas串联起所有文件
Javabean,XSD文件,解析类都准备好了。现在是应该把他们串起来了。让他们能够协调工作。
spring提供了两个配置文件来完成串起来的工作,这两个文件的地址必须是META-INF/spring.handlers和META-INF/spring.schemas,spring会默认去载入它们。
spring.handlers:
http\://jishuaige.iteye.com/admin/blogs/schema/customer=com.jishuaige.schema.CustomerNamespaceHandlerSupport
当使用到名为"http\://jishuaige.iteye.com/admin/blogs/schema/customer"的schema引用时,会通过com.jishuaige.schema.CustomerNamespaceHandlerSupport来完成解析
spring.schemas:
http\://jishuaige.iteye.com/admin/blogs/schema/customer.xsd=META-INF/customer.xsd
5)应用
现在简单的配置已经完成了,现在就应该应用到具体的实例中了。下面来配置一个spring bean,要基于我们自己的schema(模式文档)。以下是配置文件:
<?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:customer="http://jishuaige.iteye.com/admin/blogs/schema/customer" xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd http://jishuaige.iteye.com/admin/blogs/schema/customer http://jishuaige.iteye.com/admin/blogs/schema/customer.xsd"> <customer:customer id="001" custName="jishuaige" contactPhone="13600000000" email="[email protected]"/> </beans>
xmlns:customer="http://jishuaige.iteye.com/admin/blogs/schema/customer"指定我们自定义的schema。xsi:schemaLocation指定xsd文件。
<customer:customer/>配置使用的实例。
下面我们来使用我们定义的这个BEAN:
ApplicationContext ctx = new ClassPathXmlApplicationContext("application.xml"); Customer customer = (Customer) ctx.getBean("001");
上面就是我对于spring可扩展schema的提供自定义配置支持的一些理解和具体的操作。后面就在dubbo中看看实际的应用了。