Dubbo Configuration

可配置参数

http://dubbo.apache.org/zh-cn/docs/user/references/xml/introduction.html

与 spring 整合的几种方式

SpringBoot 与 dubbo 整合的三种方式：

http://dubbo.apache.org/zh-cn/docs/user/configuration/annotation.html

1）、导入 dubbo-starter，在 application.properties 中配置属性

	 使用 @Service【暴露服务】使用 @Reference【引用服务】使用 @EnableDubbo【开启扫描，相当于配置 dubbo.scan.base-packages】

http://dubbo.apache.org/zh-cn/docs/user/configuration/xml.html

2）、导入 dubbo-starter，保留 dubbo xml 配置文件（这样可保留方法级别的配置）

	 在启动类上使用 @ImportResource(locations="classpath:dubbo.xml") 导入 dubbo 的配置文件即可

http://dubbo.apache.org/zh-cn/docs/user/configuration/api.html

3）、使用注解 API 的方式，将每一个组件手动创建到容器中,让 dubbo 来扫描其他的组件

API 方式配置例子，使用 @Service【暴露服务】使用 @Reference【引用服务】使用【@EnableDubbo】配置 Dubbo 扫描，开启基于注解的 dubbo 功能

package com.gmall.config;

import java.util.ArrayList;

import java.util.List;

import org.springframework.context.annotation.Bean;

import org.springframework.context.annotation.Configuration;

import com.alibaba.dubbo.config.ApplicationConfig;

import com.alibaba.dubbo.config.MethodConfig;

import com.alibaba.dubbo.config.MonitorConfig;

import com.alibaba.dubbo.config.ProtocolConfig;

import com.alibaba.dubbo.config.ProviderConfig;

import com.alibaba.dubbo.config.RegistryConfig;

import com.alibaba.dubbo.config.ServiceConfig;

import com.gmall.service.UserService;

@EnableDubbo(scanBasePackages="com.gmall")

@Configuration

public class MyDubboConfig {

    @Bean

    public ApplicationConfig applicationConfig() {

        ApplicationConfig applicationConfig = new ApplicationConfig();

        applicationConfig.setName("boot-user-service-provider");

        return applicationConfig;

    }

    //<dubbo:registry protocol="zookeeper" address="127.0.0.1:2181"></dubbo:registry>

    @Bean

    public RegistryConfig registryConfig() {

        RegistryConfig registryConfig = new RegistryConfig();

        registryConfig.setProtocol("zookeeper");

        registryConfig.setAddress("127.0.0.1:2181");

        return registryConfig;

    }

    //<dubbo:protocol name="dubbo" port="20882"></dubbo:protocol>

    @Bean

    public ProtocolConfig protocolConfig() {

        ProtocolConfig protocolConfig = new ProtocolConfig();

        protocolConfig.setName("dubbo");

        protocolConfig.setPort(20882);

        return protocolConfig;

    }

    /**

    <dubbo:service interface="com.gmall.service.UserService" ref="userServiceImpl01" timeout="1000" version="1.0.0">

        <dubbo:method name="getUserAddressList" timeout="1000"/>

    </dubbo:service>

     */

    @Bean

    public ServiceConfig<UserService> userServiceConfig(UserService userService){

        ServiceConfig<UserService> serviceConfig = new ServiceConfig<>();

        serviceConfig.setInterface(UserService.class);

        serviceConfig.setRef(userService);

        serviceConfig.setVersion("1.0.0");

        //配置每一个method的信息

        MethodConfig methodConfig = new MethodConfig();

        methodConfig.setName("getUserAddressList");

        methodConfig.setTimeout(1000);

        //将method的设置关联到service配置中

        List<MethodConfig> methods = new ArrayList<>();

        methods.add(methodConfig);

        serviceConfig.setMethods(methods);

        //ProviderConfig

        //MonitorConfig

        return serviceConfig;

    }

}

配置优先级

http://dubbo.apache.org/zh-cn/docs/user/configuration/configuration-load-process.html

JVM参数配置 > 外部化配置 > 代码配置 > 配置文件（（dubbo.xml || application.properties） > (dubbo.properties 通常写公共属性配置））

启动时检查

http://dubbo.apache.org/zh-cn/docs/user/demos/preflight-check.html

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

<!--关闭某个服务的启动时检查 (没有提供者时报错)-->

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

<!--关闭所有服务的启动时检查 (没有提供者时报错)-->

<dubbo:consumer check="false"/>

<!--关闭注册中心启动时检查 (注册订阅失败时报错)-->

<dubbo:registry check="false"/>

超时设置（timeout），默认为一秒（1000ms）

消费者与提供者之间方法调用的时间，超过则会抛出异常，提供者与消费者都可配置，具体生效依据不同粒度配置的覆盖关系，消费方默认超时时间取自提供方。

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

http://dubbo.apache.org/zh-cn/docs/user/references/xml/dubbo-reference.html

<!--

    1）、精确优先 (方法级优先，接口级次之，全局配置再次之)

    2）、消费者设置优先(如果级别一样，则消费方优先，提供方次之)

-->

<!--提供方设置-->

<dubbo:service interface="org.apache.dubbo.demo.DemoService" ref="demoService" timeout="1000"/>

<!--提供方设置,精确到方法-->

<dubbo:service interface="org.apache.dubbo.demo.DemoService" ref="demoService">

    <dubbo:method name="sayHello" timeout="1000"/>

</dubbo:service>

<!--所有提供方默认设置-->

<dubbo:provider timeout="1000"/>

不同粒度配置的覆盖关系

http://dubbo.apache.org/zh-cn/docs/user/configuration/xml.html

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

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

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

重试次数（retries），默认为 2 ，不包含第一次调用，即一共会调用 3 次

消费方默认重试次数设置取自提供方，设置方式与超时设置类似。

http://dubbo.apache.org/zh-cn/docs/user/references/xml/dubbo-service.html

<!-- retries="":重试次数，不包含第一次调用，0代表不重试

幂等操作（可设置重试次数）【如查询、删除、修改】，执行多少次产生的效果一样

非幂等操作（不能设置重试次数）【如新增】

如果该服务有多个，那么当前服务出错后，会重试其它机器上相同的服务，不会一直调用相同地址上的服务

-->

<!--提供方设置,精确到方法-->

<dubbo:service interface="org.apache.dubbo.demo.DemoService" ref="demoService">

    <dubbo:method name="sayHello" retries="3"/>

</dubbo:service>

多版本设置（灰度发布）

http://dubbo.apache.org/zh-cn/docs/user/demos/multi-versions.html

当一个接口实现，出现不兼容升级时，可以用版本号过渡，版本号不同的服务相互间不引用。

可以按照以下的步骤进行版本迁移：

在低压力时间段，先升级一半提供者为新版本
再将所有消费者升级为新版本
然后将剩下的一半提供者升级为新版本

<!--老版本服务提供者配置-->

<dubbo:service interface="com.foo.BarService" version="1.0.0" />

<!--新版本服务提供者配置-->

<dubbo:service interface="com.foo.BarService" version="2.0.0" />

<!--老版本服务消费者配置-->

<dubbo:reference id="barService" interface="com.foo.BarService" version="1.0.0" />

<!--新版本服务消费者配置-->

<dubbo:reference id="barService" interface="com.foo.BarService" version="2.0.0" />

<!--如果不需要区分版本，可以按照以下的方式配置-->

<dubbo:reference id="barService" interface="com.foo.BarService" version="*" />

本地存根

http://dubbo.apache.org/zh-cn/docs/user/demos/local-stub.html

消费者在调用提供者之前可以做一些操作，来决定要不要调用提供者（就是为具体实现创建一个代理对象）

以之前的 HelloWord 为例，为 DemoService 创建本地存根（一般在接口项目中创建）

package org.apache.dubbo.demo;

public class DemoServiceStub implements DemoService {

    private final DemoService demoService;

    // 构造函数传入真正的远程代理对象

    public DemoServiceStub(DemoService demoService){

        this.demoService = demoService;

    }

    @Override

    public String sayHello(String name) {

        // 此代码在客户端执行, 你可以在客户端做ThreadLocal本地缓存，或预先验证参数是否合法，等等

        try {

            System.out.println("DemoServiceStub.....");

            return demoService.sayHello(name);

        } catch (Exception e) {

            // 你可以容错，可以做任何AOP拦截事项

            return "容错数据";

        }

    }

}

配置，消费方和提供方都可以配置，这里在消费方配置。

<dubbo:reference id="demoService" interface="org.apache.dubbo.demo.DemoService" stub="org.apache.dubbo.demo.consumer.DemoServiceStub"/>

<!--或者-->

<dubbo:reference id="demoService" interface="org.apache.dubbo.demo.DemoService" stub="true"/>