Configuration Reference
Configuration Relation:
SLA 配置在此完成!Service Layer Agreement
ApplicationConfig 应用配置,用于配置当前应用信息,不管该应用是提
供者还是消费者。
RegistryConfig 注册中心配置,用于配置连接注册中心相关信息。
ProtocolConfig 协议配置,用于配置提供服务的协议信息,协议由提供方
指定,消费方被动接受。
ServiceConfig 服务配置,用于暴露一个服务,定义服务的元信息,一个
服务可以用多个协议暴露,一个服务也可以注册到多个注册中心。
ProviderConfig 提供方的缺省值,当 ProtocolConfig 和 ServiceConfig 某属
性没有配置时,采用此缺省值。
ReferenceConfig 引用配置,用于创建一个远程服务代理,一个引用可以
指向多个注册中心。
ConsumerConfig 消费方缺省配置,当 ReferenceConfig 某属性没有配置时,
采用此缺省值。
MethodConfig 方法配置,用于 ServiceConfig 和 ReferenceConfig 指定方法
级的配置信息。
ArgumentConfig 用于指定方法参数配置。
Configuration Override:
上图中
以
timeout
为 例 ,
显 示 了
配 置 的
查 找 顺
序 , 其
它
retries,
loadbalance, actives 等类似。
方法级优先,接口级次之,全局配置再次之。
如果级别一样,则消费方优先,提供方次之。
其中,服务提供方配置,通过 URL 经由注册中心传递给消费方。
建议由服务提供方设置超时,因为一个方法需要执行多长时间,服务提
供方更清楚,如果一个消费方同时引用多个服务,就不需要关心每个服务的
超时设置。
理 论 上 ReferenceConfig 的 非 服 务 标 识 配 置 , 在
ConsumerConfig,ServiceConfig, ProviderConfig 均可以缺省配置。
Configuration Type:
注意:只有 group,interface,version 是服务的匹配条件,三者决定是不是同一
个服务,其它配置项均为调优和治理参数。
所有配置项分为三大类,参见下表中的"作用"一列。
服务发现:表示该配置项用于服务的注册与发现,目的是让消费方找到
提供方。
服务治理:表示该配置项用于治理服务间的关系,或为开发测试提供便
利条件。
性能调优:表示该配置项用于调优性能,不同的选项对性能会产生影响。
所有配置最终都将转换为 URL 表示,并由服务提供方生成,经注册中心传递给
消费方,各属性对应 URL 的参数,参见配置项一览表中的"对应 URL 参数"列。
URL 格式:
protocol://username:password@host:port/path?key=value&key=value
Schema: http://code.alibabatech.com/schema/dubbo/dubbo.xsd
<dubbo:application/>
应用信息配置:
配置类:com.alibaba.dubbo.rpc.config.ApplicationConfig
标签 属性 对应
URL
参数
类
型
是
否
必
填
缺
省
值
作
用
描述 兼容性
<dubbo:ap
plication>
nam
e
applic
ation
str
in
g
必
填
服
务
治
理
当前应用名称,用于注册中心计
算应用间依赖关系,注意:消费
者和提供者应用名不要一样,此
参数不是匹配条件,你当前项目
叫什么名字就填什么,和提供者
消费者角色无关,比如:
kylin
应
用调用了
morgan
应用的服务,则
kylin
项目配成
kylin
,
morgan
项目
配成
morgan
,可能
kylin
也提供其
它服务给别人使用,但
kylin
项目
永远配成
kylin
,这样注册中心将
显示
kylin
依赖于
morgan
1.0.16
以上
版本
<dubbo:ap
plication>
orga
nizat
ion
organi
zation
str
in
g
可
选
服
务
治
理
组织名称
(BU
或部门
)
,用于注册
中心区分服务来源,此配置项建
议不要使用
autoconfig
,直接写死
在 配 置 中 , 比 如
china,intl,itu,crm,asc,dw,aliexpress
等
2.0.0
以 上
版本
<dubbo:ap
plication>
orga
nizat
ion
organi
zation
str
in
g
可
选
服
务
治
理
用 于 服 务 分 层 对 应 的 架 构 。
如,
intl
、
china
。不同的架构使用
不同的分层。
2.0.7
以 上
版本
<dubbo:ap
plication>
envir
onm
enviro
nment
str
in
可
选
服
务
应 用 环 境 , 如 :
develop/test/
product
,不同环境使用不同的缺
2.0.0
以 上
版本
ent g
治
理
省值,以及作为只用于开发测试
功能的限制条件
<dubbo:ap
plication>
own
er
owner str
in
g
可
选
服
务
治
理
应用负责人,用于服务治理,请
填写负责人公司邮箱前缀
2.0.5
以 上
版本
<dubbo:registry/>
注册中心配置:
配置类:com.alibaba.dubbo.rpc.config.RegistryConfig
说明:如果有多个不同的注册中心,可以声明多个<dubbo:registry>标签,并在
<dubbo:service>或<dubbo:reference>的 registry 属性指定使用的注册中心。
标签 属
性
对应
URL
参数
类
型
是
否
必
填
缺
省
值
作
用
描述 兼容性
<dubbo:regist
ry>
id st
ri
n
g
可
选
配
置
关
联
注 册 中 心 引 用
BeanId
, 可 以 在
<dubbo:service registry="">
或
<dubbo:reference registry="">
中引用此
ID
1.0.16
以
上版本
<dubbo:regist
ry>
ad
dr
es
s
<host:
port>
st
ri
n
g
必
填
服
务
发
现
注册中心服务器地址,如果地址没有
端口缺省为
9090
,同一集群内的多个
地址用逗号分隔,如:
ip:port,ip:port
,
不 同 集 群 的 注 册 中 心 , 请 配 置 多 个
<dubbo:registry>
标签
1.0.16
以
上版本
<dubbo:regist
ry>
pr
ot
oc
ol
<proto
col>
st
ri
n
g
可
选
d
u
b
b
o
服
务
发
现
注同中心地址协议,支持
dubbo, http,
local
三种协议,分别表示,
dubbo
地
址,
http
地址,本地注册中心
2.0.0
以上
版本
<dubbo:regist
ry>
po
rt
<port
>
in
t
可
选
9
0
9
0
服
务
发
现
注册中心缺省端口,当
address
没有带
端口时使用此端口做为缺省值
2.0.0
以上
版本
<dubbo:regist
ry>
us
er
na
m
<user
name
>
st
ri
n
g
可
选
服
务
治
理
登录注册中心用户名,如果注册中心
不需要验证可不填
2.0.0
以上
版本
e
<dubbo:regist
ry>
pa
ss
w
or
d
<pass
word>
st
ri
n
g
可
选
服
务
治
理
登录注册中心密码,如果注册中心不
需要验证可不填
2.0.0
以上
版本
<dubbo:regist
ry>
tra
ns
po
rt
registr
y.trans
porter
st
ri
n
g
可
选
ne
tt
y
性
能
调
优
网络传输方式,可选
mina,netty 2.0.0
以上
版本
<dubbo:regist
ry>
ti
m
eo
ut
registr
y.time
out
in
t
可
选
5
0
0
0
性
能
调
优
注册中心请求超时时间
(
毫秒
) 2.0.0
以上
版本
<dubbo:regist
ry>
fil
e
registr
y.file
st
ri
n
g
可
选
服
务
治
理
使用文件缓存注册中心地址列表及服
务提供者列表,应用重启时将基于此
文件恢复,注意:两个注册中心不能
使用同一文件存储
2.0.0
以上
版本
<dubbo:regist
ry>
wa
it
registr
y.wait
in
t
可
选
0
性
能
调
优
停止时等待通知完成时间
(
毫秒
) 2.0.0
以上
版本
<dubbo:regist
ry>
ch
ec
k
check b
o
ol
ea
n
可
选
tr
ue
服
务
治
理
注册中心不存在时,是否报错
2.0.0
以上
版本
<dubbo:regist
ry>
re
gis
ter
registe
r
b
o
ol
ea
n
可
选
tr
ue
服
务
治
理
是否向此注册中心注册服务,如果设
为
false
,将只订阅,不注册
2.0.5
以上
版本
<dubbo:regist
ry>
su
bs
cri
be
subscr
ibe
b
o
ol
ea
n
可
选
tr
ue
服
务
治
理
是否向此注册中心订阅服务,如果设
为
false
,将只注册,不订阅
2.0.5
以上
版本
<dubbo:regist
ry>
dy
na
dyna
mic
b
o
可
选
tr
ue
服
务
服务是否动态注册,如果设为
false
,
注册后将显示后
disable
状态,需人工
2.0.5
以上
版本
评论10
最新资源