Dubbo标签及控制台

Dubbo标签

在Dubbo的配置方式中，我们详细介绍了Dubbo在Spring环境下的配置方式，其中就已经在dubbo.xml配置文件中使用到了dubbo的一些标签，这里我们就进行总结一下，如下：
Dubbo标签及控制台

首先最上面的<dubbo:application/>和<dubbo:registry/> ，以及最下面的两个<dubbo:method/>和<dubbo:argument/>在服务的提供方和消费方都是需要设置的

<dubbo:application/>

属性	类型	是否必填	缺省值	描述
name	string	是	无	服务名称
version	string	否	无	当前应用的版本
environment	string	否	无	服务名称应用环境，如：develop/test/product
logger	string	否	slf4j	日志输出方式，可选：slf4j、jcl、log4j、log4j2、jdk

<dubbo:registry/>

属性	类型	是否必填	缺省值	描述
id	string	否	无	注册中心引用BeanId，可以在<dubbo:service registry=""> 或<dubbo:reference registry="">中引用此ID
address	string	是	无	注册中心服务地址，如果地址没有端口缺省为9090，同一个集群内的多个地址用逗号分隔，如：ip:port,ip:port，不同的集群注册中心请配置多个标签
protocol	string	否	dubbo	注册中心地址协议，支持dubbo, multicast, zookeeper, redis, consul(2.7.1), sofa(2.7.2), etcd(2.7.2), nacos(2.7.2)等协议
port	int	否	9090	注册中心缺省端口，当address没有带端口时使用此端口作为缺省值
username	string	否	无	登陆注册中心用户名，如果注册中心不需要验证可不填
password	string	否	无	登陆注册中心密码，如果注册中心不需要验证可不填
transport	string	否	netty	网络传输方式，可选mina、netty
session	int	否	60000	注册中心会话超时时间(毫秒)，用于检测提供者非正常断线后的脏数据，比如用心跳检测的实现，此时间就是心跳间隔，不同注册中心实现不一样
wait	int	否	0	停止时等待通知完成时间(毫秒)
timeout	int	否	5000	注册中心请求超时时间（毫秒）
file	string	否	无	使用文件缓存注册中心地址列表以及服务提供者列表，应用重启时将基于此文件恢复，注意两个注册中心不能使用同一文件存储
check	boolean	否	true	注册中心不存在时，是否报错

Dubbo标签及控制台

然后<dubbo:method/>我们之前也是使用过的，即对服务中的方法进行cache缓存策略，如LRU之类的，至于<dubbo:argument/>则使用较少了。

<dubbo:method/>

（该标签为dubbo:service/或dubbo:reference/的子标签，用于控制到方法级）

属性	类型	是否必填	缺省值	描述
method	string	是	无	方法名
timeout	int	否	缺省为<dubbo:reference/>的timeout	方法调用超时时间（毫秒）
retires	int	可选	缺省为<dubbo:reference/>的retries	远程服务调用重试次数，不包括第一次调用，不需要重试请设为0
loadbalance	string	否	缺省为<dubbo:reference/>的loadbalance	负载均衡策略，可选值为：random（随机）、roundrobin（轮询）、leastactive（最少活跃调用）
cache	string/boolean	否	无	以调用参数为key，缓存返回结果，可选：lru, threadlocal, jcache等
deprecated	boolean	否	false	服务方法是否过时，此属性只在<dubbo:method>作为<dubbo:service>子标签时有效
async	boolean	否	缺省为<dubbo:reference/>的async	是否异步执行，不可靠异步，只是忽略返回值，不阻塞执行线程
actives	int	否	0	每服务消费者最大并发调用限制
executes	int	否	0	每服务每方法最大使用线程数限制，此属性只在<dubbo:method/>作为<dubbo:service/>子标签时有效

Dubbo标签及控制台

然后右侧的<dubbo:provider/>、<dubbo:protocol/>和<dubbo:service/> 是用于在服务提供方进行配置的

其中<dubbo:provider/>则用于默认配置使用，主要起一个继承作用，就是下层属性中未进行配置的则以<dubbo:provider/>配置为准，这样就不用重复配置了

<dubbo:protocol/>

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

<dubbo:provider/>协议配置，用于配置提供服务的协议信息，协议由提供方指定，消费方被动接受。
如果需要支持多协议，可以声明多个此标签，并在通过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:service/> 服务配置，用于暴露一个服务，定义服务的元信息，一个服务可以用多个协议暴露，一个服务也可以注册到多个注册中心。

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

Dubbo标签及控制台

然后右侧的<dubbo:consumer/>和<dubbo:reference/> 是用于在服务消费方方进行配置的

<dubbo:consumer/>服务消费者缺省值配置。同时该标签为 dubbo:reference 标签的缺省值设置。

<dubbo:consumer/>

属性	类型	是否必填	缺省值	描述
timeout	int	否	1000	远程服务调用超时时间(毫秒)
retries	int	否	2	远程服务调用重试次数，不包括第一次调用，不需要重试请设为0
loadbalance	string	否	random	负载均衡策略，可选值：random,roundrobin,leastactive，分别表示：随机，轮询，最少活跃调用
check	boolean	否	true	启动时检查提供者是否存在，true报错，false忽略
cache	string/boolean	否	无	以调用参数为key，缓存返回结果，可选：lru, threadlocal, jcache等

<dubbo:reference/>

<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	否	无	只调用指定协议的服务生产者，其他协议忽略