spring配置解析

1、<dubbo:service/>

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

<dubbo:service ref="userService" interface="com.patty.dubbo.api.service.UserService"/>
interface用于指定接口名,ref指定服务引用对象,这两者必填,此外还有一些其他属性可供选择,比如:
group: 服务分组,当一个接口有多个实现,可以用分组区分
timeout: 远程服务调用超时时间(毫秒),默认1000ms
retries: 远程服务调用重试次数,不包括第一次调用,不需要重试请设为0,默认值为2

2、<dubbo:reference/> 

  1) 引用配置,用于创建一个远程服务代理,一个引用可以指向多个注册中心。

<dubbo:reference id="userService" interface="com.patty.dubbo.api.service.UserService"
timeout="10000" retries="3" check="false"/>
id: 服务所引用的bean id, 对应service中ref属性的值
check:启动时检查提供者是否存在,为false表示关闭检查。
<dubbo:consumer check="false" /> 关闭所有服务的检查,没有提供者的时候check值为true报错,false忽略
<dubbo:registry check="false" /> 关闭注册中心启动时检查,注册订阅失败时check值为true报错, false忽略

2)在开发及测试环境下,经常需要绕过注册中心,只测试指定服务提供者,这时候可能需要点对点直连直连服务,通过设置url属性可指定服务提供者地址,多个地址用逗号隔开。
<dubbo:reference id=
"xxxService" interface="com.alibaba.xxx.XxxService" url="dubbo://localhost:20890" />
也可以通过JVM启动参数设置, 如:java -Dcom.alibaba.xxx.XxxService=dubbo://localhost:20890

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

<dubbo:protocol name="${dubbo.protocol.name}" port="${dubbo.protocol.port}"/>
name: 协议名称
port: 服务端口
可选协议有
1) dubbo:// Dubbo缺省协议采用单一长连接和NIO异步通讯,适合于小数据量大并发的服务调用,以及服务消费者机器数远大于服务提供者机器数的情况。
<dubbo:protocol name=“dubbo” port=“9090” server=“netty” client=“netty” codec=“dubbo” serialization=“hessian2” charset=“UTF-8” threadpool=“fixed” threads=“100” queues=“0” iothreads=“9” buffer=“8192” accepts=“1000” payload=“8388608” />
 

      server: 协议的服务器端实现类型

      client:协议的客户端实现类型

      codec: 协议编码方式

  serialization: 协议序列化方式

  threadpool: 线程池类型,可选:fixed/cached

  •  ThreadPool
    • fixed 固定大小线程池,启动时建立线程,不关闭,一直持有。(缺省)
    • cached 缓存线程池,空闲一分钟自动删除,需要时重建。
    • limited 可伸缩线程池,但池中的线程数只会增长不会收缩。(为避免收缩时突然来了大流量引起的性能问题)。

  threads: 服务线程池大小(固定大小),默认100

  accepts: 服务提供者最大可接受连接数

  缺省协议,使用基于mina1.1.7+hessian3.2.1的tbremoting交互。

    •   连接个数:单连接
    •   连接方式:长连接
    •   传输协议:TCP
    •   传输方式:NIO异步传输
    •   序列化:Hessian二进制序列化
    •   适用范围:传入传出参数数据包较小(建议小于100K),消费者比提供者个数多,单一消费者无法压满提供者,尽量不要用dubbo协议传输大文件或超大字符串
    •   适用场景:常规远程服务方法调用

  2) rmi://

  3)hessian://

  4) http:// 

  • 连接个数:多连接
  • 连接方式:短连接
  • 传输协议:HTTP
  • 传输方式:同步传输
  • 序列化:表单序列化
  • 适用范围:传入传出参数数据包大小混合,提供者比消费者个数多,可用浏览器查看,可用表单或URL传入参数,暂不支持传文件。
  • 适用场景:需同时给应用程序和浏览器JS使用的服务。

     可选的server有jetty和servlet.

  5) thrift://

  6) memcached://

  7)redis://

  8) webservice://

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

<dubbo:application name="${dubbo.application.name}"/>

   name:当前应用名称,用于注册中心计算应用间依赖关系,服务方和消费方不必保持一样,该名称不是匹配条件

   version:当前应用的版本

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

1)<dubbo:registry protocol="${dubbo.registry.protocol}" address="${dubbo.registry.address}"/>
protocol: 注同中心地址协议,支持dubbo, http, local三种协议,分别表示,dubbo地址,http地址,本地注册中心
address:注册中心服务器地址,如果地址没有端口缺省为9090,同一集群内的多个地址用逗号分隔,如:ip:port,ip:port,不同集群的注册中心,请配置多个<dubbo:registry>标签

2)为方便开发测试,经常会在线下共用一个所有服务可用的注册中心,这时,如果一个正在开发中的服务提供者注册,可能会影响消费者不能正常运行。可以让服务提供者开发方,只订阅服务(开发的服务可能依赖其它服务),而不注册正在开发的服务,通过直连测试正在开发的服务。
<
dubbo:registry address="10.20.153.10:9090" register="false" />
3)同样设置属性subscribe="false",则服务提供方将不进行订阅操作。

6、其他的一些配置项

  • <dubbo:module/> 模块配置,用于配置当前模块信息,可选。
  • <dubbo:monitor/> 监控中心配置,用于配置连接监控中心相关信息,可选。
  • <dubbo:provider/> 提供方的缺省值,当ProtocolConfig和ServiceConfig某属性没有配置时,采用此缺省值,可选。
  • <dubbo:consumer/> 消费方缺省配置,当ReferenceConfig某属性没有配置时,采用此缺省值,可选。
  • <dubbo:method/> 方法配置,用于ServiceConfig和ReferenceConfig指定方法级的配置信息。
  • <dubbo:argument/> 用于指定方法参数配置。

7、配置优先级

  • 上图中以timeout为例,显示了配置的查找顺序,其它retries, loadbalance, actives等类似。
    • 方法级优先,接口级次之,全局配置再次之。
    • 如果级别一样,则消费方优先,提供方次之。
  • 其中,服务提供方配置,通过URL经由注册中心传递给消费方。
  • 建议由服务提供方设置超时,因为一个方法需要执行多长时间,服务提供方更清楚,如果一个消费方同时引用多个服务,就不需要关心每个服务的超时设置。
  • 理论上ReferenceConfig的非服务标识配置,在ConsumerConfig,ServiceConfig, ProviderConfig均可以缺省配置。

8、属性配置方式

1)dubbo.properties文件

如果公共配置很简单,没有多注册中心,多协议等情况,或者想多个Spring容器想共享配置,可以使用dubbo.properties作为缺省配置

Dubbo将自动加载classpath根目录下的dubbo.properties,可以通过JVM启动参数:-Ddubbo.properties.file=xxx.properties 改变缺省配置位置

覆盖策略:

  • JVM启动-D参数优先,这样可以使用户在部署和启动时进行参数重写,比如在启动时需改变协议的端口。
  • XML次之,如果在XML中有配置,则dubbo.properties中的相应配置项无效。
  • Properties最后,相当于缺省值,只有XML没有配置时,dubbo.properties的相应配置项才会生效,通常用于共享公共配置,比如应用名。

2)注解配置

服务提供方注解:

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" />

3)API配置,不推荐

 

9、多协议服务配置

实际应用中, 不同服务在性能上适用不同协议进行传输,比如大数据用短连接协议,小数据大并发用长连接协议。

    <!-- 多协议配置 -->
    <dubbo:protocol name="dubbo" port="20880" />
    <dubbo:protocol name="rmi" port="1099" />
 
    <!-- 使用dubbo协议暴露服务 -->
    <dubbo:service interface="com.alibaba.hello.api.HelloService" version="1.0.0" ref="helloService" protocol="dubbo" />
    <!-- 使用rmi协议暴露服务 -->
    <dubbo:service interface="com.alibaba.hello.api.DemoService" version="1.0.0" ref="demoService" protocol="rmi" />
当然也可以同一服务使用多协议暴露出去,如:
<!-- 使用多个协议暴露服务 -->
    <dubbo:service id="helloService" interface="com.alibaba.hello.api.HelloService" version="1.0.0" protocol="dubbo,rmi" />
 
10、多注册中心
    <!-- 多注册中心配置 -->
    <dubbo:registry id="hangzhouRegistry" address="10.20.141.150:9090" />
    <dubbo:registry id="qingdaoRegistry" address="10.20.141.151:9010" default="false" />
 
    <!-- 同一服务向多个注册中心注册 -->
    <dubbo:service interface="com.alibaba.hello.api.HelloService" version="1.0.0" ref="helloService" registry="hangzhouRegistry,qingdaoRegistry" />
    
    <!-- 不同服务向不同的注册中心注册 -->
    <!-- 向中文站注册中心注册 -->
    <dubbo:service interface="com.alibaba.hello.api.TestService" version="1.0.0" ref="testService" registry="chinaRegistry" />
 
    <!-- 向国际站注册中心注册 -->
    <dubbo:service interface="com.alibaba.hello.api.DemoService" version="1.0.0" ref="demoService" registry="intlRegistry" />
 
11、服务分组与聚合
当一个接口有多个实现的时候,可以用group进行分组。例如,我们对第一节的UserService接口,再写一个mock数据的实现
/**
 * Version: 3.0
 * Author: pattywgm
 * Time: 17/6/28 下午11:14
 * Desc: UserService的另一个实现类,用来测试同一接口多个实现的情况下,将服务进行分组group
 */
@Service("anotherUserService")
public class AnotherUserServiceImpl implements UserService {

    public AnotherUserServiceImpl(){

    }

    @Override
    public List<UserVo> findAllUsers() {
        ArrayList<UserVo> userVos = new ArrayList<UserVo>();
        userVos.add(new UserVo("10", "patty", 23, "13812931251"));
        userVos.add(new UserVo("11", "jack", 22, "18719092278"));
        return userVos;
    }

    @Override
    public UserVo findUserById(String id) {
        return new UserVo("15", "rose", 22, "17712013366");
    }
}

然后,注册该服务,并对其与之前的服务分别进行分组

 <dubbo:service ref="userService" group="db" interface="com.patty.dubbo.api.service.UserService"/>

 <dubbo:service ref="anotherUserService" group="mock" interface="com.patty.dubbo.api.service.UserService"/>

在消费方,我们可以根据分组来调用相应的服务,有两种方式:

一是指定某个特定的分组:

<dubbo:reference id="userService" group="db" interface="com.patty.dubbo.api.service.UserService"  timeout="10000" retries="3" mock="true"/>

比如测试代码中,调用db组,是从数据库取数据,得到结果如下:

二是指定任意组,调用时只会调用其中一个可用组的实现。

<dubbo:reference id="userService" group="*" interface="com.patty.dubbo.api.service.UserService"  timeout="10000" retries="3" mock="true"/>

示例代码运行结果,调用的是mock组的实现,输出结果如下:

 

如果想要是的所有分组的实现都被调用(当然,我们也可以通过group="db,mock"指定特定的分组),可以在<dubbo: reference>中设置merger="true",表示调用所有指定分组的实现,并将各个分组的结果合并作为最终结果,比如:

<dubbo:reference id="userService" group="db,mock" interface="com.patty.dubbo.api.service.UserService"
timeout="10000" retries="3" mock="true" merger="true"/>

输出结果为:

此时, 我们的设置是对所调用服务的所有方法,都合并结果,dubbo为我们提供了方法级别的merger,即可以指定只合并多个分组的特定方法,或者只对某个特定方法不合并最终结果。配置方式如下:

<dubbo:reference id="userService" group="*" interface="com.patty.dubbo.api.service.UserService"
timeout="10000" retries="3" mock="true">
<!-- 指定findAllUsers方法结果合并, 其他方法将只调用某个group的可用实现-->
<dubbo:method name="findAllUsers" merger="true">
</dubbo:method>
</dubbo:reference>
<!-- 指定所有分组的所有方法,除了findUserById 方法外,都合并结果 -->

<dubbo:reference id="userService" group="*" interface="com.patty.dubbo.api.service.UserService"

timeout="10000" retries="3" mock="true" merger="true">
    <dubbo:method name="findUserById" merger="false">
</dubbo:method>
</dubbo:reference>
posted on 2017-06-27 17:38  pattywgm  阅读(695)  评论(0编辑  收藏  举报