dubbo配置详解



dubbo配置文件详解

一、dubbo常用配置

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

eg、<dubbo:serviceref="demoService" interface="com.unj.dubbotest.provider.DemoService"/>

 

<dubbo:reference/>引用服务配置，用于创建一个远程服务代理，一个引用可以指向多个注册中心。

eg、<dubbo:referenceid="demoService" interface="com.unj.dubbotest.provider.DemoService"/>

 

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

eg、<dubbo:protocolname="dubbo" port="20880"/>

 

<dubbo:application/>应用配置，用于配置当前应用信息，不管该应用是提供者还是消费者。

eg、<dubbo:applicationname="xixi_provider"/>

   <dubbo:applicationname="hehe_consumer"/>

 

<dubbo:module/>模块配置，用于配置当前模块信息，可选。

<dubbo:registry/>注册中心配置，用于配置连接注册中心相关信息。

eg、<dubbo:registryaddress="zookeeper://192.168.2.249:2181"/>

 

<dubbo:monitor/>监控中心配置，用于配置连接监控中心相关信息，可选。

<dubbo:provider/>提供方的缺省值，当ProtocolConfig和ServiceConfig某属性没有配置时，采用此缺省值，可选。

<dubbo:consumer/>消费方缺省配置，当ReferenceConfig某属性没有配置时，采用此缺省值，可选。

<dubbo:method/>方法配置，用于ServiceConfig和ReferenceConfig指定方法级的配置信息。

<dubbo:argument/>用于指定方法参数配置。

二、服务调用超时设置

上图中以timeout为例，显示了配置的查找顺序，其它retries, loadbalance, actives也类似。
方法级的配置优先级高于接口级，consumer的优先级高于provider。同时，在本地参数配置还存在一层优先级  

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

三、启动时检查
Dubbo缺省会在启动时检查依赖的服务是否可用，不可用时会抛出异常，阻止Spring初始化完成，以便上线时，能及早发现问题，默认check=true。

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

可以通过check="false"关闭检查，比如，测试时，有些服务不关心，或者出现了循环依赖，必须有一方先启动。

1、关闭某个服务的启动时检查：(没有提供者时报错)

<dubbo:referenceinterface="com.foo.BarService" check="false"/>

 

2、关闭所有服务的启动时检查：(没有提供者时报错) 写在定义服务消费者一方

<dubbo:consumercheck="false"/>

 

3、关闭注册中心启动时检查：(注册订阅失败时报错)

<dubbo:registrycheck="false"/>

引用缺省是延迟初始化的，只有引用被注入到其它Bean，或被getBean()获取，才会初始化。
如果需要饥饿加载，即没有人引用也立即生成动态代理，可以配置：

<dubbo:referenceinterface="com.foo.BarService" init="true"/>

四、订阅
1、问题
为方便开发测试，经常会在线下共用一个所有服务可用的注册中心，这时，如果一个正在开发中的服务提供者注册，可能会影响消费者不能正常运行。

2、解决方案
可以让服务提供者开发方，只订阅服务(开发的服务可能依赖其它服务)，而不注册正在开发的服务，通过直连测试正在开发的服务。

禁用注册配置：

<dubbo:registryaddress="10.20.153.10:9090" register="false"/>

或者：

<dubbo:registryaddress="10.20.153.10:9090?register=false"/>

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

eg、<dubbo:referenceid="memberService" interface="com.xxx.MemberService"/>

 

MemberService memberService =ctx.getBean("memberService"); //远程服务引用

EchoService echoService = (EchoService)memberService; //强制转型为EchoService

String status =echoService.$echo("OK"); //回声测试可用性

assert(status.equals("OK"))

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

<dubbo:protocolname="dubbo" lazy="true"/>

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

1、全局设置开启令牌验证：

<!--随机token令牌，使用UUID生成-->

<dubbo:providerinterface="com.foo.BarService" token="true"/>

 

<!--固定token令牌，相当于密码-->

<dubbo:providerinterface="com.foo.BarService" token="123456"/>

 

2、服务级别设置开启令牌验证：

<!--随机token令牌，使用UUID生成-->

<dubbo:serviceinterface="com.foo.BarService" token="true"/>

 

<!--固定token令牌，相当于密码-->

<dubbo:serviceinterface="com.foo.BarService" token="123456"/>

 

3、协议级别设置开启令牌验证：

<!--随机token令牌，使用UUID生成-->

<dubbo:protocolname="dubbo" token="true"/>

 

<!--固定token令牌，相当于密码-->

<dubbo:protocolname="dubbo" token="123456"/>

八、日志适配
缺省自动查找：log4j、slf4j、jcl、jdk

可以通过以下方式配置日志输出策略：dubbo:applicationlogger="log4j"/>

访问日志：
如果你想记录每一次请求信息，可开启访问日志，类似于apache的访问日志。此日志量比较大，请注意磁盘容量。

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

<dubbo:protocolaccesslog="true"/>

将访问日志输出到指定文件：

<dubbo:protocolaccesslog="http://10.20.160.198/wiki/display/dubbo/foo/bar.log"/>

九、配置Dubbo缓存文件

配置方法如下：

<dubbo:registryfile=”${user.home}/output/dubbo.cache” />

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

这个文件会缓存：
注册中心的列表
服务提供者列表

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