一、注册中心<dubbo:registry/>
配置类:com.alibaba.dubbo.config.RegistryConfig
说明:如果有多个不同的注册中心,可以声明多个<dubbo:registry>
标签,并在<dubbo:service>
或<dubbo:reference>
的registry属性指定使用的注册中心 。
1、服务发现相关配置
1、id
注册中心引用BeanId,可以在<dubbo:service registry="">
或<dubbo:reference registry="">
中引用此ID 1.0.16以上版本
2、address
注册中心服务器地址,如果地址没有端口缺省为9090,同一集群内的多个地址用逗号分隔,如:ip:port,ip:port,不同集群的注册中心,请配置多个
3、protocol
注同中心地址协议,支持dubbo, http, local三种协议,分别表示,dubbo地址,http地址,本地注册中心
4、port
注册中心缺省端口,当address没有带端口时使用此端口做为缺省值
2、服务治理相关配置
1、username
登录注册中心用户名,如果注册中心不需要验证可不填
2、password
登录注册中心密码,如果注册中心不需要验证可不填
3、file
使用文件缓存注册中心地址列表及服务提供者列表,应用重启时将基于此文件恢复,注意:两个注册中心不能使用同一文件存储
4、check
注册中心不存在时,是否报错
5、 register
是否向此注册中心注册服务,如果设为false,将只订阅,不注册
6、subscribe
是否向此注册中心订阅服务,如果设为false,将只注册,不订阅
7、dynamic
服务是否动态注册,如果设为false,注册后将显示后disable状态,需人工启用,并且服务提供者停止时,也不会自动取消册,需人工禁用。
3、服务调优相关配置
1、transport
网络传输方式,可选mina,netty
2、timeout
注册中心请求超时时间(毫秒)
3、session
注册中心会话超时时间(毫秒),用于检测提供者非正常断线后的脏数据,比如用心跳检测的实现,此时间就是心跳间隔,不同注册中心实现不一样
4、wait
停止时等待通知完成时间(毫秒)
二、监控中心配置<dubbo:monitor/>
1、protocol
监控中心协议,如果为protocol=”registry”,表示从注册中心发现监控中心地址,否则直连监控中心
2、address
直连监控中心服务器地址,address=”10.20.130.230:12080”
三、方法级配置<dubbo:method/>
配置类:com.alibaba.dubbo.config.MethodConfig
说明:该标签为<dubbo:service>
或<dubbo:reference>
的子标签,用于控制到方法级,
服务发现类
1、name
方法名
服务治理类
1.deprecated
服务方法是否过时,此属性只在<dubbo:method>
作为<dubbo:service>
子标签时有效
2、sticky
该接口上的所有方法使用同一个provider.如果需要更复杂的规则,请使用用路由
3、cache
以调用参数为key,缓存返回结果,可选:lru, threadlocal, jcache等
4、validation
是否启用JSR303标准注解验证,如果启用,将对方法参数上的注解
服务调优类
1、timeout
方法调用超时时间(毫秒)
2、retries
缺省为<dubbo:reference>
的retries,远程服务调用重试次数,不包括第一次调用,不需要重试请设为0
3、loadbalance
负载均衡策略,可选值:random,roundrobin,leastactive,分别表示:随机,轮循,最少活跃调用
4、async
是否异步执行,不可靠异步,只是忽略返回值,不阻塞执行线程
5、sent
异步调用时,标记sent=true时,表示网络已发出数据
6、actives
每服务消费者最大并发调用限制
7、executes
每服务每方法最大使用线程数限制- -,此属性只在<dubbo:method>作为<dubbo:service>
子标签时有效
8、return
方法调用是否需要返回值,async设置为true时才生效,如果设置为true,则返回future,或回调onreturn等方法,如果设置为false,则请求发送成功后直接返回Null
9、oninvoke
方法执行前拦截
10、onreturn
方法执行返回后拦截
11、onthrow
方法执行有异常拦截 ,如
<dubbo:reference interface="com.xxx.XxxService">
<dubbo:method name="findXxx" timeout="3000" retries="2" />
</dubbo:reference>
四、方法参数配置<dubbo:argument/>
配置类:com.alibaba.dubbo.config.ArgumentConfig
说明:该标签为<dubbo:method>
的子标签,用于方法参数的特征描述,比如:
<dubbo:method name="findXxx" timeout="3000" retries="2">
<dubbo:argument index="0" callback="true" />
<dubbo:method>
1、index
方法名
2、type
通过参数类型查找参数的index
3、callback
参数是否为callback接口,如果为callback,服务提供方将生成反向代理,可以从服务提供方反向调用消费方,通常用于事件推送
选项参数配置<dubbo:parameter/>
配置类:java.util.Map
说明:该标签为<dubbo:protocol>或<dubbo:service>或<dubbo:provider>或<dubbo:reference>
或<dubbo:consumer>
的子标签,用于配置自定义参数,该配置项将作为扩展点设置自定义参数使用。
1、key
路由参数键
2、value
路由参数值 ,例如:
<dubbo:protocol name="napoli">
<dubbo:parameter key="http://10.20.160.198/wiki/display/dubbo/napoli.queue.name" value="xxx" />
</dubbo:protocol>
<!-- 或者 -->
<dubbo:protocol name="jms" p:queue="xxx" />