dubbo（二）配置文件详解

ゞ浴缸里的玫瑰 2023-07-09 02:13 6阅读 0赞

1.暴露服务，定义服务信息

服务配置，用于暴露一个服务，定义服务的元信息，一个服务可以用多个协议暴露，一个服务也可以注册到多个注册中心。

<dubbo:service id="sendSmsSOAService" interface="com.sms.api.service.SendSmsSOAService"/>  
2.引用服务配置  
用于创建一个远程服务代理，一个引用可以指向多个注册中心。

<dubbo:reference id="sendSmsSOAService" interface="com.sms.api.service.SendSmsSOAService"/>  
3.协议配置

用于配置提供服务的协议信息，协议由提供方指定，消费方被动接受。

\#dubbo.protocol.name=dubbo  
\#dubbo.protocol.port=20102  
<dubbo:protocol name="$\{dubbo.protocol.name\}" port="$\{dubbo.protocol.port\}" />  
4.应用配置

用于配置当前应用信息，不管该应用是提供者还是消费者。

\#dubbo.application.name=customer  
\#dubbo.application.owner=Soinice  
\#dubbo.application.organization=csdn.net  
\#dubbo.application.logger=slf4j  
<dubbo:application name="$\{dubbo.application.name\}" owner="$\{dubbo.application.owner\}"   
organization="$\{dubbo.application.organization\}" logger="$\{dubbo.application.logger\}"/>  
5.模块配置

用于配置当前模块信息，可选。

<dubbo:module/>   
6.注册中心配置

用于配置连接注册中心相关信息。

\#dubbo.registry.address=zookeeper://192.168.1.163:2181  
<dubbo:registry address="$\{dubbo.registry.address\}" />  
7.监控中心配置

用于配置连接监控中心相关信息，可选。

<dubbo:monitor/>  
8.提供方的缺省值

当ProtocolConfig和ServiceConfig某属性没有配置时，采用此缺省值，可选。

1）timeout：方法调用超时  
2）retries：失败重试次数，默认重试 2 次  
3）loadbalance：负载均衡算法，默认随机  
4）actives：消费者端，最大并发调用限制

\#dubbo.service.loadbalance=roundrobin  
\#dubbo.service.retries=0  
\#dubbo.service.timeout=300000  
<dubbo:provider loadbalance="$\{dubbo.service.loadbalance\}"  
retries="$\{dubbo.service.retries\}" timeout="$\{dubbo.service.timeout\}"/>  
9.消费方缺省配置

当ReferenceConfig某属性没有配置时，采用此缺省值，可选。

可以配置一些 consumer 全局。

<dubbo:consumer group="Soinice" timeout="30000" check="false"/>  
10.方法配置

用于ServiceConfig和ReferenceConfig指定方法级的配置信息。

<dubbo:method />  
11.指定方法参数配置

<dubbo:argument />  
12.服务调用超时设置

上图中以timeout为例，显示了配置的查找顺序，其它retries, loadbalance, actives也类似。  
方法级优先，接口级次之，全局配置再次之。  
如果级别一样，则消费方优先，提供方次之。

其中，服务提供方配置，通过URL经由注册中心传递给消费方。  
建议由服务提供方设置超时，因为一个方法需要执行多长时间，服务提供方更清楚，如果一个消费方同时引用多个服务，就不需要关心每个服务的超时设置。  
理论上ReferenceConfig的非服务标识配置，在ConsumerConfig，ServiceConfig, ProviderConfig均可以缺省配置。

13.启动时检查   
Dubbo默认会在启动时检查依赖的服务是否可用，不可用会抛出异常，阻止Spring初始化完成。

如果你的Spring容器是懒加载的，或者通过API编程延迟引用服务，请关闭check，否则服务临时不可用时，会抛出异常，拿到null引用，如果check=false，总是会返回引用，当服务恢复时，能自动连上。

如果对有些服务不关心，或者出现了循环依赖，必须有一方先启动时，可以关闭启动时检查。默认为true，关闭方式如下：

1.关闭某个服务的启动时检查：(没有提供者时报错)  
<dubbo:reference id="sendSmsSOAService" interface="com.sms.api.service.SendSmsSOAService" check="false"/>  
2.关闭所有服务的启动时检查：(没有提供者时报错) 写在定义服务消费者一方（全局配置）  
<dubbo:consumer check="false" />  
3、关闭注册中心启动时检查：(注册订阅失败时报错)  
<dubbo:registry check="false" />  
14.引用缺省

引用默认是延迟初始化的，只有引用被注入到其它Bean，或者被getBean()获取时，才会初始化。如果需要饥饿加载，即Dubbo启动时就立即生成动态代理实例，则可以配置：

<dubbo:reference id="sendSmsSOAService" interface="com.sms.api.service.SendSmsSOAService" init="true" />  
15.只订阅不注册

1、问题  
为方便开发测试，经常会在线下共用一个所有服务可用的注册中心，这时，如果一个正在开发中的服务提供者注册，这样注册上去，其他消费者在调用该服务时，就会偶尔的调用到你本地的服务，这样就报错了，可能会影响消费者不能正常运行。

2、解决方案  
可以让服务提供者开发方，只订阅服务(开发的服务可能依赖其它服务)，而不注册正在开发的服务，通过直连测试正在开发的服务。这样别人就不会调你的本地服务，但你的本地服务所订阅的服务正常运行

禁用注册配置：  
<dubbo:registry address="10.20.153.10:9090" register="false" />  
或者：  
<dubbo:registry address="10.20.153.10:9090?register=false" />  
16.回声测试(测试服务是否可用)

回声测试用于检测服务是否可用，回声测试按照正常请求流程执行，能够测试整个调用是否通畅，可用于监控。  
所有服务自动实现EchoService接口，只需将任意服务引用强制转型为EchoService，即可使用。

<dubbo:reference id="sendSmsSOAService" interface="com.sms.api.service.SendSmsSOAService" />  
EchoService echoService = (EchoService) sendSmsSOAService; // 强制转型为EchoService  
17.延迟连接

延迟连接，用于减少长连接数，当有调用发起时，再创建长连接。  
只对使用长连接的dubbo协议生效。

<dubbo:protocol name="dubbo" lazy="true" />  
18.令牌验证

防止消费者绕过注册中心访问提供者，在注册中心控制权限，以决定要不要下发令牌给消费者，注册中心可灵活改变授权方式，而不需修改或升级提供者。

1、全局设置开启令牌验证：  
  
<dubbo:provider interface="com.sms.api.service.SendSmsSOAService" token="true" />  
  
<dubbo:provider interface="com.sms.api.service.SendSmsSOAService" token="123456" />  
   
2、服务级别设置开启令牌验证：  
  
<dubbo:service interface="com.sms.api.service.SendSmsSOAService" token="true" />  
  
<dubbo:service interface="com.sms.api.service.SendSmsSOAService" token="123456" />  
   
3、协议级别设置开启令牌验证：  
  
<dubbo:protocol name="dubbo" token="true" />  
  
<dubbo:protocol name="dubbo" token="123456" />  
19.日志适配

缺省自动查找：log4j、slf4j、jcl、jdk

可以通过以下方式配置日志输出策略：

<dubbo:application logger="log4j"/>  
访问日志：  
如果你想记录每一次请求信息，可开启访问日志，类似于apache的访问日志。此日志量比较大，请注意磁盘容量。

将访问日志输出到当前应用的log4j日志：

<dubbo:protocol accesslog="true" />  
将访问日志输出到指定文件：

<dubbo:protocol accesslog="http://10.20.160.198/wiki/display/dubbo/sms/sendSms.log" />  
20.配置Dubbo缓存文件

配置方法如下：

<dubbo:registry file="$\{user.home\}/output/dubbo.cache" />  
注意：

文件的路径，应用可以根据需要调整，保证这个文件不会在发布过程中被清除。如果有多个应用进程注意不要使用同一个文件，避免内容被覆盖。

这个文件会缓存：

注册中心的列表

服务提供者列表

有了这项配置后，当应用重启过程中，Dubbo注册中心不可用时则应用会从这个缓存文件读取服务提供者列表的信息，进一步保证应用可靠性。

21.直连提供者

开发测试环境下，需要绕过注册中心，直接测试服务提供者

<dubbo:reference id="sendSmsSOAService" interface="com.sms.api.service.SendSmsSOAService"  
check="false" url="dubbo://192.168.1.1:20881"/>   
SendSmsSOAService里加个断点，每次访问都会走断点。在管控台本地服务接口最后点击禁用，还是可以正常访问，说明绕过了注册中心。

22.服务分组

可实现服务的稳步升级，当然 也可以 每个开发每个组，消费者就只会调用同一分组的服务接口了，这样不会互相调用。

\#consumer 全局加 group  
<dubbo:consumer group="Soinice" timeout="3000" check="false" />  
\#reference 引用 单一加 group  
<dubbo:reference id="sendSmsSOAService" interface="com.sms.api.service.SendSmsSOAService" timeout="3000" check="false" group="Soinice"/>  
也可以使用 version 来代替：

<dubbo:service id="sendMailSOAService"interface="com.sms.api.service.SendMailSOAService"  
timeout="3000" check="false" version="0.0.1"/>  
<dubbo:reference id="sendMailSOAService"interface="com.sms.api.service.SendMailSOAService"   
timeout="3000" check="false" version="0.0.1"/>