Dubbo（四）之xml配置方式

缺乏、安全感 2022-10-25 12:58 185阅读 0赞

转载自  [Dubbo xml配置方式][Dubbo xml]

以 XML 配置的方式来配置你的 Dubbo 应用

有关 XML 的详细配置项，请参见：[配置参考手册][Link 1]。如果不想使用 Spring 配置，而希望通过 API 的方式进行调用，请参见：[API配置][API]。想知道如何使用配置，请参见：[快速启动][Link 2]。

请在此查看文档描述的[完整示例][Link 3]

## provider.xml 示例 ##

## consumer.xml示例 ##

所有标签都支持自定义参数，用于不同扩展点实现的特殊配置，如：

<dubbo:protocol name="jms">
        <dubbo:parameter key="queue" value="your_queue" />
    </dubbo:protocol>

或： [1][]

## 配置之间的关系 ##

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21vYWt1bg_size_16_color_FFFFFF_t_70][]

<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>&nbsp;<a href="https://dubbo.apache.org/zh/docs/v2.7/user/configuration/xml/#fn:2" 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 经由注册中心传递给消费方。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21vYWt1bg_size_16_color_FFFFFF_t_70 1][]

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

理论上 ReferenceConfig 中除了`interface`这一项，其他所有配置项都可以缺省不配置，框架会自动使用ConsumerConfig，ServiceConfig, ProviderConfig等提供的缺省配置。

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

1.  `2.1.0` 开始支持，注意声明：`xmlns:p="http://www.springframework.org/schema/p"` [↩︎][Link 4]
2.  引用缺省是延迟初始化的，只有引用被注入到其它 Bean，或被 `getBean()` 获取，才会初始化。如果需要饥饿加载，即没有人引用也立即生成动态代理，可以配置：`<dubbo:reference ... init="true" />` [↩︎][Link 5]

[Dubbo xml]: https://dubbo.apache.org/zh/docs/v2.7/user/configuration/xml/
[Link 1]: https://dubbo.apache.org/zh/docs/v2.7/user/references/xml
[API]: https://dubbo.apache.org/zh/docs/v2.7/user/configuration/api
[Link 2]: https://dubbo.apache.org/zh/docs/v2.7/user/quick-start
[Link 3]: https://github.com/apache/dubbo-samples/tree/master/java/dubbo-samples-basic
[1]: https://dubbo.apache.org/zh/docs/v2.7/user/configuration/xml/#fn:1
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21vYWt1bg_size_16_color_FFFFFF_t_70]: /images/20221024/458996ce086b49e2a5e9139a04852b24.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L21vYWt1bg_size_16_color_FFFFFF_t_70 1]: /images/20221024/c78a521d20ba4529ae381c5d9f24306d.png
[Link 4]: https://dubbo.apache.org/zh/docs/v2.7/user/configuration/xml/#fnref:1
[Link 5]: https://dubbo.apache.org/zh/docs/v2.7/user/configuration/xml/#fnref:2