6.Dubbo之XML配置详解。

谁践踏了优雅 2022-05-15 01:50 448阅读 0赞

# 配置介绍 #

## 配置之间的关系 ##

![dubbo-config][]

<table> 
 <thead> 
  <tr> 
   <th>标签</th> 
   <th>用途</th> 
   <th>解释</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><code>&lt;dubbo:service/&gt;</code></td> 
   <td>服务配置</td> 
   <td>用于暴露一个服务，定义服务的元信息，一个服务可以用多个协议暴露，一个服务也可以注册到多个注册中心</td> 
  </tr> 
  <tr> 
   <td><code>&lt;dubbo:reference/&gt;</code><a href="http://dubbo.apache.org/zh-cn/docs/user/configuration/xml.html#fn2" rel="nofollow">[2]</a></td> 
   <td>引用配置</td> 
   <td>用于创建一个远程服务代理，一个引用可以指向多个注册中心</td> 
  </tr> 
  <tr> 
   <td><code>&lt;dubbo:protocol/&gt;</code></td> 
   <td>协议配置</td> 
   <td>用于配置提供服务的协议信息，协议由提供方指定，消费方被动接受</td> 
  </tr> 
  <tr> 
   <td><code>&lt;dubbo:application/&gt;</code></td> 
   <td>应用配置</td> 
   <td>用于配置当前应用信息，不管该应用是提供者还是消费者</td> 
  </tr> 
  <tr> 
   <td><code>&lt;dubbo:module/&gt;</code></td> 
   <td>模块配置</td> 
   <td>用于配置当前模块信息，可选</td> 
  </tr> 
  <tr> 
   <td><code>&lt;dubbo:registry/&gt;</code></td> 
   <td>注册中心配置</td> 
   <td>用于配置连接注册中心相关信息</td> 
  </tr> 
  <tr> 
   <td><code>&lt;dubbo:monitor/&gt;</code></td> 
   <td>监控中心配置</td> 
   <td>用于配置连接监控中心相关信息，可选</td> 
  </tr> 
  <tr> 
   <td><code>&lt;dubbo:provider/&gt;</code></td> 
   <td>提供方配置</td> 
   <td>当 ProtocolConfig 和 ServiceConfig 某属性没有配置时，采用此缺省值，可选</td> 
  </tr> 
  <tr> 
   <td><code>&lt;dubbo:consumer/&gt;</code></td> 
   <td>消费方配置</td> 
   <td>当 ReferenceConfig 某属性没有配置时，采用此缺省值，可选</td> 
  </tr> 
  <tr> 
   <td><code>&lt;dubbo:method/&gt;</code></td> 
   <td>方法配置</td> 
   <td>用于 ServiceConfig 和 ReferenceConfig 指定方法级的配置信息</td> 
  </tr> 
  <tr> 
   <td><code>&lt;dubbo:argument/&gt;</code></td> 
   <td>参数配置</td> 
   <td>用于指定方法参数配置</td> 
  </tr> 
 </tbody> 
</table>

## 配置覆盖关系 ##

以 timeout 为例，显示了配置的查找顺序，其它 retries, loadbalance, actives 等类似：

*  方法级优先，接口级次之，全局配置再次之。
 *  如果级别一样，则消费方优先，提供方次之。

其中，服务提供方配置，通过 URL 经由注册中心传递给消费方。

![dubbo-config-override][]

建议由服务提供方设置超时，因为一个方法需要执行多长时间，服务提供方更清楚，如果一个消费方同时引用多个服务，就不需要关心每个服务的超时设置。

理论上 ReferenceConfig 的非服务标识配置，在 ConsumerConfig，ServiceConfig, ProviderConfig 均可以缺省配置。

## schema 配置参考手册 ##

所有配置项分为三大类，参见下表中的"作用" 一列。

*  服务发现：表示该配置项用于服务的注册与发现，目的是让消费方找到提供方。
 *  服务治理：表示该配置项用于治理服务间的关系，或为开发测试提供便利条件。
 *  性能调优：表示该配置项用于调优性能，不同的选项对性能会产生影响。
 *  所有配置最终都将转换为 URL 表示，并由服务提供方生成，经注册中心传递给消费方，各属性对应 URL 的参数，参见配置项一览表中的 "对应URL参数" 列。

XML Schema: [http://dubbo.apache.org/schema/dubbo/dubbo.xsd][http_dubbo.apache.org_schema_dubbo_dubbo.xsd]

注意如果上面的XML Schema如果找不到就换为： http://code.alibabatech.com/schema/dubbo/dubbo.xsd

### dubbo:service ###

服务提供者暴露服务配置。对应的配置类：`com.alibaba.dubbo.config.ServiceConfig`

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>对应URL参数</th> 
   <th>类型</th> 
   <th>是否必填</th> 
   <th>缺省值</th> 
   <th>作用</th> 
   <th>描述</th> 
   <th>兼容性</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>interface</td> 
   <td>&nbsp;</td> 
   <td>class</td> 
   <td><strong>必填</strong></td> 
   <td>&nbsp;</td> 
   <td>服务发现</td> 
   <td>服务接口名</td> 
   <td>1.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>ref</td> 
   <td>&nbsp;</td> 
   <td>object</td> 
   <td><strong>必填</strong></td> 
   <td>&nbsp;</td> 
   <td>服务发现</td> 
   <td>服务对象实现引用</td> 
   <td>1.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>version</td> 
   <td>version</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>0.0.0</td> 
   <td>服务发现</td> 
   <td>服务版本，建议使用两位数字版本，如：1.0，通常在接口不兼容时版本号才需要升级</td> 
   <td>1.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>group</td> 
   <td>group</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务发现</td> 
   <td>服务分组，当一个接口有多个实现，可以用分组区分</td> 
   <td>1.0.7以上版本</td> 
  </tr> 
  <tr> 
   <td>path</td> 
   <td>&lt;path&gt;</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>缺省为接口名</td> 
   <td>服务发现</td> 
   <td>服务路径 (注意：1.0不支持自定义路径，总是使用接口名，如果有1.0调2.0，配置服务路径可能不兼容)</td> 
   <td>1.0.12以上版本</td> 
  </tr> 
  <tr> 
   <td>delay</td> 
   <td>delay</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>0</td> 
   <td>性能调优</td> 
   <td>延迟注册服务时间(毫秒) ，设为-1时，表示延迟到Spring容器初始化完成时暴露服务</td> 
   <td>1.0.14以上版本</td> 
  </tr> 
  <tr> 
   <td>timeout</td> 
   <td>timeout</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>1000</td> 
   <td>性能调优</td> 
   <td>远程服务调用超时时间(毫秒)</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>retries</td> 
   <td>retries</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>2</td> 
   <td>性能调优</td> 
   <td>远程服务调用重试次数，不包括第一次调用，不需要重试请设为0</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>connections</td> 
   <td>connections</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>100</td> 
   <td>性能调优</td> 
   <td>对每个提供者的最大连接数，rmi、http、hessian等短连接协议表示限制连接数，dubbo等长连接协表示建立的长连接个数</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>loadbalance</td> 
   <td>loadbalance</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>random</td> 
   <td>性能调优</td> 
   <td>负载均衡策略，可选值：random,roundrobin,leastactive，分别表示：随机，轮循，最少活跃调用</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>async</td> 
   <td>async</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>性能调优</td> 
   <td>是否缺省异步执行，不可靠异步，只是忽略返回值，不阻塞执行线程</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>stub</td> 
   <td>stub</td> 
   <td>class/boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>服务治理</td> 
   <td>设为true，表示使用缺省代理类名，即：接口名 + Local后缀，服务接口客户端本地代理类名，用于在客户端执行本地逻辑，如本地缓存等，该本地代理类的构造函数必须允许传入远程代理对象，构造函数如：public XxxServiceLocal(XxxService xxxService)</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>mock</td> 
   <td>mock</td> 
   <td>class/boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>服务治理</td> 
   <td>设为true，表示使用缺省Mock类名，即：接口名 + Mock后缀，服务接口调用失败Mock实现类，该Mock类必须有一个无参构造函数，与Local的区别在于，Local总是被执行，而Mock只在出现非业务异常(比如超时，网络异常等)时执行，Local在远程调用之前执行，Mock在远程调用后执行。</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>token</td> 
   <td>token</td> 
   <td>string/boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>服务治理</td> 
   <td>令牌验证，为空表示不开启，如果为true，表示随机生成动态令牌，否则使用静态令牌，令牌的作用是防止消费者绕过注册中心直接访问，保证注册中心的授权功能有效，如果使用点对点调用，需关闭令牌功能</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>registry</td> 
   <td>&nbsp;</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>缺省向所有registry注册</td> 
   <td>配置关联</td> 
   <td>向指定注册中心注册，在多个注册中心时使用，值为&lt;dubbo:registry&gt;的id属性，多个注册中心ID用逗号分隔，如果不想将该服务注册到任何registry，可将值设为N/A</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>provider</td> 
   <td>&nbsp;</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>缺使用第一个provider配置</td> 
   <td>配置关联</td> 
   <td>指定provider，值为&lt;dubbo:provider&gt;的id属性</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>deprecated</td> 
   <td>deprecated</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>服务治理</td> 
   <td>服务是否过时，如果设为true，消费方引用时将打印服务过时警告error日志</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>dynamic</td> 
   <td>dynamic</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>true</td> 
   <td>服务治理</td> 
   <td>服务是否动态注册，如果设为false，注册后将显示后disable状态，需人工启用，并且服务提供者停止时，也不会自动取消册，需人工禁用。</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>accesslog</td> 
   <td>accesslog</td> 
   <td>string/boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>服务治理</td> 
   <td>设为true，将向logger中输出访问日志，也可填写访问日志文件路径，直接把访问日志输出到指定文件</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>owner</td> 
   <td>owner</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>服务负责人，用于服务治理，请填写负责人公司邮箱前缀</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>document</td> 
   <td>document</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>服务文档URL</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>weight</td> 
   <td>weight</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>性能调优</td> 
   <td>服务权重</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>executes</td> 
   <td>executes</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>0</td> 
   <td>性能调优</td> 
   <td>服务提供者每服务每方法最大可并行执行请求数</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>proxy</td> 
   <td>proxy</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>javassist</td> 
   <td>性能调优</td> 
   <td>生成动态代理方式，可选：jdk/javassist</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>cluster</td> 
   <td>cluster</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>failover</td> 
   <td>性能调优</td> 
   <td>集群方式，可选：failover/failfast/failsafe/failback/forking</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>filter</td> 
   <td>service.filter</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>default</td> 
   <td>性能调优</td> 
   <td>服务提供方远程调用过程拦截器名称，多个名称用逗号分隔</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>listener</td> 
   <td>exporter.listener</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>default</td> 
   <td>性能调优</td> 
   <td>服务提供方导出服务监听器名称，多个名称用逗号分隔</td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>protocol</td> 
   <td>&nbsp;</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>配置关联</td> 
   <td>使用指定的协议暴露服务，在多协议时使用，值为&lt;dubbo:protocol&gt;的id属性，多个协议ID用逗号分隔</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>layer</td> 
   <td>layer</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>服务提供者所在的分层。如：biz、dao、intl:web、china:acton。</td> 
   <td>2.0.7以上版本</td> 
  </tr> 
  <tr> 
   <td>register</td> 
   <td>register</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>true</td> 
   <td>服务治理</td> 
   <td>该协议的服务是否注册到注册中心</td> 
   <td>2.0.8以上版本</td> 
  </tr> 
 </tbody> 
</table>

### dubbo:reference ###

**服务消费者引用服务配置**。对应的配置类： `com.alibaba.dubbo.config.ReferenceConfig`

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>对应URL参数</th> 
   <th>类型</th> 
   <th>是否必填</th> 
   <th>缺省值</th> 
   <th>作用</th> 
   <th>描述</th> 
   <th>兼容性</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><span style="color:#f33b45;">id</span></td> 
   <td>&nbsp;</td> 
   <td><span style="color:#f33b45;">string</span></td> 
   <td><span style="color:#f33b45;"><strong>必填</strong></span></td> 
   <td>&nbsp;</td> 
   <td><span style="color:#f33b45;">配置关联</span></td> 
   <td><span style="color:#f33b45;">服务引用Bean Id 即为注入名</span></td> 
   <td><span style="color:#f33b45;">1.0.0以上版本</span></td> 
  </tr> 
  <tr> 
   <td><span style="color:#f33b45;">interface</span></td> 
   <td>&nbsp;</td> 
   <td><span style="color:#f33b45;">class</span></td> 
   <td><span style="color:#f33b45;"><strong>必填</strong></span></td> 
   <td>&nbsp;</td> 
   <td><span style="color:#f33b45;">服务发现</span></td> 
   <td><span style="color:#f33b45;">服务接口名</span></td> 
   <td><span style="color:#f33b45;">1.0.0以上版本</span></td> 
  </tr> 
  <tr> 
   <td>version</td> 
   <td>version</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务发现</td> 
   <td>服务版本，与服务提供者的版本一致</td> 
   <td>1.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>group</td> 
   <td>group</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务发现</td> 
   <td>服务分组，当一个接口有多个实现，可以用分组区分，必需和服务提供方一致</td> 
   <td>1.0.7以上版本</td> 
  </tr> 
  <tr> 
   <td>timeout</td> 
   <td>timeout</td> 
   <td>long</td> 
   <td>可选</td> 
   <td>缺省使用&lt;dubbo:consumer&gt;的timeout</td> 
   <td>性能调优</td> 
   <td>服务方法调用超时时间(毫秒)</td> 
   <td>1.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>retries</td> 
   <td>retries</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>缺省使用&lt;dubbo:consumer&gt;的retries</td> 
   <td>性能调优</td> 
   <td>远程服务调用重试次数，不包括第一次调用，不需要重试请设为0</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>connections</td> 
   <td>connections</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>缺省使用&lt;dubbo:consumer&gt;的connections</td> 
   <td>性能调优</td> 
   <td>对每个提供者的最大连接数，rmi、http、hessian等短连接协议表示限制连接数，dubbo等长连接协表示建立的长连接个数</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>loadbalance</td> 
   <td>loadbalance</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>缺省使用&lt;dubbo:consumer&gt;的loadbalance</td> 
   <td>性能调优</td> 
   <td>负载均衡策略，可选值：random,roundrobin,leastactive，分别表示：随机，轮循，最少活跃调用</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>async</td> 
   <td>async</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>缺省使用&lt;dubbo:consumer&gt;的async</td> 
   <td>性能调优</td> 
   <td>是否异步执行，不可靠异步，只是忽略返回值，不阻塞执行线程</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>generic</td> 
   <td>generic</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>缺省使用&lt;dubbo:consumer&gt;的generic</td> 
   <td>服务治理</td> 
   <td>是否缺省泛化接口，如果为泛化接口，将返回GenericService</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>check</td> 
   <td>check</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>缺省使用&lt;dubbo:consumer&gt;的check</td> 
   <td>服务治理</td> 
   <td>启动时检查提供者是否存在，true报错，false忽略</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>url</td> 
   <td>url</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>点对点直连服务提供者地址，将绕过注册中心</td> 
   <td>1.0.6以上版本</td> 
  </tr> 
  <tr> 
   <td>stub</td> 
   <td>stub</td> 
   <td>class/boolean</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>服务接口客户端本地代理类名，用于在客户端执行本地逻辑，如本地缓存等，该本地代理类的构造函数必须允许传入远程代理对象，构造函数如：public XxxServiceLocal(XxxService xxxService)</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>mock</td> 
   <td>mock</td> 
   <td>class/boolean</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>服务接口调用失败Mock实现类名，该Mock类必须有一个无参构造函数，与Local的区别在于，Local总是被执行，而Mock只在出现非业务异常(比如超时，网络异常等)时执行，Local在远程调用之前执行，Mock在远程调用后执行。</td> 
   <td>Dubbo1.0.13及其以上版本支持</td> 
  </tr> 
  <tr> 
   <td>cache</td> 
   <td>cache</td> 
   <td>string/boolean</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>以调用参数为key，缓存返回结果，可选：lru, threadlocal, jcache等</td> 
   <td>Dubbo2.1.0及其以上版本支持</td> 
  </tr> 
  <tr> 
   <td>validation</td> 
   <td>validation</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>是否启用JSR303标准注解验证，如果启用，将对方法参数上的注解进行校验</td> 
   <td>Dubbo2.1.0及其以上版本支持</td> 
  </tr> 
  <tr> 
   <td>proxy</td> 
   <td>proxy</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>javassist</td> 
   <td>性能调优</td> 
   <td>选择动态代理实现策略，可选：javassist, jdk</td> 
   <td>2.0.2以上版本</td> 
  </tr> 
  <tr> 
   <td>client</td> 
   <td>client</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>性能调优</td> 
   <td>客户端传输类型设置，如Dubbo协议的netty或mina。</td> 
   <td>Dubbo2.0.0以上版本支持</td> 
  </tr> 
  <tr> 
   <td>registry</td> 
   <td>&nbsp;</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>缺省将从所有注册中心获服务列表后合并结果</td> 
   <td>配置关联</td> 
   <td>从指定注册中心注册获取服务列表，在多个注册中心时使用，值为&lt;dubbo:registry&gt;的id属性，多个注册中心ID用逗号分隔</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>owner</td> 
   <td>owner</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>调用服务负责人，用于服务治理，请填写负责人公司邮箱前缀</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>actives</td> 
   <td>actives</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>0</td> 
   <td>性能调优</td> 
   <td>每服务消费者每服务每方法最大并发调用数</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>cluster</td> 
   <td>cluster</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>failover</td> 
   <td>性能调优</td> 
   <td>集群方式，可选：failover/failfast/failsafe/failback/forking</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>filter</td> 
   <td>reference.filter</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>default</td> 
   <td>性能调优</td> 
   <td>服务消费方远程调用过程拦截器名称，多个名称用逗号分隔</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>listener</td> 
   <td>invoker.listener</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>default</td> 
   <td>性能调优</td> 
   <td>服务消费方引用服务监听器名称，多个名称用逗号分隔</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>layer</td> 
   <td>layer</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>服务调用者所在的分层。如：biz、dao、intl:web、china:acton。</td> 
   <td>2.0.7以上版本</td> 
  </tr> 
  <tr> 
   <td>init</td> 
   <td>init</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>性能调优</td> 
   <td>是否在afterPropertiesSet()时饥饿初始化引用，否则等到有人注入或引用该实例时再初始化。</td> 
   <td>2.0.10以上版本</td> 
  </tr> 
  <tr> 
   <td>protocol</td> 
   <td>protocol</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服力治理</td> 
   <td>只调用指定协议的服务提供方，其它协议忽略。</td> 
   <td>2.2.0以上版本</td> 
  </tr> 
 </tbody> 
</table>

### dubbo:protocol ###

服务提供者协议配置。对应的配置类： `com.alibaba.dubbo.config.ProtocolConfig`。同时，如果需要支持多协议，可以声明多个 `<dubbo:protocol>` 标签，并在 `<dubbo:service>` 中通过 `protocol` 属性指定使用的协议。

### dubbo:registry ###

注册中心配置。对应的配置类： `com.alibaba.dubbo.config.RegistryConfig`。同时如果有多个不同的注册中心，可以声明多个 `<dubbo:registry>` 标签，并在 `<dubbo:service>` 或 `<dubbo:reference>` 的 `registry` 属性指定使用的注册中心。

### dubbo:monitor ###

监控中心配置。对应的配置类： `com.alibaba.dubbo.config.MonitorConfig`

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>对应URL参数</th> 
   <th>类型</th> 
   <th>是否必填</th> 
   <th>缺省值</th> 
   <th>作用</th> 
   <th>描述</th> 
   <th>兼容性</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>protocol</td> 
   <td>protocol</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>dubbo</td> 
   <td>服务治理</td> 
   <td>监控中心协议，如果为protocol="registry"，表示从注册中心发现监控中心地址，否则直连监控中心。</td> 
   <td>2.0.9以上版本</td> 
  </tr> 
  <tr> 
   <td>address</td> 
   <td>&lt;url&gt;</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>N/A</td> 
   <td>服务治理</td> 
   <td>直连监控中心服务器地址，address="10.20.130.230:12080"</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
 </tbody> 
</table>

### dubbo:application ###

应用信息配置。对应的配置类：`com.alibaba.dubbo.config.ApplicationConfig`

### dubbo:module ###

模块信息配置。对应的配置类 `com.alibaba.dubbo.config.ModuleConfig`

### dubbo:provider ###

服务提供者缺省值配置。对应的配置类：`com.alibaba.dubbo.config.ProviderConfig`。同时该标签为 `<dubbo:service>` 和 `<dubbo:protocol>` 标签的缺省值设置。

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>对应URL参数</th> 
   <th>类型</th> 
   <th>是否必填</th> 
   <th>缺省值</th> 
   <th>作用</th> 
   <th>描述</th> 
   <th>兼容性</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>id</td> 
   <td>&nbsp;</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>dubbo</td> 
   <td>配置关联</td> 
   <td>协议BeanId，可以在&lt;dubbo:service proivder=""&gt;中引用此ID</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>protocol</td> 
   <td>&lt;protocol&gt;</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>dubbo</td> 
   <td>性能调优</td> 
   <td>协议名称</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>host</td> 
   <td>&lt;host&gt;</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>自动查找本机IP</td> 
   <td>服务发现</td> 
   <td>服务主机名，多网卡选择或指定VIP及域名时使用，为空则自动查找本机IP，建议不要配置，让Dubbo自动获取本机IP</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>threads</td> 
   <td>threads</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>200</td> 
   <td>性能调优</td> 
   <td>服务线程池大小(固定大小)</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>payload</td> 
   <td>payload</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>8388608(=8M)</td> 
   <td>性能调优</td> 
   <td>请求及响应数据包大小限制，单位：字节</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>path</td> 
   <td>&lt;path&gt;</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务发现</td> 
   <td>提供者上下文路径，为服务path的前缀</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>server</td> 
   <td>server</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>dubbo协议缺省为netty，http协议缺省为servlet</td> 
   <td>性能调优</td> 
   <td>协议的服务器端实现类型，比如：dubbo协议的mina,netty等，http协议的jetty,servlet等</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>client</td> 
   <td>client</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>dubbo协议缺省为netty</td> 
   <td>性能调优</td> 
   <td>协议的客户端实现类型，比如：dubbo协议的mina,netty等</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>codec</td> 
   <td>codec</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>dubbo</td> 
   <td>性能调优</td> 
   <td>协议编码方式</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>serialization</td> 
   <td>serialization</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>dubbo协议缺省为hessian2，rmi协议缺省为java，http协议缺省为json</td> 
   <td>性能调优</td> 
   <td>协议序列化方式，当协议支持多种序列化方式时使用，比如：dubbo协议的dubbo,hessian2,java,compactedjava，以及http协议的json,xml等</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>default</td> 
   <td>&nbsp;</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>配置关联</td> 
   <td>是否为缺省协议，用于多协议</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>filter</td> 
   <td>service.filter</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>性能调优</td> 
   <td>服务提供方远程调用过程拦截器名称，多个名称用逗号分隔</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>listener</td> 
   <td>exporter.listener</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>性能调优</td> 
   <td>服务提供方导出服务监听器名称，多个名称用逗号分隔</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>threadpool</td> 
   <td>threadpool</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>fixed</td> 
   <td>性能调优</td> 
   <td>线程池类型，可选：fixed/cached</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>accepts</td> 
   <td>accepts</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>0</td> 
   <td>性能调优</td> 
   <td>服务提供者最大可接受连接数</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>version</td> 
   <td>version</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>0.0.0</td> 
   <td>服务发现</td> 
   <td>服务版本，建议使用两位数字版本，如：1.0，通常在接口不兼容时版本号才需要升级</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>group</td> 
   <td>group</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务发现</td> 
   <td>服务分组，当一个接口有多个实现，可以用分组区分</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>delay</td> 
   <td>delay</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>0</td> 
   <td>性能调优</td> 
   <td>延迟注册服务时间(毫秒)- ，设为-1时，表示延迟到Spring容器初始化完成时暴露服务</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>timeout</td> 
   <td>default.timeout</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>1000</td> 
   <td>性能调优</td> 
   <td>远程服务调用超时时间(毫秒)</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>retries</td> 
   <td>default.retries</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>2</td> 
   <td>性能调优</td> 
   <td>远程服务调用重试次数，不包括第一次调用，不需要重试请设为0</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>connections</td> 
   <td>default.connections</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>0</td> 
   <td>性能调优</td> 
   <td>对每个提供者的最大连接数，rmi、http、hessian等短连接协议表示限制连接数，dubbo等长连接协表示建立的长连接个数</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>loadbalance</td> 
   <td>default.loadbalance</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>random</td> 
   <td>性能调优</td> 
   <td>负载均衡策略，可选值：random,roundrobin,leastactive，分别表示：随机，轮循，最少活跃调用</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>async</td> 
   <td>default.async</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>性能调优</td> 
   <td>是否缺省异步执行，不可靠异步，只是忽略返回值，不阻塞执行线程</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>stub</td> 
   <td>stub</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>服务治理</td> 
   <td>设为true，表示使用缺省代理类名，即：接口名 + Local后缀。</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>mock</td> 
   <td>mock</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>服务治理</td> 
   <td>设为true，表示使用缺省Mock类名，即：接口名 + Mock后缀。</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>token</td> 
   <td>token</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>服务治理</td> 
   <td>令牌验证，为空表示不开启，如果为true，表示随机生成动态令牌</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>registry</td> 
   <td>registry</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>缺省向所有registry注册</td> 
   <td>配置关联</td> 
   <td>向指定注册中心注册，在多个注册中心时使用，值为&lt;dubbo:registry&gt;的id属性，多个注册中心ID用逗号分隔，如果不想将该服务注册到任何registry，可将值设为N/A</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>dynamic</td> 
   <td>dynamic</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>true</td> 
   <td>服务治理</td> 
   <td>服务是否动态注册，如果设为false，注册后将显示后disable状态，需人工启用，并且服务提供者停止时，也不会自动取消册，需人工禁用。</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>accesslog</td> 
   <td>accesslog</td> 
   <td>string/boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>服务治理</td> 
   <td>设为true，将向logger中输出访问日志，也可填写访问日志文件路径，直接把访问日志输出到指定文件</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>owner</td> 
   <td>owner</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>服务负责人，用于服务治理，请填写负责人公司邮箱前缀</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>document</td> 
   <td>document</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>服务文档URL</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>weight</td> 
   <td>weight</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>性能调优</td> 
   <td>服务权重</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>executes</td> 
   <td>executes</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>0</td> 
   <td>性能调优</td> 
   <td>服务提供者每服务每方法最大可并行执行请求数</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>actives</td> 
   <td>default.actives</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>0</td> 
   <td>性能调优</td> 
   <td>每服务消费者每服务每方法最大并发调用数</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>proxy</td> 
   <td>proxy</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>javassist</td> 
   <td>性能调优</td> 
   <td>生成动态代理方式，可选：jdk/javassist</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>cluster</td> 
   <td>default.cluster</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>failover</td> 
   <td>性能调优</td> 
   <td>集群方式，可选：failover/failfast/failsafe/failback/forking</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>deprecated</td> 
   <td>deprecated</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>服务治理</td> 
   <td>服务是否过时，如果设为true，消费方引用时将打印服务过时警告error日志</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>queues</td> 
   <td>queues</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>0</td> 
   <td>性能调优</td> 
   <td>线程池队列大小，当线程池满时，排队等待执行的队列大小，建议不要设置，当线程程池时应立即失败，重试其它服务提供机器，而不是排队，除非有特殊需求。</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>charset</td> 
   <td>charset</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>UTF-8</td> 
   <td>性能调优</td> 
   <td>序列化编码</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>buffer</td> 
   <td>buffer</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>8192</td> 
   <td>性能调优</td> 
   <td>网络读写缓冲区大小</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>iothreads</td> 
   <td>iothreads</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>CPU + 1</td> 
   <td>性能调优</td> 
   <td>IO线程池，接收网络读写中断，以及序列化和反序列化，不处理业务，业务线程池参见threads配置，此线程池和CPU相关，不建议配置。</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>telnet</td> 
   <td>telnet</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>所支持的telnet命令，多个命令用逗号分隔</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>&lt;dubbo:service&gt;</td> 
   <td>contextpath</td> 
   <td>contextpath</td> 
   <td>String</td> 
   <td>可选</td> 
   <td>缺省为空串</td> 
   <td>服务治理</td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>layer</td> 
   <td>layer</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>服务提供者所在的分层。如：biz、dao、intl:web、china:acton。</td> 
   <td>2.0.7以上版本</td> 
  </tr> 
 </tbody> 
</table>

### dubbo:consumer ###

服务消费者缺省值配置。配置类： `com.alibaba.dubbo.config.ConsumerConfig` 。同时该标签为 `<dubbo:reference>` 标签的缺省值设置。

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>对应URL参数</th> 
   <th>类型</th> 
   <th>是否必填</th> 
   <th>缺省值</th> 
   <th>作用</th> 
   <th>描述</th> 
   <th>兼容性</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>timeout</td> 
   <td>default.timeout</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>1000</td> 
   <td>性能调优</td> 
   <td>远程服务调用超时时间(毫秒)</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>retries</td> 
   <td>default.retries</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>2</td> 
   <td>性能调优</td> 
   <td>远程服务调用重试次数，不包括第一次调用，不需要重试请设为0</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>loadbalance</td> 
   <td>default.loadbalance</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>random</td> 
   <td>性能调优</td> 
   <td>负载均衡策略，可选值：random,roundrobin,leastactive，分别表示：随机，轮循，最少活跃调用</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>async</td> 
   <td>default.async</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>性能调优</td> 
   <td>是否缺省异步执行，不可靠异步，只是忽略返回值，不阻塞执行线程</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>connections</td> 
   <td>default.connections</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>100</td> 
   <td>性能调优</td> 
   <td>每个服务对每个提供者的最大连接数，rmi、http、hessian等短连接协议支持此配置，dubbo协议长连接不支持此配置</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>generic</td> 
   <td>generic</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>服务治理</td> 
   <td>是否缺省泛化接口，如果为泛化接口，将返回GenericService</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>check</td> 
   <td>check</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>true</td> 
   <td>服务治理</td> 
   <td>启动时检查提供者是否存在，true报错，false忽略</td> 
   <td>1.0.16以上版本</td> 
  </tr> 
  <tr> 
   <td>proxy</td> 
   <td>proxy</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>javassist</td> 
   <td>性能调优</td> 
   <td>生成动态代理方式，可选：jdk/javassist</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>owner</td> 
   <td>owner</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>调用服务负责人，用于服务治理，请填写负责人公司邮箱前缀</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>actives</td> 
   <td>default.actives</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>0</td> 
   <td>性能调优</td> 
   <td>每服务消费者每服务每方法最大并发调用数</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>cluster</td> 
   <td>default.cluster</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>failover</td> 
   <td>性能调优</td> 
   <td>集群方式，可选：failover/failfast/failsafe/failback/forking</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>filter</td> 
   <td>reference.filter</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>性能调优</td> 
   <td>服务消费方远程调用过程拦截器名称，多个名称用逗号分隔</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>listener</td> 
   <td>invoker.listener</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>性能调优</td> 
   <td>服务消费方引用服务监听器名称，多个名称用逗号分隔</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>registry</td> 
   <td>&nbsp;</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>缺省向所有registry注册</td> 
   <td>配置关联</td> 
   <td>向指定注册中心注册，在多个注册中心时使用，值为&lt;dubbo:registry&gt;的id属性，多个注册中心ID用逗号分隔，如果不想将该服务注册到任何registry，可将值设为N/A</td> 
   <td>2.0.5以上版本</td> 
  </tr> 
  <tr> 
   <td>layer</td> 
   <td>layer</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>服务调用者所在的分层。如：biz、dao、intl:web、china:acton。</td> 
   <td>2.0.7以上版本</td> 
  </tr> 
  <tr> 
   <td>init</td> 
   <td>init</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>false</td> 
   <td>性能调优</td> 
   <td>是否在afterPropertiesSet()时饥饿初始化引用，否则等到有人注入或引用该实例时再初始化。</td> 
   <td>2.0.10以上版本</td> 
  </tr> 
  <tr> 
   <td>cache</td> 
   <td>cache</td> 
   <td>string/boolean</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>以调用参数为key，缓存返回结果，可选：lru, threadlocal, jcache等</td> 
   <td>Dubbo2.1.0及其以上版本支持</td> 
  </tr> 
  <tr> 
   <td>validation</td> 
   <td>validation</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>是否启用JSR303标准注解验证，如果启用，将对方法参数上的注解进行校验</td> 
   <td>Dubbo2.1.0及其以上版本支持</td> 
  </tr> 
 </tbody> 
</table>

### dubbo:method ###

方法级配置。对应的配置类： `com.alibaba.dubbo.config.MethodConfig`。同时该标签为 `<dubbo:service>` 或 `<dubbo:reference>` 的子标签，用于控制到方法级。

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>对应URL参数</th> 
   <th>类型</th> 
   <th>是否必填</th> 
   <th>缺省值</th> 
   <th>作用</th> 
   <th>描述</th> 
   <th>兼容性</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>name</td> 
   <td>&nbsp;</td> 
   <td>string</td> 
   <td><strong>必填</strong></td> 
   <td>&nbsp;</td> 
   <td>标识</td> 
   <td>方法名</td> 
   <td>1.0.8以上版本</td> 
  </tr> 
  <tr> 
   <td>timeout</td> 
   <td>&lt;metodName&gt;.timeout</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>缺省为的timeout</td> 
   <td>性能调优</td> 
   <td>方法调用超时时间(毫秒)</td> 
   <td>1.0.8以上版本</td> 
  </tr> 
  <tr> 
   <td>retries</td> 
   <td>&lt;metodName&gt;.retries</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>缺省为&lt;dubbo:reference&gt;的retries</td> 
   <td>性能调优</td> 
   <td>远程服务调用重试次数，不包括第一次调用，不需要重试请设为0</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>loadbalance</td> 
   <td>&lt;metodName&gt;.loadbalance</td> 
   <td>string</td> 
   <td>可选</td> 
   <td>缺省为的loadbalance</td> 
   <td>性能调优</td> 
   <td>负载均衡策略，可选值：random,roundrobin,leastactive，分别表示：随机，轮循，最少活跃调用</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>async</td> 
   <td>&lt;metodName&gt;.async</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>缺省为&lt;dubbo:reference&gt;的async</td> 
   <td>性能调优</td> 
   <td>是否异步执行，不可靠异步，只是忽略返回值，不阻塞执行线程</td> 
   <td>1.0.9以上版本</td> 
  </tr> 
  <tr> 
   <td>sent</td> 
   <td>&lt;methodName&gt;.sent</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>true</td> 
   <td>性能调优</td> 
   <td>异步调用时，标记sent=true时，表示网络已发出数据</td> 
   <td>2.0.6以上版本</td> 
  </tr> 
  <tr> 
   <td>actives</td> 
   <td>&lt;metodName&gt;.actives</td> 
   <td>int</td> 
   <td>可选</td> 
   <td>0</td> 
   <td>性能调优</td> 
   <td>每服务消费者最大并发</td> 
  </tr> 
 </tbody> 
</table>

### 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>

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>对应URL参数</th> 
   <th>类型</th> 
   <th>是否必填</th> 
   <th>缺省值</th> 
   <th>作用</th> 
   <th>描述</th> 
   <th>兼容性</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>index</td> 
   <td>&nbsp;</td> 
   <td>int</td> 
   <td><strong>必填</strong></td> 
   <td>&nbsp;</td> 
   <td>标识</td> 
   <td>方法名</td> 
   <td>2.0.6以上版本</td> 
  </tr> 
  <tr> 
   <td>type</td> 
   <td>&nbsp;</td> 
   <td>String</td> 
   <td>与index二选一</td> 
   <td>&nbsp;</td> 
   <td>标识</td> 
   <td>通过参数类型查找参数的index</td> 
   <td>2.0.6以上版本</td> 
  </tr> 
  <tr> 
   <td>callback</td> 
   <td>&lt;metodName&gt;&lt;index&gt;.retries</td> 
   <td>boolean</td> 
   <td>可选</td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>参数是否为callback接口，如果为callback，服务提供方将生成反向代理，可以从服务提供方反向调用消费方，通常用于事件推送.</td> 
   <td>2.0.6以上版本</td> 
  </tr> 
 </tbody> 
</table>

### dubbo:parameter ###

选项参数配置。对应的配置类：`java.util.Map`。同时该标签为`<dubbo:protocol>`或`<dubbo:service>`或`<dubbo:provider>`或`<dubbo:reference>`或`<dubbo:consumer>`的子标签，用于配置自定义参数，该配置项将作为扩展点设置自定义参数使用。

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>对应URL参数</th> 
   <th>类型</th> 
   <th>是否必填</th> 
   <th>缺省值</th> 
   <th>作用</th> 
   <th>描述</th> 
   <th>兼容性</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>key</td> 
   <td>key</td> 
   <td>string</td> 
   <td><strong>必填</strong></td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>路由参数键</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
  <tr> 
   <td>value</td> 
   <td>value</td> 
   <td>string</td> 
   <td><strong>必填</strong></td> 
   <td>&nbsp;</td> 
   <td>服务治理</td> 
   <td>路由参数值</td> 
   <td>2.0.0以上版本</td> 
  </tr> 
 </tbody> 
</table>

比如：

<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" />

# 协议支持 #

更多的见[http://dubbo.apache.org/zh-cn/docs/user/references/protocol/redis.html][http_dubbo.apache.org_zh-cn_docs_user_references_protocol_redis.html]

## redis:// ##

基于 Redis [\[1\]][1] 实现的 RPC 协议 [\[2\]][2]。

### 注册 redis 服务的地址 ###

RegistryFactory registryFactory = ExtensionLoader.getExtensionLoader(RegistryFactory.class).getAdaptiveExtension();
    Registry registry = registryFactory.getRegistry(URL.valueOf("zookeeper://10.20.153.10:2181"));
    registry.register(URL.valueOf("redis://10.20.153.11/com.foo.BarService?category=providers&dynamic=false&application=foo&group=member&loadbalance=consistenthash"));

### 在客户端引用 ###

在客户端使用 [\[3\]][3]：

<dubbo:reference id="store" interface="java.util.Map" group="member" />

或者，点对点直连：

<dubbo:reference id="store" interface="java.util.Map" url="redis://10.20.153.10:6379" />

也可以使用自定义接口：

<dubbo:reference id="store" interface="com.foo.StoreService" url="redis://10.20.153.10:6379" />

方法名建议和 redis 的标准方法名相同，即：get(key), set(key, value), delet(key)。

如果方法名和 redis 的标准方法名不相同，则需要配置映射关系 [\[4\]][4]：

<dubbo:reference id="cache" interface="com.foo.CacheService" url="redis://10.20.153.10:6379" p:set="putFoo" p:get="getFoo" p:delete="removeFoo" />

--------------------

1.  [Redis][] 是一个高效的 KV 存储服务器 
2.  `2.3.0` 以上版本支持 
3.  不需要感知 Redis 的地址 
4.  其中 "p:xxx" 为 spring 的标准 p 标签

# 注册中心参考手册 #

更多的见

[http://dubbo.apache.org/zh-cn/docs/user/references/registry/redis.html][http_dubbo.apache.org_zh-cn_docs_user_references_registry_redis.html]

## Redis 注册中心 ##

基于 Redis [\[1\]][1 1] 实现的注册中心 [\[2\]][2 1]。

![/user-guide/images/dubbo-redis-registry.jpg][user-guide_images_dubbo-redis-registry.jpg]

使用 Redis 的 Key/Map 结构存储数据结构：

*  主 Key 为服务名和类型
 *  Map 中的 Key 为 URL 地址
 *  Map 中的 Value 为过期时间，用于判断脏数据，脏数据由监控中心删除 [\[3\]][3 1]

使用 Redis 的 Publish/Subscribe 事件通知数据变更：

*  通过事件的值区分事件类型：`register`, `unregister`, `subscribe`, `unsubscribe`
 *  普通消费者直接订阅指定服务提供者的 Key，只会收到指定服务的 `register`, `unregister` 事件
 *  监控中心通过 `psubscribe` 功能订阅 `/dubbo/*`，会收到所有服务的所有变更事件

调用过程：

1.  服务提供方启动时，向 `Key:/dubbo/com.foo.BarService/providers` 下，添加当前提供者的地址
2.  并向 `Channel:/dubbo/com.foo.BarService/providers` 发送 `register` 事件
3.  服务消费方启动时，从 `Channel:/dubbo/com.foo.BarService/providers` 订阅 `register` 和 `unregister`事件
4.  并向 `Key:/dubbo/com.foo.BarService/providers` 下，添加当前消费者的地址
5.  服务消费方收到 `register` 和 `unregister` 事件后，从 `Key:/dubbo/com.foo.BarService/providers` 下获取提供者地址列表
6.  服务监控中心启动时，从 `Channel:/dubbo/*` 订阅 `register` 和 `unregister`，以及 `subscribe` 和`unsubsribe`事件
7.  服务监控中心收到 `register` 和 `unregister` 事件后，从 `Key:/dubbo/com.foo.BarService/providers` 下获取提供者地址列表
8.  服务监控中心收到 `subscribe` 和 `unsubsribe` 事件后，从 `Key:/dubbo/com.foo.BarService/consumers`下获取消费者地址列表

## 配置 ##

<dubbo:registry address="redis://10.20.153.10:6379" />

或

<dubbo:registry address="redis://10.20.153.10:6379?backup=10.20.153.11:6379,10.20.153.12:6379" />

或

<dubbo:registry protocol="redis" address="10.20.153.10:6379" />

或

<dubbo:registry protocol="redis" address="10.20.153.10:6379,10.20.153.11:6379,10.20.153.12:6379" />

### 选项 ###

*  可通过 `<dubbo:registry group="dubbo" />` 设置 redis 中 key 的前缀，缺省为 `dubbo`。
 *  可通过 `<dubbo:registry cluster="replicate" />` 设置 redis 集群策略，缺省为 `failover`：
    
     *  `failover`: 只写入和读取任意一台，失败时重试另一台，需要服务器端自行配置数据同步
     *  `replicate`: 在客户端同时写入所有服务器，只读取单台，服务器端不需要同步，注册中心集群增大，性能压力也会更大

### 可靠性声明 ###

阿里内部并没有采用 Redis 做为注册中心，而是使用自己实现的基于数据库的注册中心，即：Redis 注册中心并没有在阿里内部长时间运行的可靠性保障，此 Redis 桥接实现只为开源版本提供，其可靠性依赖于 Redis 本身的可靠性。

### 安装 ###

安装方式参见: [Redis安装手册][Redis 1]，只需搭一个原生的 Redis 服务器，并将 [Quick Start][] 中 Provider 和 Consumer 里的 `conf/dubbo.properties` 中的 `dubbo.registry.addrss` 的值改为 `redis://127.0.0.1:6379` 即可使用。

## Multicast 注册中心 ##

Multicast 注册中心不需要启动任何中心节点，只要广播地址一样，就可以互相发现。

multicast,广播受到网络结构的影响，一般本地不想搭注册中心的话使用这种调用dubbo简易注册中心。

![/user-guide/images/multicast.jpg][user-guide_images_multicast.jpg]

1.  提供方启动时广播自己的地址
2.  消费方启动时广播订阅请求
3.  提供方收到订阅请求时，单播自己的地址给订阅者，如果设置了 `unicast=false`，则广播给订阅者
4.  消费方收到提供方地址时，连接该地址进行 RPC 调用。

组播受网络结构限制，只适合小规模应用或开发阶段使用。组播地址段: 224.0.0.0 - 239.255.255.255

### 配置 ###

<dubbo:registry address="multicast://224.5.6.7:1234" />

或

<dubbo:registry protocol="multicast" address="224.5.6.7:1234" />

为了减少广播量，Dubbo 缺省使用单播发送提供者地址信息给消费者，如果一个机器上同时启了多个消费者进程，消费者需声明 `unicast=false`，否则只会有一个消费者能收到消息：

<dubbo:registry address="multicast://224.5.6.7:1234?unicast=false" />

或

<dubbo:registry protocol="multicast" address="224.5.6.7:1234">
        <dubbo:parameter key="unicast" value="false" />
    </dubbo:registry>

**微信公众号**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L25pdWdhbmcwOTIw_size_16_color_FFFFFF_t_70][]

。

[dubbo-config]: /images/20220515/fd939f063a0d4a07b830b596b9708255.png
[dubbo-config-override]: /images/20220515/2b1e304cc2564283bb0cf05d2bdff7cd.png
[http_dubbo.apache.org_schema_dubbo_dubbo.xsd]: http://dubbo.apache.org/schema/dubbo/dubbo.xsd
[http_dubbo.apache.org_zh-cn_docs_user_references_protocol_redis.html]: http://dubbo.apache.org/zh-cn/docs/user/references/protocol/redis.html
[1]: http://dubbo.apache.org/zh-cn/docs/user/references/protocol/redis.html#fn1
[2]: http://dubbo.apache.org/zh-cn/docs/user/references/protocol/redis.html#fn2
[3]: http://dubbo.apache.org/zh-cn/docs/user/references/protocol/redis.html#fn3
[4]: http://dubbo.apache.org/zh-cn/docs/user/references/protocol/redis.html#fn4
[Redis]: http://redis.io/
[http_dubbo.apache.org_zh-cn_docs_user_references_registry_redis.html]: http://dubbo.apache.org/zh-cn/docs/user/references/registry/redis.html
[1 1]: http://dubbo.apache.org/zh-cn/docs/user/references/registry/redis.html#fn1
[2 1]: http://dubbo.apache.org/zh-cn/docs/user/references/registry/redis.html#fn2
[user-guide_images_dubbo-redis-registry.jpg]: /images/20220515/b44cfdd79aad433fa356320eb3167bf6.png
[3 1]: http://dubbo.apache.org/zh-cn/docs/user/references/registry/redis.html#fn3
[Redis 1]: http://dubbo.apache.org/books/dubbo-admin-book/install/redis.html
[Quick Start]: http://dubbo.apache.org/zh-cn/docs/user/preface/usage.html
[user-guide_images_multicast.jpg]: /images/20220515/0862076d57d7459b9baedd0187b3f656.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L25pdWdhbmcwOTIw_size_16_color_FFFFFF_t_70]: /images/20220515/8c7da948ee1c406d8a24e572545a1ebc.png