MySQL 自定义Spring XSD

XSD XML Schema Definition，即xml标签定义，在spring中，标签都是spring定义好的。 本文演示自定义XSD的过程。

一、项目结构

二、步骤如下：

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全限定名。

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文件（名称随意）。 文件头说明：

1. beans表示xml文件的根节点

2. xmlns 是XML NameSpace的缩写，因为XML文件的标签名称都是自定义的，自己写的和其他人定义的标签很有可能会重复命名，而功能却不一样，所以需要加上一个namespace来区分这个xml文件和其他的xml文件，类似于java中的package。

3. xmlns:xsi ——是指xml文件遵守xml规范，xsi全名：xml schema instance，是指具体用到的schema资源文件里定义的元素所遵守的规范。即http://www.w3.org/2001/XMLSchema-instance这个文件里定义的元素遵守什么标准

4. xsi:schemaLocation——是指本文档里的xml元素所遵守的规范，这些规范都是由官方制定的，可以进你写的网址里面看版本的变动。xsd的网址还可以帮助你判断使用的代码是否合法。 xsi:schemaLocation 前一部分是前面xmlns的值，后一部分是xsd的存放地址，构成规则是xmlns+xsd名称。

5. 比如自定义的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