SpringBoot | 第二十九章：Dubbo的集成和使用-白红宇

SpringBoot | 第二十九章：Dubbo的集成和使用

阅读量：5036 次

发布时间：2019-06-12

本文共 8399 字，大约阅读时间需要 27 分钟。

前言

今年年初时，阿里巴巴开源的高性能服务框架dubbo又开始了新一轮的更新，还加入了Apache孵化器。原先项目使用了spring cloud之后，已经比较少用dubbo。目前又抽调回原来的行业应用部门，可能还会使用dubbo进行服务调用。趁着编写教材的机会来进行学习下。而且目前Dubbo也出了springboot的starter项目了，借着SpringBoot的东风，集成起来很方便，基本上就一个依赖包引入的问题了。废话不多说，开始吧~

一点知识

对于没有接触过Dubbo的同学，可以先了解下相关知识。

Dubbo简介

Dubbo 是阿里巴巴公司一个开源的高性能服务框架，致力于提供高性能和透明化的 RPC 远程服务调用方案，以及 SOA 服务治理方案，使得应用可通过高性能 RPC 实现服务的输出、输入功能和 Spring 框架无缝集成。Dubbo 包含远程通讯、集群容错和自动发现三个核心部分。

它提供透明化的远程方法调用，实现像调用本地方法一样调用远程方法，只需简单配置，没有任何 API 侵入。同时它具备软负载均衡及容错机制，可在内网替代 F5 等硬件负载均衡器，降低成本，减少单点。它可以实现服务自动注册与发现，不再需要写死服务提供方地址，注册中心基于接口名查询服务提供者的 IP 地址，并且能够平滑添加或删除服务提供者。

2011 年末，阿里巴巴在 GitHub 上开源了基于 Java 的分布式服务治理框架 Dubbo，之后它成为了国内该类开源项目的佼佼者，许多开发者对其表示青睐。同时，先后有不少公司在实践中基于 Dubbo 进行分布式系统架构。目前在 GitHub 上，它的 fork、star 数均已破万。

Dubbo核心功能:

远程通讯，提供对多种基于长连接的 NIO 框架抽象封装，包括多种线程模型，序列化，以及“请求-响应”模式的信息交换方式。

集群容错，提供基于接口方法的透明远程过程调用，包括多协议支持，以及软负载均衡，失败容错，地址路由，动态配置等集群支持。

自动发现，基于注册中心目录服务，使服务消费方能动态的查找服务提供方，使地址透明，使服务提供方可以平滑增加或减少机器。

Dubbo架构

服务提供者 - 启动时在指定端口上暴露服务，并将服务地址和端口注册到注册中心上

服务消费者 - 启动时向注册中心订阅自己感兴趣的服务，以便获得服务提供方的地址列表

注册中心 - 负责服务的注册和发现，负责保存服务提供方上报的地址信息，并向服务消费方推送

监控中心 - 负责收集服务提供方和消费方的运行状态，比如服务调用次数、延迟等，用于监控

运行容器 - 负责服务提供方的初始化、加载以及运行的生命周期管理

dubbo-architecture

部署阶段

服务提供者在指定端口暴露服务，并向注册中心注册服务信息。

服务消费者向注册中心发起服务地址列表的订阅。

运行阶段

注册中心向服务消费者推送地址列表信息。

服务消费者收到地址列表后，从其中选取一个向目标服务发起调用。

调用过程服务消费者和服务提供者的运行状态上报给监控中心。

调用关系说明

服务容器负责启动，加载，运行服务提供者。

服务提供者在启动时，向注册中心注册自己提供的服务。

服务消费者在启动时，向注册中心订阅自己所需的服务。

注册中心返回服务提供者地址列表给消费者，如果有变更，注册中心将基于长连接推送变更数据给消费者。

服务消费者，从提供者地址列表中，基于软负载均衡算法，选一台提供者进行调用，如果调用失败，再选另一台调用。

服务消费者和提供者，在内存中累计调用次数和调用时间，定时每分钟发送一次统计数据到监控中心。

Dubbo特点

Dubbo 架构具有以下几个特点，分别是连通性、健壮性、伸缩性、以及向未来架构的升级性。

连通性

注册中心负责服务地址的注册与查找，相当于目录服务，服务提供者和消费者只在启动时与注册中心交互，注册中心不转发请求，压力较小

监控中心负责统计各服务调用次数，调用时间等，统计先在内存汇总后每分钟一次发送到监控中心服务器，并以报表展示

服务提供者向注册中心注册其提供的服务，并汇报调用时间到监控中心，此时间不包含网络开销

服务消费者向注册中心获取服务提供者地址列表，并根据负载算法直接调用提供者，同时汇报调用时间到监控中心，此时间包含网络开销

注册中心，服务提供者，服务消费者三者之间均为长连接，监控中心除外

注册中心通过长连接感知服务提供者的存在，服务提供者宕机，注册中心将立即推送事件通知消费者

注册中心和监控中心全部宕机，不影响已运行的提供者和消费者，消费者在本地缓存了提供者列表

注册中心和监控中心都是可选的，服务消费者可以直连服务提供者

健壮性

监控中心宕掉不影响使用，只是丢失部分采样数据

数据库宕掉后，注册中心仍能通过缓存提供服务列表查询，但不能注册新服务

注册中心对等集群，任意一台宕掉后，将自动切换到另一台

注册中心全部宕掉后，服务提供者和服务消费者仍能通过本地缓存通讯

服务提供者无状态，任意一台宕掉后，不影响使用

服务提供者全部宕掉后，服务消费者应用将无法使用，并无限次重连等待服务提供者恢复

伸缩性

注册中心为对等集群，可动态增加机器部署实例，所有客户端将自动发现新的注册中心

服务提供者无状态，可动态增加机器部署实例，注册中心将推送新的服务提供者信息给消费者

升级性

当服务集群规模进一步扩大，带动IT治理结构进一步升级，需要实现动态部署，进行流动计算，现有分布式服务架构不会带来阻力。下图是未来可能的一种架构：

dubbo-architucture-futures

节点角色说明

节点	角色说明
`Deployer`	自动部署服务的本地代理
`Repository`	仓库用于存储服务应用发布包
`Scheduler`	调度中心基于访问压力自动增减服务提供者
`Admin`	统一管理控制台
`Registry`	服务注册与发现的注册中心
`Monitor`	统计服务的调用次数和调用时间的监控中心

大家可访问官网文档：，里面有详细说明和使用说明的。这里就不再阐述了。

Dubbo集成和使用

基于官方的incubator-dubbo-spring-boot-project项目，在SpringBoot中集成起来很简单。

注意：由于本系列还是使用1.5.x版本进行讲解，所以使用的版本为0.1.x。若使用SpringBoot2.x的同学，可以使用0.2.x版本。

官方说明

这里为了方便，直接创建了一个接口工程，spring-boot-dubbo-api。

IHelloService.java

/** * 定义一个接口 * @author oKong * */public interface IHelloService {        String hello(String name);}

服务提供者

创建一个spring-boot-dubbo-provider工程。

0.引入pom依赖。


            
                
     
      cn.lqdev.learning
                 
     
      spring-boot-dubbo-api
                 
     
      0.0.1-SNAPSHOT
             
            
            
                
     
      com.alibaba.boot
                 
     
      dubbo-spring-boot-starter
                 
     
      0.1.1
             
            
            
                
     
      org.springframework.boot
                 
     
      spring-boot-starter-data-redis

注意：这里直接选用了redis作为注册中心使用。默认是zookeeper。

1.编写接口实现类。

HelloServiceImpl.java

/** * 定义一个服务实现类 * @author oKong * */// 这里注意 此类@service是dubbo的@Service(        version = "${demo.service.version}", //版本        application = "${dubbo.application.id}", //应用ID        protocol = "${dubbo.protocol.id}", //协议id        registry = "${dubbo.registry.id}")//注册中心id@Slf4jpublic class HelloServiceImpl implements IHelloService {        @Override    public String hello(String name) {        log.info("dubbo提供者，参数name:{}", name);        return "hello " + name + ",this is a dubbo provider!";    }}

说明下：这里的@Service是包路径com.alibaba.dubbo.config.annotation.Service下的注解类，其指定了接口版本、协议id、注册中心id等基本信息。这里注意还是版本号有用，因为会一个接口多版本共存问题，所以一般上都会设置版本信息的。

2.设置配置文件信息，添加dubbo相关信息，比如注册中心类型，地址等。

# 应用名称 便于识别dubbo.application.id=spring-boot-dubbo-providerdubbo.application.name=spring-boot-dubbo-providerserver.port=8686# 设置版本demo.service.version=1.0.0#协议 可选dubbo redis、http、thrift等dubbo.protocol.id=dubbodubbo.protocol.name=dubbodubbo.protocol.port=20880#设置扫描路径 被注解@service和@Reference 等dubbo.scan.basePackages=cn.lqdev.learning.springboot.dubbo.provider.service# 注册中心配置dubbo.registry.id=okong-registry#注册中心类型 这里使用redis作为注册中心# zookeeper://127.0.0.1:2181dubbo.registry.address=redis://127.0.0.1:6379# 设置用户名密码 若有的话#dubbo.registry.username=oKong#dubbo.registry.password=oKong# 设置redis参数# 连接池中的最大空闲连接dubbo.registry.parameters.max.idle=8# 连接池最大连接数（使用负值表示没有限制）dubbo.registry.parameters.max-active=8# 连接池最大阻塞等待时间（使用负值表示没有限制）dubbo.registry.parameters.max-wait=-1# 连接池中的最大空闲连接dubbo.registry.parameters.max-idle=8# 连接池中的最小空闲连接dubbo.registry.parameters.min-idle=0

注意：这里为了方便，直接使用了Redis作为了注册中心。对于redis连接相关配置参数，可以通过dubbo.registry.parameters.xxx的形式来进行设置，由于parameters是个Map对象，所以添加的key是不会进行大小写转换的，填写了什么就是什么。具体的registry配置对象，可以查看com.alibaba.dubbo.config.RegistryConfig类。而对于redis相关参数配置，可以查看com.alibaba.dubbo.registry.redis.RedisRegistry类。

RedisRegistry

其他的注册中心，也是类似的，大家可在包com.alibaba.dubbo.registry找到都要的注册中心配置类。

3.启动类编写。

DubboProviderApplication.java

/** * dubbo-提供者 * @author oKong * */@SpringBootApplication@Slf4jpublic class DubboProviderApplication {    public static void main(String[] args) throws Exception {        //由于dubbo提供者只是单纯提供服务的 可以为一个非web环境        new SpringApplicationBuilder(DubboProviderApplication.class).web(false).run(args);        log.info("spring-boot-dubbo-provider启动!");    }}

4.启动应用，可以访问下redis服务，可以看见已经有服务列表信息了。

redis

服务消费者

创建spring-boot-dubbo-consumer工程。

0.引入pom依赖


            
                
     
      cn.lqdev.learning
                 
     
      spring-boot-dubbo-api
                 
     
      0.0.1-SNAPSHOT
             
            
            
                
     
      com.alibaba.boot
                 
     
      dubbo-spring-boot-starter
                 
     
      0.1.1
             
            
            
                
     
      org.springframework.boot
                 
     
      spring-boot-starter-data-redis
             
            
                
     
      org.springframework.boot
                 
     
      spring-boot-starter-web

1.配置文件添加注册中心及服务版本相关信息

# 应用名称 便于识别dubbo.application.id=spring-boot-dubbo-consumerdubbo.application.name=spring-boot-dubbo-consumerserver.port=9696#设置扫描路径 被注解@service和@Reference 等dubbo.scan.basePackages=cn.lqdev.learning.springboot.dubbo.consumer# 注册中心配置dubbo.registry.id=okong-registry#注册中心类型 这里使用redis作为注册中心# zookeeper://127.0.0.1:2181dubbo.registry.address=redis://127.0.0.1:6379# 设置用户名密码 若有的话#dubbo.registry.username=oKong#dubbo.registry.password=oKong# 设置redis参数# 连接池中的最大空闲连接dubbo.registry.parameters.max.idle=8# 连接池最大连接数（使用负值表示没有限制）dubbo.registry.parameters.max-active=8# 连接池最大阻塞等待时间（使用负值表示没有限制）dubbo.registry.parameters.max-wait=-1# 连接池中的最大空闲连接dubbo.registry.parameters.max-idle=8# 连接池中的最小空闲连接dubbo.registry.parameters.min-idle=0

2.启动类编写

DubboConsumerApplication.java

/** * dubbo-消费者实例 * @author oKong * */@SpringBootApplication@Slf4jpublic class DubboConsumerApplication {        public static void main(String[] args) throws Exception {        SpringApplication.run(DubboConsumerApplication.class, args);        log.info("spring-boot-dubbo-consumer启动!");    }}

3.编写一个restapi接口服务，进行服务调用。

/** * 调用实例 * @author oKong * */@RestController@Slf4jpublic class DemoController {    /**     * 申明为一个reference，其实就是设置一个bean类了，     * 将原来xml配置替换成注解而已     * 
         */    @Reference(version = "1.0.0")    IHelloService helloService;        @GetMapping("/hello")    public String hello(String name) {        log.info("调用提供者服务，参数name：{}", name);        return helloService.hello(name);    }}

4.启动应用，访问：http://127.0.0.1:9696/hello?name=oKong ，可以看见服务调用成功了。

服务调用