Dubbo框架内自定义很多XML标签，方便以XML方式注册服务；本篇文章先了解下Dubbo框架拥有哪些XML标签，然后给出自定义标签的流程并动手自定义标签。
1.Dubbo框架中的那些标签
Dubbo框架标签定义的源文件是dubbo.xsd，该文件位于dubbo.jar内/META-INF/目录下；源文件内容太多就不一一列出来，不过从dubbo.xsd得知Dubbo拥有以下15个标签：annotation，application，module，registry，metadata-report，config-center，monitor，protocol，service，provider，consumer，reference，method，argument，parameters，每个标签都定义好各自的元素，元素几乎与各标签对应的实体类的属性相对应。
下面是使用dubbo自定义标签的一个例子。
为了后面更好的学习Dubbo框架定义标签的使用和解析，我们有必要了解标签自定义的过程。
2.自定义标签的流程
- 定义标签实体类和.xsd文件
- 声明标签的命名空间及其处理类
- 声明标签的解析逻辑
- 编写测试类
3.动手自定义标签
3.1 定义标签实体类和.xsd文件
标签实体类Person：
public class Person {
private String name;
private String age;
private int sex;
private boolean flag;
// 省略set get方法，toString方法
}
定义person.xsd文件
<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema
xmlns="http://www.starry.net/schema/person"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:beans="http://www.springframework.org/schema/beans"
targetNamespace="http://www.starry.net/schema/person"
elementFormDefault="qualified"
attributeFormDefault="unqualified">
<xsd:import namespace="http://www.springframework.org/schema/beans" />
<!-- 定义element名, personType对应了bean的属性 -->
<xsd:element name="person" type="personType">
<xsd:annotation>
<xsd:documentation><![CDATA[ The person config ]]></xsd:documentation>
</xsd:annotation>
</xsd:element>
<!-- 配置各属性值，有点像Mybatis配置对应的model -->
<xsd:complexType name="personType">
<xsd:attribute name="id" type="xsd:ID">
<xsd:annotation>
<xsd:documentation><![CDATA[ The unique identifier for a bean. ]]></xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="name" type="xsd:string" use="required">
<xsd:annotation>
<xsd:documentation><![CDATA[ The person name. ]]></xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="age" type="xsd:string">
<xsd:annotation>
<xsd:documentation><![CDATA[ The person age. ]]></xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="sex" type="xsd:string">
<xsd:annotation>
<xsd:documentation><![CDATA[ The person sex. ]]></xsd:documentation>
</xsd:annotation>
</xsd:attribute>
<xsd:attribute name="flag" type="xsd:string">
<xsd:annotation>
<xsd:documentation><![CDATA[ The person flag. ]]></xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:complexType>
</xsd:schema>
person.xsd文件中的标签元数据对应Person.class类中的属性；.xsd文件中element的name值就是xml文件中使用的标签名，attribute的name值则是标签对应的属性元素。注意attribute的type值，不需要与实体类中属性的类型一致，统一写成string类型。
person.xsd文件放置在/resources目录下。
3.2 声明标签的命名空间及其处理类
person.xsd文件既然定义好了，那么如何使用呢？在xml文件头部通过自定义命名空间（xml name space）指定.xsd文件的schemasLocation，由该schemasLocation指定.xsd文件的位置。spring约定命名空间地址写在/META-INF/spring.handlers文件内，并且指定该命名空间的处理类，即此处的PersonNamespaceHandler.class。
http\://www.starry.net/schema/person=com.starry.bean.handler.PersonNameSpaceHandler
等号左边是自定义的命名空间地址，可以随便定义；等号右边是自定义命名空间处理类的类路径名。
编写自定义命名空间处理类PersonNamespaceHandlers.class
package com.starry.bean.handler;
import com.starry.bean.parse.PersonBeanDefinitionParser;
import com.starry.custom.label.Person;
import org.springframework.beans.factory.xml.NamespaceHandlerSupport;
public class PersonNameSpaceHandler extends NamespaceHandlerSupport {
@Override
public void init() {
registerBeanDefinitionParser("person", new PersonBeanDefinitionParser(Person.class, true));
}
}
命名空间指定.xsd文件的schemasLocation，一般都是配套写在xml文件的头部(命名空间地址和schemasLocation之间用空格或者换行隔开)；spring约定schemaLocation写在/META-INF/ spring.schemas文件内，由schemationLocation地址指定person.xsd文件的位置。
http\://www.starry.net/schema/person/person.xsd=person.xsd
等号左边是约定的schemasLocation地址，它需要与上面定义的命名空间地址一致；等号右边则是person.xsd在项目中的位置，如果放置在/META-INF目录下，则需要指定目录为“/META-INF/person.xsd”。
3.3 声明标签的解析逻辑
在命名空间处理类PersonNamespaceHandler中有一个名为PersonBeanDefinitionParser类，该类是解析xml文件person标签的逻辑。
package com.starry.bean.parse;
import com.starry.custom.label.Person;
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 PersonBeanDefinitionParser extends AbstractSingleBeanDefinitionParser {
private final Class<?> beanClass;
private final boolean required;
public PersonBeanDefinitionParser(Class<?> beanClass, boolean required) {
this.beanClass = beanClass;
this.required = required;
}
protected Class getBeanClass(Element element) {
return Person.class;
}
protected void doParse(Element element, BeanDefinitionBuilder builder) {
String name = element.getAttribute("name");
String age = element.getAttribute("age");
String sex = element.getAttribute("sex");
String flag = element.getAttribute("flag");
if (StringUtils.hasText(name)) {
builder.addPropertyValue("name", name);
}
if (StringUtils.hasText(age)) {
builder.addPropertyValue("age", age);
}
if (StringUtils.hasText(sex)) {
builder.addPropertyValue("sex", Integer.valueOf(sex));
}
if (StringUtils.hasText(flag)) {
builder.addPropertyValue("flag", Boolean.valueOf(flag));
}
}
}
继承AbstractSingleBeanDefinitionParser类，重写doParse(Element,BeanDefinitionBuilder)方法，定义简单的解析逻辑。
3.4 编写测试类
新建person.xml文件，引入perosn命名空间以及schemasLocation；然后声明一个person标签的对象。
<?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:test="http://www.starry.net/schema/person"
xsi:schemaLocation="
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.2.xsd
http://www.starry.net/schema/person
http://www.starry.net/schema/person/person.xsd">
<test:person id="a" name="xiaoMing" age="25" sex="1" flag="true" />
</beans>
xmlns:test="http://www.starry.net/schema/person"表示在person.xml文件内用test指定为person命名空间地址的简称，所以就有了test:perosn。person是person.xsd文件内定义的element名称，也是PersonNamespaceHandler.class处理person命名空间的依据。
注意：id属性是每个标签都有的，可以声明也可以省略。
编写test类，获取容器中person对象并打印出来。
package com.starry;
import com.starry.custom.label.Person;
import org.springframework.context.support.ClassPathXmlApplicationContext;
public class test {
public static void main(String[] args) {
ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("person.xml");
Person person = context.getBean(Person.class);
System.out.println(person.toString());
}
}
执行结果表明person.xml文件内test:person标签的内容已经被初始化为容器内的bean，所以自定义标签person成功。
4.思考
早在第二小节就给出了自定义标签的具体步骤，也是为了帮助不熟悉自定义标签的读者更好的理解这个过程；在第三节的演示过程中，详细说明每个步骤的作用和含义，虽然最终实践成功，但是你可能好奇PersonNamespaceHandler和PersonDefinitionParser类在自定义标签解析的过程中是如何执行的，或者说什么时候被执行的。
要想理解上面的问题，就必须深入ClassPathXmlApplicationContext类的初始化过程，这个过程我们在剖析Dubbo自定义标签解析流程中会深入分析，这里我们对自定义标签的流程有一个认识就OK了。
