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配置及其属性参考文件,配置参考手册

猜你喜欢

转载自blog.csdn.net/m0_37556444/article/details/83793439