Dubbo.xml配置源-Dubbo.xsd分析

 

我们使用Dubbo时,一般都会使用xml配置基本信息,如项目名称(application)、注册中心(register)、协议(protocal)、服务(service),如下所示:

1
2
3
4
5
6
7
<dubbo:application name="demo-provider" owner="programmer" organization="dubbox"/>
 
<dubbo:registry address="zookeeper://127.0.0.1:2181"/>
 
<dubbo:protocol name="dubbo" serialization="kryo" optimizer="com.alibaba.dubbo.demo.SerializationOptimizerImpl"/>
 
<dubbo:service interface="com.alibaba.dubbo.demo.bid.BidService" ref="bidService" protocol="dubbo"/>

可是大家这些xml节点都是从哪里来的,为什么dubbo启动时可以识别,为什么输入有提示,下面首先为大家介绍一下xml节点从哪里来,为什么可以自动提示?下一篇再介绍怎样处理xml内容。

一、从哪里来?

首先看xml的beans根目录的URL:http://code.alibabatech.com/schema/dubbo

1
2
3
4
5
6
7
8
9
10
<?xml version="1.0" encoding="UTF-8"?>
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:dubbo="http://code.alibabatech.com/schema/dubbo"
       xsi:schemaLocation="

为什么引入这个dubbo的url,在xml文件中就可以自动提示相应的节点信息,我们首先看dubbo源码中的和两个文件:

1、repository\com\alibaba\dubbo\2.5.3\dubbo-2.5.3\META-INF\spring.handlers

图中的代码说明了url对应的处理类

Dubbo.xml配置源-Dubbo.xsd分析

2、repository\com\alibaba\dubbo\2.5.3\dubbo-2.5.3\META-INF\spring.schemas

图中的代码说明了url对应的xsd文件

Dubbo.xml配置源-Dubbo.xsd分析

二、Dubbo.xsd的组成

第一步中解释了xml元素的来源,下一步通过分析dubbo.xsd文件解释xml元素、属性及自动提示。

dubbo.xsd主要包含以下4个类型的元素:

1、xsd:import:引入其它标签库,dubbo.xsd中还需要其它的xsd,处理方式和dubbo.xsd相同

1
2
3
<xsd:import namespace="http://www.w3.org/XML/1998/namespace"/>
<xsd:import namespace="http://www.springframework.org/schema/tool"/>

2、xsd:annotation:xsd文件描述

1
2
3
<xsd:annotation>
        <xsd:documentation><![CDATA[ Namespace support for the dubbo services provided by dubbo framework. ]]></xsd:documentation>
    </xsd:annotation>

3、xsd:complexType name="abstractMethodType:abstract开头的complextType:作为其它complexType类型的基类,提取共同的属性配置

这个抽象complexType只列出了前面两个参数:timeout、retries

1
2
3
4
5
6
7
8
9
10
11
<xsd:complexType name="abstractMethodType">
        <xsd:attribute name="timeout" type="xsd:string" use="optional" default="0">
            <xsd:annotation>
                <xsd:documentation><![CDATA[ The method invoke timeout. ]]></xsd:documentation>
            </xsd:annotation>
        </xsd:attribute>
        <xsd:attribute name="retries" type="xsd:string" use="optional">
            <xsd:annotation>
                <xsd:documentation><![CDATA[ The method retry times. ]]></xsd:documentation>
            </xsd:annotation>
        </xsd:attribute>

4、xsd:element name="service" type="serviceType:某个节点的配置,这里以service节点为例,type属性指向了具体的类型
type属性值说明具体的元素时serviceType

1
2
3
4
5
<xsd:element name="service" type="serviceType">
        <xsd:annotation>
            <xsd:documentation><![CDATA[ Export service config ]]></xsd:documentation>
        </xsd:annotation>
    </xsd:element>

5、xsd:complexType name="serviceType":某个节点的具体属性,第4步中type属性指向的节点,其中base属性指向集成的complexType

具体的complexType(部分),包括子元素method、parameter,基类元素abstractServiceType

1
2
3
4
5
6
7
8
<xsd:complexType name="serviceType"
        <xsd:complexContent>
            <xsd:extension base="abstractServiceType">
                <xsd:choice minOccurs="0" maxOccurs="unbounded">
                    <xsd:element ref="method" minOccurs="0" maxOccurs="unbounded" />
                    <xsd:element ref="parameter" minOccurs="0" maxOccurs="unbounded" />
                    <xsd:element ref="beans:property" minOccurs="0" maxOccurs="unbounded" />
                </xsd:choice>

三、dubbo.xml配置文件和dubbo.xsd的关系
1、示例一:protocol

1
2
<dubbo:protocolname="dubbo"port="-1"dispatcher="all"threadpool="fixed"threads="100"/>

对应的dubbo.xsd节点

Dubbo.xml配置源-Dubbo.xsd分析

2、示例二

1
2
3
<dubbo:service interface="org.gossip.dub.facade.ISeckillService" ref="seckillService" retries="0">
    <dubbo:method name="a1"></dubbo:method>
</dubbo:service>

Dubbo.xml配置源-Dubbo.xsd分析

上一篇:Mybatis(spring)(多个参数)(插入数据返回id)


下一篇:使用SQLServer2005插入一条数据时返回当前插入数据的ID