分布式框架Apache Dubbo 快速入门-不古出品

Apache Dubbo 是一款微服务框架，为大规模微服务实践提供高性能 RPC 通信、流量治理、可观测性等解决方案，涵盖 Java、Golang 等多种语言 SDK 实现。

RPC 概念

RPC（Remote Procedure Call Protocol）——远程过程调用协议，它是一种通过网络从远程计算机程序上请求服务，而不需要了解底层网络技术的协议。RPC 协议假定某些传输协议的存在，如 TCP 或 UDP，为通信程序之间携带信息数据。在 OSI 网络通信模型（OSI 七层网络模型，OSI，Open System Interconnection，开放系统互联）中，RPC 跨越了传输层和应用层。RPC 使得开发包括网络分布式多程序在内的应用程序更加容易。

RPC 采用客户机/服务器模式（即 C/S 模式）。请求程序就是一个客户机，而服务提供程序就是一个服务器。首先，客户机调用进程发送一个有进程参数的调用信息到服务进程，然后等待应答信息。在服务器端，进程保持睡眠状态直到调用信息到达为止。当一个调用信息到达，服务器获得进程参数，计算结果，发送答复信息，然后等待下一个调用信息，最后，客户端调用进程接收答复信息，获得进程结果，然后调用执行继续进行。

为什么需要Dubbo

在互联网的发展过程中，在以前，我们只需要一个服务器，将程序全部打包好就可以，但是，随着流量的增大，常规的垂直应用架构已无法应对，所以，架构就发生了演变。

1. 单一应用架构

2. 应用和数据库单独部署

3. 应用和数据库集群部署

4. 数据库压力变大，读写分离

5. 使用缓存技术加快速度

6. 数据库分库分表

7. 应用分为不同的类型拆分

发展到这个阶段的时候，我们发现，应用与应用之间的关系已经十分的复杂了，就会出现以下几个问题：

1. 当服务越来越多时，服务URL配置管理变得非常困难，F5硬件负载均衡器的单点压力也越来越大。

2. 当进一步发展，服务间依赖关系变得错综复杂，甚至分不清哪个应用要在哪个应用之前启动，架构师都不能完整地描述应用的架构关系。

3. 接着，服务的调用量越来越大，服务的容量问题就暴露出来，这个服务需要多少机器支撑？什么时候该加机器？

为了解决这由于架构的演变所产生的几个问题，于是，dubbo产生了。

Dubbo 简介

Apache Dubbo 是一款 RPC 服务开发框架，用于解决微服务架构下的服务治理与通信问题，官方提供了 Java、Golang 等多语言 SDK 实现。使用 Dubbo 开发的微服务原生具备相互之间的远程地址发现与通信能力， 利用 Dubbo 提供的丰富服务治理特性，可以实现诸如服务发现、负载均衡、流量调度等服务治理诉求。Dubbo 被设计为高度可扩展，用户可以方便的实现流量拦截、选址的各种定制逻辑。

Dubbo核心组件

• Provider：服务提供者。
• Consumer：服务消费者。
• Registry：服务注册与发现的中心，提供目录服务。
• Monitor：服务监控，统计服务的调用次数、调用时间等信息的日志服务，并可以对服务设置权限、降级处理等，称为服务管控中心。
• Container：服务运行容器。

Dubbo 基于消费端的自动服务发现能力，其基本工作原理如下图：

图中虚线部分均为异步，实线为同步，流程为：

0. start：启动Spring容器时，初始化Provider
1. register：Provider信息注册到Registry
2. subscribe：Consumer通过Registry订阅
3. notify：Registry将Provider信息通知给Consumer
4. invoke：Consumer通过Provider信息调用Provider方法
5. count：将访问信息上传到Monitor

快速入门

示例演示了如何使用 Spring Boot 方式快速开发 Dubbo 应用。

下载示例代码

完整示例代码在 dubbo-samples 中。

1. 下载源码

git clone -b master https://github.com/apache/dubbo-samples.git
1

1. 进入示例目录

cd dubbo-samples/dubbo-samples-spring-boot
ls # 查看目录结构
1
2

快速运行示例

1. 编译 Provider 在 dubbo-samples-spring-boot 目录执行 maven 命令

mvn clean package
1

1. 运行 Provider 进入 dubbo-samples-spring-boot-provider/target 目录并启动 java 进程

cd ./dubbo-samples-spring-boot-provider
java -jar ./target/dubbo-samples-spring-boot-provider-1.0-SNAPSHOT.jar
1
2

1. 运行 consumer 进入 dubbo-samples-spring-boot-consumer 目录并启动 java 进程

java -jar ./target/dubbo-samples-spring-boot-consumer-1.0-SNAPSHOT.jar
1

1. 查看结果 在 consumer 侧会输出如下信息：

result: Hello World
1

在 provider 侧会输出如下信息：

Hello World, request from consumer: xxx.xxx.xxx.xxx
1

至此就把 Dubbo 的基本功能都实现了，可以在 Dubbo 的基础上进行更多的开发。

示例核心流程

关于示例的更详细解读可参见 注解配置

1. 定义服务接口

dubbo-samples-spring-boot-interface/DemoService.java

package org.apache.dubbo.samples.basic.api;

public interface DemoService {
    String sayHello(String name);
}
1
2
3
4
5

2. 提供方实现接口并暴露服务

dubbo-samples-spring-boot-provider/DemoServiceImpl.java

@DubboService
public class DemoServiceImpl implements DemoService {
    @Override
    public String sayHello(String name) {
        System.out.println("Hello " + name + ", request from consumer: " + RpcContext.getContext().getRemoteAddress());
        return "Hello " + name;
    }
}
1
2
3
4
5
6
7
8

3. 配置 application.yml 文件

dubbo-samples-spring-boot-provider/resources/application.yml

dubbo:
  application:
    name: dubbo-springboot-demo-provider
  protocol:
    name: dubbo
    port: -1
  registry:
    id: zk-registry
    address: zookeeper://127.0.0.1:2181
  config-center:
    address: zookeeper://127.0.0.1:2181
  metadata-report:
    address: zookeeper://127.0.0.1:2181
1
2
3
4
5
6
7
8
9
10
11
12
13

4. 定义 Spring Boot 主函数

dubbo-samples-spring-boot-provider/ProviderApplication.java

@SpringBootApplication
@EnableDubbo
public class ProviderApplication {
    public static void main(String[] args) throws Exception {
        new EmbeddedZooKeeper(2181, false).start();

        SpringApplication.run(ProviderApplication.class, args);
        System.out.println("dubbo service started");
        new CountDownLatch(1).await();
    }
}
1
2
3
4
5
6
7
8
9
10
11

其中，@EnableDubbo 必须配置。

5. 引用远程服务

dubbo-samples-spring-boot-consumer/ConsumerApplication.java

public class ConsumerApplication {
    @DubboReference
    private DemoService demoService;
}
1
2
3
4

6. 定义 application.yml

dubbo-samples-spring-boot-consumer/application.yml

dubbo:
  application:
    name: dubbo-springboot-demo-consumer
  protocol:
    name: dubbo
    port: -1
  registry:
    id: zk-registry
    address: zookeeper://127.0.0.1:2181
  config-center:
    address: zookeeper://127.0.0.1:2181
  metadata-report:
    address: zookeeper://127.0.0.1:2181
1
2
3
4
5
6
7
8
9
10
11
12
13

7. 加载 Spring 配置，并调用远程服务

dubbo-samples-spring-boot-consumer/ConsumerApplication.java

@SpringBootApplication
@Service
@EnableDubbo
public class ConsumerApplication {
    @DubboReference
    private DemoService demoService;

    public static void main(String[] args) {
        ConfigurableApplicationContext context = SpringApplication.run(ConsumerApplication.class, args);
        ConsumerApplication application = context.getBean(ConsumerApplication.class);
        String result = application.doSayHello("world");
        System.out.println("result: " + result);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

其中，@EnableDubbo 必须配置。

高级用法

官网：https://dubbo.apache.org/zh/