初识Dubbo 系列之6-Dubbo 配置

Posted 2020-09-16 yangykaifa

配置

Xml配置

配置项说明 具体配置项，请參见：配置參考手冊 (+)

API使用说明 假设不想使用Spring配置。而希望通过API的方式进行调用，请參见：API配置 (+)

配置使用说明 想知道怎样使用配置。请參见：高速启动 (+)

演示样例：

provider.xml

<? xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans"     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"     xmlns:dubbo="http://code.alibabatech.com/schema/dubbo"     xsi:schemaLocation="http://www.springframework.org/schema/beans        http://www.springframework.org/schema/beans/spring-beans.xsd        http://code.alibabatech.com/schema/dubbo        http://code.alibabatech.com/schema/dubbo/dubbo.xsd">       <dubbo:application name="hello-world-app"  />       <dubbo:registry address="multicast://224.5.6.7:1234" />       <dubbo:protocol name="dubbo" port="20880" />       <dubbo:service interface="com.alibaba.dubbo.demo.DemoService" ref="demoServiceLocal" />       <dubbo:reference id="demoServiceRemote" interface="com.alibaba.dubbo.demo.DemoService" />   </beans>

全部标签者支持自己定义參数，用于不同扩展点实现的特殊配置。

如：

<dubbo:protocol name="jms">     <dubbo:parameter key="queue" value="http://10.20.160.198/wiki/display/dubbo/10.20.31.22" /> </dubbo:protocol>

或：(2.1.0開始支持)

注意声明：xmlns:p="http://www.springframework.org/schema/p"

<beans xmlns="http://www.springframework.org/schema/beans"     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"     xmlns:dubbo="http://code.alibabatech.com/schema/dubbo"     xmlns:p="http://www.springframework.org/schema/p"     xsi:schemaLocation="http://www.springframework.org/schema/beans        http://www.springframework.org/schema/beans/spring-beans.xsd        http://code.alibabatech.com/schema/dubbo        http://code.alibabatech.com/schema/dubbo/dubbo.xsd">       <dubbo:protocol name="jms" p:queue="http://10.20.160.198/wiki/display/dubbo/10.20.31.22" />   </beans>

Configuration Relation:

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

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

• <dubbo:protocol/> 协议配置，用于配置提供服务的协议信息，协议由提供方指定。消费方被动接受。
• <dubbo:application/> 应用配置，用于配置当前应用信息，无论该应用是提供者还是消费者。
• <dubbo:module/> 模块配置，用于配置当前模块信息。可选。

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

• <dubbo:monitor/> 监控中心配置。用于配置连接监控中心相关信息，可选。
• <dubbo:provider/> 提供方的缺省值，当ProtocolConfig和ServiceConfig某属性没有配置时，採用此缺省值，可选。

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

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

Configuration Override:

• 上图中以timeout为例，显示了配置的查找顺序，其他retries, loadbalance, actives等类似。
  • 方法级优先。接口级次之，全局配置再次之。
  • 假设级别一样，则消费方优先，提供方次之。
• 当中。服务提供方配置，通过URL经由注冊中心传递给消费方。

• 建议由服务提供方设置超时。由于一个方法须要运行多长时间，服务提供方更清楚。假设一个消费方同一时候引用多个服务，就不须要关心每一个服务的超时设置。
• 理论上ReferenceConfig的非服务标识配置，在ConsumerConfig，ServiceConfig, ProviderConfig均能够缺省配置。

属性配置

假设公共配置非常easy，没有多注冊中心。多协议等情况。或者想多个Spring容器想共享配置，能够使用dubbo.properties作为缺省配置。

Dubbo将自己主动载入classpath根文件夹下的dubbo.properties，能够通过JVM启动參数：-Ddubbo.properties.file=xxx.properties 改变缺省配置位置。

假设classpath根文件夹下存在多个dubbo.properties，比方多个jar包中有dubbo.properties，Dubbo会随意载入。并打印Error日志，兴许可能改为抛异常。

映射规则：

• 将XML配置的标签名，加属性名，用点分隔，多个属性拆成多行：
  • 比方：dubbo.application.name=foo等价于<dubbo:application name="foo" />
  • 比方：dubbo.registry.address=10.20.153.10:9090等价于<dubbo:registry address="10.20.153.10:9090" />
• 假设XML有多行同名标签配置，可用id号区分，假设没有id号将对全部同名标签生效：
  • 比方：dubbo.protocol.rmi.port=1234等价于<dubbo:protocol id="rmi" name="rmi" port="1099" /> (协议的id没配时，缺省使用协议名作为id)
  • 比方：dubbo.registry.china.address=10.20.153.10:9090等价于<dubbo:registry id="china" address="10.20.153.10:9090" />

典型配置如：

dubbo.properties

dubbo.application.name=foo dubbo.application.owner=bar dubbo.registry.address=10.20.153.10:9090

覆盖策略：

• JVM启动-D參数优先，这样能够使用户在部署和启动时进行參数重写，比方在启动时需改变协议的port。

• XML次之，假设在XML中有配置，则dubbo.properties中的对应配置项无效。
• Properties最后，相当于缺省值，仅仅有XML没有配置时，dubbo.properties的对应配置项才会生效，通经常使用于共享公共配置，比方应用名。

注解配置

2.2.1以上版本号支持

服务提供方注解：

import com.alibaba.dubbo.config.annotation.Service;   @Service(version="1.0.0") public class FooServiceImpl implements FooService {       // ......   }

服务提供方配置：

<!-- 公共信息。也能够用dubbo.properties配置 --> <dubbo:application name="annotation-provider" /> <dubbo:registry address="127.0.0.1:4548" />   <!-- 扫描注解包路径。多个包用逗号分隔，不填pacakge表示扫描当前ApplicationContext中全部的类 --> <dubbo:annotation package="com.foo.bar.service" />

服务消费方注解：

import com.alibaba.dubbo.config.annotation.Reference; import org.springframework.stereotype.Component;   @Component public class BarAction {       @Reference(version="1.0.0")     private FooService fooService;   }

服务消费方配置：

<!-- 公共信息，也能够用dubbo.properties配置 --> <dubbo:application name="annotation-consumer" /> <dubbo:registry address="127.0.0.1:4548" />   <!-- 扫描注解包路径，多个包用逗号分隔，不填pacakge表示扫描当前ApplicationContext中全部的类 --> <dubbo:annotation package="com.foo.bar.action" />

也能够使用：(等价于前面的：<dubbo:annotation package="com.foo.bar.service" />)

<dubbo:annotation /> <context:component-scan base-package="com.foo.bar.service">     <context:include-filter type="annotation" expression="com.alibaba.dubbo.config.annotation.Service" /> </context:component-scan>

Spring2.5及以后版本号支持component-scan。假设用的是Spring2.0及曾经版本号。需配置： <!-- Spring2.0支持@Service注解配置。但不支持package属性自己主动载入bean的实例。需人工定义bean的实例。 --> <dubbo:annotation /> <bean id="barService" class="com.foo.BarServiceImpl" />

API配置

API使用范围 API仅用于OpenAPI, ESB, Test, Mock等系统集成，普通服务提供方或消费方，请採用配置方式使用Dubbo，请參见：Xml配置 (+)

API属性含义參考 API属性与配置项一对一。各属性含义。请參见：配置參考手冊 (+)， 比方：ApplicationConfig.setName("xxx") 相应 <dubbo:application name="xxx" />

(1) 服务提供者：

import com.alibaba.dubbo.rpc.config.ApplicationConfig; import com.alibaba.dubbo.rpc.config.RegistryConfig; import com.alibaba.dubbo.rpc.config.ProviderConfig; import com.alibaba.dubbo.rpc.config.ServiceConfig; import com.xxx.XxxService; import com.xxx.XxxServiceImpl;   // 服务实现 XxxService xxxService = new XxxServiceImpl();   // 当前应用配置 ApplicationConfig application = new ApplicationConfig(); application.setName("xxx");   // 连接注冊中心配置 RegistryConfig registry = new RegistryConfig(); registry.setAddress("10.20.130.230:9090"); registry.setUsername("aaa"); registry.setPassword("bbb");   // 服务提供者协议配置 ProtocolConfig protocol = new ProtocolConfig(); protocol.setName("dubbo"); protocol.setPort(12345); protocol.setThreads(200);   // 注意：ServiceConfig为重对象，内部封装了与注冊中心的连接，以及开启服务port   // 服务提供者暴露服务配置 ServiceConfig<XxxService> service = new ServiceConfig<XxxService>(); // 此实例非常重，封装了与注冊中心的连接，请自行缓存，否则可能造成内存和连接泄漏 service.setApplication(application); service.setRegistry(registry); // 多个注冊中心能够用setRegistries() service.setProtocol(protocol); // 多个协议能够用setProtocols() service.setInterface(XxxService.class); service.setRef(xxxService); service.setVersion("1.0.0");   // 暴露及注冊服务 service.export();

(2) 服务消费者：

import com.alibaba.dubbo.rpc.config.ApplicationConfig; import com.alibaba.dubbo.rpc.config.RegistryConfig; import com.alibaba.dubbo.rpc.config.ConsumerConfig; import com.alibaba.dubbo.rpc.config.ReferenceConfig; import com.xxx.XxxService;   // 当前应用配置 ApplicationConfig application = new ApplicationConfig(); application.setName("yyy");   // 连接注冊中心配置 RegistryConfig registry = new RegistryConfig(); registry.setAddress("10.20.130.230:9090"); registry.setUsername("aaa"); registry.setPassword("bbb");   // 注意：ReferenceConfig为重对象。内部封装了与注冊中心的连接，以及与服务提供方的连接   // 引用远程服务 ReferenceConfig<XxxService> reference = new ReferenceConfig<XxxService>(); // 此实例非常重，封装了与注冊中心的连接以及与提供者的连接，请自行缓存。否则可能造成内存和连接泄漏 reference.setApplication(application); reference.setRegistry(registry); // 多个注冊中心能够用setRegistries() reference.setInterface(XxxService.class); reference.setVersion("1.0.0");   // 和本地bean一样使用xxxService XxxService xxxService = reference.get(); // 注意：此代理对象内部封装了全部通讯细节，对象较重，请缓存复用

(3) 特殊场景

注：以下仅仅列出不同的地方，其他參见上面的写法

(3.1) 方法级设置：

...   // 方法级配置 List<MethodConfig> methods = new ArrayList<MethodConfig>(); MethodConfig method = new MethodConfig(); method.setName("createXxx"); method.setTimeout(10000); method.setRetries(0); methods.add(method);   // 引用远程服务 ReferenceConfig<XxxService> reference = new ReferenceConfig<XxxService>(); // 此实例非常重，封装了与注冊中心的连接以及与提供者的连接，请自行缓存。否则可能造成内存和连接泄漏 ... reference.setMethods(methods); // 设置方法级配置   ...

(3.2) 点对点直连：

...   ReferenceConfig<XxxService> reference = new ReferenceConfig<XxxService>(); // 此实例非常重，封装了与注冊中心的连接以及与提供者的连接。请自行缓存，否则可能造成内存和连接泄漏 // 假设点对点直连，能够用reference.setUrl()指定目标地址，设置url后将绕过注冊中心， // 当中，协议相应provider.setProtocol()的值。port相应provider.setPort()的值， // 路径相应service.setPath()的值，假设未设置path。缺省path为接口名 reference.setUrl("dubbo://10.20.130.230:20880/com.xxx.XxxService");   ...