dubbo中标签的使用

总览

<dubbo:service/> 服务配置，用于暴露一个服务，定义服务的元信息，一个服务可以用多个协议暴露，一个服务也可以注册到多个注册中心。
<dubbo:reference/> 引用配置，用于创建一个远程服务代理，一个引用可以指向多个注册中心。
<dubbo:protocol/> 协议配置，用于配置提供服务的协议信息，协议由提供方指定，消费方被动接受。
<dubbo:application/> 应用配置，用于配置当前应用信息，不管该应用是提供者还是消费者。
<dubbo:module/> 模块配置，用于配置当前模块信息，可选。
<dubbo:registry/> 注册中心配置，用于配置连接注册中心相关信息。
<dubbo:monitor/> 监控中心配置，用于配置连接监控中心相关信息，可选。
<dubbo:provider/> 提供方的缺省值，当ProtocolConfig和ServiceConfig某属性没有配置时，采用此缺省值，可选。
<dubbo:consumer/> 消费方缺省配置，当ReferenceConfig某属性没有配置时，采用此缺省值，可选。
<dubbo:method/> 方法配置，用于ServiceConfig和ReferenceConfig指定方法级的配置信息。
<dubbo:argument/> 用于指定方法参数配置。
dubbo标签的使用以及标签属性详解

标签属性解释

1.<dubbo:service/>

服务配置，用于暴露一个服务，定义服务的元信息，一个服务可以用多个协议暴露，一个服务也可以注册到多个注册中心。

属性名	类型	是否必填	缺省值	描述
interface	class	必填	无	服务接口全路径
ref	bean id	必填	无	服务对象实现引用
version	string	可选	0.0.0	服务版本，建议使用两位数字版本如1.0，通常在接口不兼容时版本号才需要升级
timeout	int	可选	1000 远程服务调用超时时间（毫秒）
retries	int	可选	2	远程服务调用重试次数，不包括第一次调用，不需要重试请设为0
connections	int	可选	100	每个生产者的最大连接数，短连接协议如rmi，表示限制连接数；长连接协议如dubbo表示建立的长连接个数
loadbalance	string	可选	random	负载均衡策略，可选值为：random（随机）、roundrobin（轮询）、leastactive（最少活跃调用）
async	boolean	可选	false	是否缺省异步执行，不可靠的异步，只是忽略返回值，不阻塞执行线程
register	boolean	可选	true	该协议的服务是否注册到注册中心

2.<dubbo:reference/>

引用配置，用于创建一个远程服务代理，一个引用可以指向多个注册中心。

属性	类型	是否必填	缺省值	描述
id	string	必填	无	服务引用beanId
interface	class	必填	无	服务接口全路径
version	string	可选	无	服务版本，与服务生产者的版本一致
timeout	long	无	可选	使用的timeout 服务方法调用超时时间（毫秒）
retries	int	可选	未知	使用的retries 远程服务调用重试次数，不包括第一次调用，不需要重试请设为0
connections	int	可选	未知	使用的connections 每个生产者的最大连接数，短连接协议如rmi，表示限制连接数；长连接协议如dubbo表示建立的长连接个数
loadbalance	string	可选	random	使用的loadbalance 负载均衡策略，可选值为：random（随机）、roundrobin（轮询）、leastactive（最少活跃调用）
async	boolean	可选	false	使用的async 是否缺省异步执行，不可靠的异步，只是忽略返回值，不阻塞执行线程
check	boolean	可选	未知	使用的check 启动时检查服务生产者是否存在，true则报错，false则忽略
url	string	可选	无	点对点直连服务提供者地址，将绕过注册中心，比如”dubbo://localhost:20890”，这个比较多的使用在测试中
protocol	string	可选	无	只调用指定协议的服务生产者，其他协议忽略

3.<dubbo:protocol/>

协议配置，用于配置提供服务的协议信息，协议由提供方指定，消费方被动接受。
如果需要支持多协议，可以声明多个此标签，并在通过protocol属性指定使用的协议

属 性	类 型	是否必填	缺省值	描 述
id	string	可选	dubbo	协议beanId，registry标签中的protocol引用此ID，如果不填缺省和name属性值一样
name	sring	必填	dubbo	协议名称
port	int	可选	dubbo->20800,rmi->1099,http->80,hessian->80	如果配置为-1或未配置，则会分配一个没有被占用的端口
host	string	可选	未知	为空则自动查找本机ip，建议不配置让Dubbo自动获取本机ip
threadpool	string	可选	fixed	线程池类型，可选fixed/cached
threads	int	可选	100	服务线程池大小（固定大小）
serialization	string	可选	dubbo->hession2,rmi->java,http->json	协议序列化方式，当协议支持多种序列化方式时使用
register	boolean	可选	true	该协议的服务是否注册到注册中心

<dubbo:registry/>

注册中心配置，用于配置连接注册中心相关信息。如果有多个不同的注册中心可以声明多个标签并且或使用registry属性指定。

属 性	类 型	是否必填	缺省值	描 述
id	string	可选	无	注册中心引用beanId，可在或中引用此ID
address	string	必填	无	注册中心服务地址，如果地址没有端口缺省为9090，同一个集群内的多个地址用逗号分隔，如：ip:port,ip:port，不同的集群注册中心请配置多个标签
protocol	string	可选	dubbo	注册中心地址协议，支持dubbo、http、local三种协议，分别表示dubbo地址、http地址和本地注册中心
port	int	可选	9090	注册中心缺省端口，当address没有带端口时使用此端口作为缺省值
username	string	可选	无	登陆注册中心用户名，如果注册中心不需要验证可不填
password	string	可选	无	登陆注册中心密码，如果注册中心不需要验证可不填
transport	string	可选	netty	网络传输方式，可选mina、netty
timeout	int	可选	5000	注册中心请求超时时间（毫秒）
file	string	可选	无	使用文件缓存注册中心地址列表以及服务提供者列表，应用重启时将基于此文件恢复，注意两个注册中心不能使用同一文件存储
check	boolean	可选	true	注册中心不存在时，是否报错
register	boolean	可选	true	是否向此注册中心注册服务，如果设为false，将只订阅，不注册
subscribe	boolean	可选	true	是否向此注册中心订阅服务，如果设为false，将只注册，不订阅

<dubbo:application/>

应用配置，用于配置当前应用信息，不管该应用是提供者还是消费者。

属 性	类 型	是否必填	缺省值	描 述
name	string	是	无	服务名称

<dubbo:provider>

提供方的缺省值，当ProtocolConfig和ServiceConfig某属性没有配置时，采用此缺省值

属性	类型	描述
timeout	long	服务超时时间
loadblance	string	负载均衡策略，可选值：random,roundrobin,leastactive，分别表示：随机，轮循，最少活跃调用
executes	int	服务提供者每服务每方法最大可并行执行请求数
actives	int	每服务消费者每服务每方法最大并发调用数
filter	string	服务提供方远程调用过程拦截器名称，多个名称用逗号分隔

附录

其它标签的属性值设置请参考博客dubbo配置及其属性参考文件，配置参考手册