XSD XML Schema Definition，即xml标签定义，在spring中，标签都是spring定义好的。
本文演示自定义XSD的过程。
一、项目结构
image.png
二、步骤如下：
2.1. 定义一个XSD文件。
在resources的META-INF下新建一个xsd文件，model.xsd
<?xml version="1.0"?>
<xsd:schema
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://xsj.example.com/schema"
targetNamespace="http://xsj.example.com/schema">
<xsd:complexType name="studentType">
<xsd:attribute name="id" type="xsd:int">
</xsd:attribute>
<xsd:attribute name="name" type="xsd:string">
</xsd:attribute>
</xsd:complexType>
<xsd:element name="student" type="studentType">
</xsd:element>
</xsd:schema>
2.2. 定义一个和XSD文件所对应的实体类。
package org.example.model;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.ToString;
@Data
@AllArgsConstructor
@NoArgsConstructor
@ToString
public class Student {
private int id;
private String name;
}
2.3. 创建实现了BeanDefinitionParser的类(其实更好的做法是继承抽象类AbstractBeanDefinitionParser)，解析自定义标签。
package org.example.spring;
import org.springframework.beans.factory.config.BeanDefinition;
import org.springframework.beans.factory.support.GenericBeanDefinition;
import org.springframework.beans.factory.xml.BeanDefinitionParser;
import org.springframework.beans.factory.xml.ParserContext;
import org.w3c.dom.Element;
public class StudentBeanDefinitionParser implements BeanDefinitionParser {
private final Class<?> beanClass;
public StudentBeanDefinitionParser(Class<?> beanClass) {
this.beanClass = beanClass;
}
@Override
public BeanDefinition parse(Element element, ParserContext parserContext) {
GenericBeanDefinition genericBeanDefinition = new GenericBeanDefinition();
genericBeanDefinition.setBeanClass(beanClass);
genericBeanDefinition.setLazyInit(false);
genericBeanDefinition.getPropertyValues().add("id", element.getAttribute("id"));
genericBeanDefinition.getPropertyValues().add("name", element.getAttribute("name"));
parserContext.getRegistry().registerBeanDefinition(beanClass.getName(),genericBeanDefinition);
return null;
}
}
2.4. 创建一个继承了NamespaceHandlerSupport的类，将我们创建的类注册到spring容器。
package org.example.spring;
import org.example.model.Student;
import org.springframework.beans.factory.xml.NamespaceHandlerSupport;
public class MyNameSpaceHandler extends NamespaceHandlerSupport {
@Override
public void init() {
registerBeanDefinitionParser("student",new StudentBeanDefinitionParser(Student.class));
}
}
2.5. 编写自己的spring.handlers和spring.schemas
在resources的META-INF下新建spring.handlers和spring.schemas文件。
-
spring.handlers
spring.handlers的key要和步骤1 model.xsd中的xmlns保持一致，反斜杠是为了转义。
value是NamespaceHandlerSupport全限定名。
image.png
http\://xsj.example.com/schema=org.example.spring.MyNameSpaceHandler
- spring.schemas
key要和步骤1 model.xsd中的xmlns保持一致，反斜杠是为了转义。
value是model.xsd的位置。
http\://xsj.example.com/schema/model.xsd=META-INF/model.xsd
三、测试验证
3.1 在resources下创建一个application-context.xml文件（名称随意）。
文件头说明：
- beans表示xml文件的根节点
- xmlns 是XML NameSpace的缩写，因为XML文件的标签名称都是自定义的，自己写的和其他人定义的标签很有可能会重复命名，而功能却不一样，所以需要加上一个namespace来区分这个xml文件和其他的xml文件，类似于java中的package。
- xmlns:xsi ——是指xml文件遵守xml规范，xsi全名：xml schema instance，是指具体用到的schema资源文件里定义的元素所准守的规范。即http://www.w3.org/2001/XMLSchema-instance这个文件里定义的元素遵守什么标准
- xsi:schemaLocation——是指本文档里的xml元素所遵守的规范，这些规范都是由官方制定的，可以进你写的网址里面看版本的变动。xsd的网址还可以帮助你判断使用的代码是否合法。
xsi:schemaLocation 前一部分是前面xmlns的值，后一部分是xsd的存放地址，构成规则是xmlns+xsd名称。
比如自定义的xmlns，http://xsj.example.com/schema 是自定义标签的namespace，spring根据xsi:schemaLocation中的路径，http://xsj.example.com/schema/model.xsd去网络上找，如果找不到，就会去本地spring.schemas中定义的映射关系找，从而找到了本地的META-INF/model.xsd文件。
<?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:xsj="http://xsj.example.com/schema"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
http://xsj.example.com/schema http://xsj.example.com/schema/model.xsd">
<xsj:student id="1" name="xushengjun"/>
</beans>
3.2 创建一个测试类
package org.example;
import org.example.model.Student;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
public class Application {
public static void main(String[] args) {
ApplicationContext ctx = new ClassPathXmlApplicationContext("classpath:application-context.xml");
Student student = ctx.getBean(Student.class);
System.out.println(student);
}
}
3.3 输出结果
Student(id=1, name=xushengjun)
Process finished with exit code 0
参考：
https://www.cnblogs.com/shamo89/p/9925538.html
https://www.cnblogs.com/myitnews/p/14018916.html
