dubbo（二）配置文件详解（2）服务消费方

一、服务消费方<dubbo:reference />

配置类：com.alibaba.dubbo.config.ReferenceConfig 

1、服务发现

1.1、id

服务引用Bean的id，如：

<dubbo:reference id=“xxxService” interface=“com.xxx.XxxService” /> <!-- 增加引用远程服务配置 -->
<bean id=“xxxAction” class=“com.xxx.XxxAction”> <!-- 和本地服务一样使用远程服务 -->
    <property name=“xxxService” ref=“xxxService” />
</bean>

1.2、interface  

服务接口全路径

1.3、version 

版本号，与服务提供者保持一致

1.4、group 

服务分组，当一个接口有多个实现，可以用分组区分，必需和服务提供方一致 

1.5、registry 

从指定注册中心注册获取服务列表，在多个注册中心时使用，值为<dubbo:registry>的id属性，多个注册中心ID用逗号分隔

2、服务治理

1、generic 
是否缺省泛化接口，如果为泛化接口，将返回GenericService 
2、check 
启动时检查提供者是否存在，true报错，false忽略 
3、url 
点对点直连服务提供者地址，将绕过注册中心 
4、stub 
服务接口客户端本地代理类名，用于在客户端执行本地逻辑，如本地缓存等，该本地代理类的构造函数必须允许传入远程代理对象，构造函数如：public XxxServiceLocal(XxxService xxxService) 
5、mock 
服务接口调用失败Mock实现类名，该Mock类必须有一个无参构造函数，与Local的区别在于，Local总是被执行，而Mock只在出现非业务异常(比如超时，网络异常等)时执行，Local在远程调用之前执行，Mock在远程调用后执行 
6、cache 
以调用参数为key，缓存返回结果，可选：lru, threadlocal, jcache等 
7、validation 
是否启用JSR303标准注解验证，如果启用，将对方法参数上的注解进行校验 
2.8、layer 
layer服务调用者所在的分层。如：biz、dao、intl:web、china:acton 
2.9、protocol 
只调用指定协议的服务提供方，其它协议忽略

3、服务调优

1、timeout 
服务调用超时时间，如果客户端配置以客户端为准 
2、retries 
远程服务调用重试次数，不包括第一次调用，不需要重试请设为0 
3、connections 
对每个提供者的最大连接数，rmi、http、hessian等短连接协议表示限制连接数，dubbo等长连接协表示建立的长连接个数 
4、loadbalance 
负载均衡策略，可选值：random,roundrobin,leastactive，分别表示：随机，轮循，最少活跃调用 
5、async 
是否异步执行，不可靠异步，只是忽略返回值，不阻塞执行线程 
6、proxy 
选择动态代理实现策略，可选：javassist, jdk 
7、client 
客户端传输类型设置，如Dubbo协议的netty或mina 
8、actives 
每服务消费者每服务每方法最大并发调用数 
9、cluster 
集群方式，同服务提供方。

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、全局设置开启令牌验证：
<!--随机token令牌，使用UUID生成-->
<dubbo:provider interface="com.sms.api.service.SendSmsSOAService" token="true" />
<!--固定token令牌，相当于密码-->
<dubbo:provider interface="com.sms.api.service.SendSmsSOAService" token="123456" />
 
2、服务级别设置开启令牌验证：
<!--随机token令牌，使用UUID生成-->
<dubbo:service interface="com.sms.api.service.SendSmsSOAService" token="true" />
<!--固定token令牌，相当于密码-->
<dubbo:service interface="com.sms.api.service.SendSmsSOAService" token="123456" />
 
3、协议级别设置开启令牌验证：
<!--随机token令牌，使用UUID生成-->
<dubbo:protocol name="dubbo" token="true" />
<!--固定token令牌，相当于密码-->
<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"/>