Dubbo 2.7.7 学习笔记 1

Dubbo 2.7.7 起步入门学习笔记

本文档基于 Dubbo 中文官方文档编写，详情请参见 Dubbo 中文官方文档

Dubbo 产生的背景

随着互联网的发展，网站应用的规模不断扩大，常规的垂直应用架构已无法应对，分布式服务架构以及流动计算架构势在必行，亟需一个治理系统确保架构有条不紊的演进。

image

单一应用架构

当网站流量很小时，只需一个应用，将所有功能都部署在一起，以减少部署节点和成本。此时，用于简化增删改查工作量的数据访问框架 (ORM) 是关键。

垂直应用架构

当访问量逐渐增大，单一应用增加机器带来的加速度越来越小，提升效率的方法之一是将应用拆成互不相干的几个应用，以提升效率。此时，用于加速前端页面开发的 Web 框架 (MVC) 是关键。

分布式服务架构

当垂直应用越来越多，应用之间交互不可避免，将核心业务抽取出来，作为独立的服务，逐渐形成稳定的服务中心，使前端应用能更快速的响应多变的市场需求。此时，用于提高业务复用及整合的分布式服务框架 (RPC) 是关键。

流动计算架构

当服务越来越多，容量的评估，小服务资源的浪费等问题逐渐显现，此时需增加一个调度中心基于访问压力实时管理集群容量，提高集群利用率。此时，用于提高机器利用率的资源调度和治理中心 (SOA) 是关键。

Dubbo 的架构

dubbo-architucture

各节点的说明

节点	角色说明
Provider	暴露服务的服务提供方
Consumer	调用远程服务的服务消费方
Registry	服务注册与发现的注册中心
Monitor	统计服务的调用次数和调用时间的监控中心
Container	服务运行容器

调用关系说明

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

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

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

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

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

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

Dubbo 架构具有以下几个特点

Dubbo架构所拥有的特点分别是连通性、健壮性、伸缩性、以及向未来架构的升级性。

连通性

• 注册中心负责服务地址的注册与查找，相当于目录服务，服务提供者和消费者只在启动时与注册中心交互，注册中心不转发请求，压力较小
• 监控中心负责统计各服务调用次数，调用时间等，统计先在内存汇总后每分钟一次发送到监控中心服务器，并以报表展示
• 服务提供者向注册中心注册其提供的服务，并汇报调用时间到监控中心，此时间不包含网络开销
• 服务消费者向注册中心获取服务提供者地址列表，并根据负载算法直接调用提供者，同时汇报调用时间到监控中心，此时间包含网络开销
• 注册中心，服务提供者，服务消费者三者之间均为长连接，监控中心除外
• 注册中心通过长连接感知服务提供者的存在，服务提供者宕机，注册中心将立即推送事件通知消费者
• 注册中心和监控中心全部宕机，不影响已运行的提供者和消费者，消费者在本地缓存了提供者列表
• 注册中心和监控中心都是可选的，服务消费者可以直连服务提供者

健壮性

• 监控中心宕掉不影响使用，只是丢失部分采样数据
• 数据库宕掉后，注册中心仍能通过缓存提供服务列表查询，但不能注册新服务
• 注册中心对等集群，任意一台宕掉后，将自动切换到另一台
• 注册中心全部宕掉后，服务提供者和服务消费者仍能通过本地缓存通讯
• 服务提供者无状态，任意一台宕掉后，不影响使用
• 服务提供者全部宕掉后，服务消费者应用将无法使用，并无限次重连等待服务提供者恢复

伸缩性

• 注册中心为对等集群，可动态增加机器部署实例，所有客户端将自动发现新的注册中心
• 服务提供者无状态，可动态增加机器部署实例，注册中心将推送新的服务提供者信息给消费者

Dubbo 前期准备

Zookeeper 安装

1. zookeeper的 windows 安装

   • 下载 zookeeper 3.6.2并解压

2. 配置 zookeeper配置文件

   • 打开 conf目录下将 zoo_sample.cfg 配置文件复制并重命名为 zoo.cfg 配置文件
   • 修改配置文件

   # AdminServer 占用了 8080 端口，将其改用为9999
   admin.serverPort=9999
   # 这里原来是 Linux 中的路径显示，改为 window 路径并且需要手动创建 tmp_data 文件夹
   dataDir=../tmp_data
   

3. 运行 zookeeper服务器

   • 在 bin目录下通过命令启动 zookeeper服务

   xxx\zookeeper\apache-zookeeper-3.6.2-bin\apache-zookeeper-3.6.2-bin\bin> zkServer.cmd
   

4. 运行 zookeeper客户端

   • 在 bin目录下通过命令启动 zookeeper客户端

   xxx\zookeeper\apache-zookeeper-3.6.2-bin\apache-zookeeper-3.6.2-bin\bin> zkCli.cmd
   

   • 启动后输入命令显示如下表示成功
   image

dubbo-admin 安装

1. 下载 dubbo-admin

   • 通过 Git下载

     git clone https://github.com/apache/dubbo-admin.git

   • 通过 GitHub 下载

2. 修改 dubbo-admin-server 配置文件

   • 进入 dubbo-admin 的 dubbo-admin-server 目录中

   cd dubbo-admin/dubbo-admin-server
   

   • 修改 dubbo-admin-server\src\main\resources\application.properties 配置文件

   # centers in dubbo2.7
   admin.registry.address=zookeeper://127.0.0.1:2181
   admin.config-center=zookeeper://127.0.0.1:2181
   admin.metadata-report.address=zookeeper://127.0.0.1:2181
   

3. 将 dubbo-admin-server 进行打包

   • 使用 maven进行打包：mvn clean package

4. 启动 dubbo-admin-server

   • 进入生成的 target目录中，运行启动后台

     java -jar dubboxxx.jar

5. 启动 dubbo-admin-ui

   • 由于 dubbo-admin 是一个前后端分离的项目，所以还需要启动前端项目

   • 需要提前安装 node.js 才可以使用 npm 命令来运行程序

     > npm install
     > npm run dev
     

6. 在 http://localhost:8082 中便可查看运行界面

   • 默认账户密码均为：root

Dubbo 入门案例

使用 XML 启动 Dubbo 案例

1. 项目目录结构如下

   image

2. Maven 核心配置文件如下

   
       
       2.7.8
   
   
   
       
           org.apache.dubbo
           dubbo
           ${dubbo.version}
       
       
       
           org.apache.dubbo
           dubbo-dependencies-zookeeper
           ${dubbo.version}
           pom
       
   
   

3. 在 dubbo-demo-xml-interface 中创建公共接口

   package com.study;
   /**
    * 创建公共接口
   
    * @author DeadBoty
    * @since 2020/10/23 16:22
    */
   public interface DemoService {
       String sayHello(String name);
   }
   

4. 在 dubbo-demo-xml-provider 中创建接口实现类

   • 在 pom.xml 中添加 dubbo-demo-xml-interface 的依赖

   
       
           com.study
           dubbo-demo-xml-interface
           1.0-SNAPSHOT
       
   
   

   • 创建配置文件：provider.xml
   • 编写接口实现类

   package com.study;
   /**
    * 公共接口实现类
   
    * @author DeadBoty
    * @since 2020/10/23 17:17
    */
   public class DemoServiceImpl implements DemoService {
       @Override
       public String sayHello(String name) {
           return "Hello, " + name;
       }
   }
   

   • 编写启动方法

   package com.study;
   
   /**
    * 服务提供方启动
   
    * @author DeadBoty
    * @since 2020/10/23 17:21
    */
   public class Provider {
       public static void main(String[] args) throws Exception {
           ClassPathXmlApplicationContext applicationContext = new ClassPathXmlApplicationContext("provider.xml");
           applicationContext.start();
           // 输入一个字符退出
           System.in.read();
       }
   }
   

   • 在 dubbo-admin 的可视化中可以看到服务提供方
   image

5. 在 dubbo-demo-xml-consumer 中实现服务的调用

   • 在 pom.xml 中添加 dubbo-demo-xml-interface 的依赖

   
       
           com.study
           dubbo-demo-xml-interface
           1.0-SNAPSHOT
       
   
   

   • 创建配置文件：consumer.xml
   • 编写服务消费启动

   package com.study;
   
   /**
    * 服务消费方启动类
   
    * @author DeadBoty
    * @since 2020/10/23 17:34
    */
   public class Consumer {
       public static void main(String[] args) throws Exception {
           ClassPathXmlApplicationContext applicationContext = new ClassPathXmlApplicationContext("consumer.xml");
           DemoService demoService = applicationContext.getBean("demoService", DemoService.class);
           System.out.println(demoService.sayHello("法外狂徒张三"));
       }
   }
   

   • 服务消费与提供方的关系

image

基于注解开发

Spring 的注解开发和 Spring Boot 相似，所以这里直接使用 Spring Boot 进行注解的开发

1. 项目目录结构如下

   image

2. Maven 中各部分的配置

   • dubbo-demo-annotation 的 pom.xml

   
       org.springframework.boot
       spring-boot-starter-parent
       2.3.4.RELEASE
        
   
   
   
      
      
         org.apache.dubbo
         dubbo-spring-boot-starter
         2.7.7
      
   
      
      
         org.apache.dubbo
         dubbo
         2.7.7
      
   
      
      
         org.apache.curator
         curator-framework
         4.0.1
      
   
      
         org.apache.curator
         curator-recipes
         4.0.1
      
   
      
         org.springframework.boot
         spring-boot-starter
      
   
      
         org.springframework.boot
         spring-boot-starter-test
         test
         
            
               org.junit.vintage
               junit-vintage-engine
            
         
      
   
   

   • dubbo-demo-provider 的 pom.xml

   
       dubbo-demo-annotation
       com.study
       1.0-SNAPSHOT
   
   
       
       
           org.springframework.boot
           spring-boot-starter-web
       
   
       
           com.study
           dubbo-demo-interface
           1.0-SNAPSHOT
       
   
   

   • dubbo-demo-consumer 的 pom.xml

   
       dubbo-demo-annotation
       com.study
       1.0-SNAPSHOT
   
   
       
       
           org.springframework.boot
           spring-boot-starter-web
       
   
       
           com.study
           dubbo-demo-interface
           1.0-SNAPSHOT
       
   
   
   

3. 在 dubbo-demo-interface 创建公共接口

   package com.study;
   
   /**
    * 创建公共接口
   
    * @author DeadBoty
    * @since 2020/10/23 16:22
    */
   public interface DemoService {
       String sayHello(String name);
   }
   

4. 在 dubbo-demo-provider 中创建接口实现类

   • dubbo 的配置文件： application.yml

   # 定义端口号
   server:
     port: 8181
   # 定义 dubbo 相关配置
   dubbo:
     application:
       name: annotation-demo-provider
     protocol:
       name: dubbo
       port: 20880
     registry:
       protocol: zookeeper
       address: 127.0.0.1:2181
   

   • 接口实现类

   package com.study.service;
   
   /**
    * 公共接口的具体实现
   
    * @author DeadBoty
    * @since 2020/10/25 14:59
    */
   @Service
   // 需要提供的服务
   @DubboService
   public class DemoServiceImpl implements DemoService {
   
       @Override
       public String sayHello(String name) {
           return "你好~~~ " + name;
       }
   
   }
   

   • 启动类

   package com.study;
   
   /**
    * Spring Boot 启动类
   
    * @author DeadBoty
    * @since 2020/10/25 14:53
    */
   @SpringBootApplication
   // 启动 Dubbo 的注解
   @EnableDubbo
   public class ProviderApplication {
       public static void main(String[] args) {
           SpringApplication.run(ProviderApplication.class, args);
       }
   }
   

5. 在 dubbo-demo-consumer 中实现服务的调用

   • dubbo 的配置

   server:
     port: 8182
   dubbo:
     application:
       name: annotation-demo-consumer
     registry:
       protocol: zookeeper
       address: 127.0.0.1:2181
   

   • 远程调用服务

   package com.study.controller;
   
   /**
    * 服务消费调用
   
    * @author DeadBoty
    * @since 2020/10/25 14:59
    */
   @RestController
   @RequestMapping("/demo")
   public class DemoController {
       // 使用 @DubboReference 来实现远程方法引用服务
       @DubboReference
       DemoService demoService;
   
       @GetMapping("/{name}")
       public String sayHello(@PathVariable String name) throws JsonProcessingException {
           ObjectMapper mapper = new ObjectMapper();
           // 返回了 Json 数据
           return mapper.writeValueAsString(demoService.sayHello(name));
       }
   }
   

   • 启动类

   package com.study;
   
   /**
    * 服务消费端启动类
   
    * @author DeadBoty
    * @since 2020/10/25 14:42
    */
   @SpringBootApplication
   @EnableDubbo
   public class ConsumerApplication {
       public static void main(String[] args) {
           SpringApplication.run(ConsumerApplication.class, args);
       }
   }
   

6. 启动服务后调用方法 http://localhost:8182/demo/%E6%B3%95%E5%A4%96%E7%8B%82%E5%BE%92%E5%BC%A0%E4%B8%89

   • 结果如下：
   image