Dubbo介绍及示例用法

一、Dubbo基本介绍

Dubbo是什么？

• Apache Dubbo 是一款高性能、轻量级的 RPC（远程过程调用）框架，最初由阿里巴巴开源，用于解决微服务间的通信问题。
• 与 OpenFeign 类似，但 Dubbo 更专注于 高性能、低延迟的远程调用（基于 Netty 和 NIO），适合复杂的企业级分布式场景。

核心特性

• 服务注册与发现：通过注册中心（如 ZooKeeper、Nacos）管理服务提供者和消费者。
• 负载均衡：内置多种策略（随机、轮询、最少活跃调用等），类似 LoadBalancer。
• 容错机制：支持失败重试、快速失败、熔断等（类似 Sentinel 的部分功能）。
• 协议支持：默认使用 Dubbo 协议（二进制序列化，性能高），也支持 HTTP、gRPC 等。
• 服务治理：提供路由规则、动态配置、服务降级等能力。

对比 OpenFeign

特性	Dubbo	OpenFeign
协议	自定义二进制协议	HTTP（RESTful）
性能	更高（Netty 底层）	基于 HTTP，稍逊
适用场景	内部服务高频调用	跨语言、兼容 REST 规范

附：RPC和HTTP在微服务通信中的对比

1. 核心概念对比

维度	RPC (如 Dubbo)	HTTP (如 OpenFeign/REST)
本质	远程过程调用协议，像调用本地方法一样透明	基于 HTTP 的应用层协议，遵循请求-响应模型
设计目标	高性能、低延迟的内部服务通信	通用、跨平台、跨语言的标准化通信
协议层	通常自定义二进制协议（如 Dubbo 协议）	文本协议（HTTP/1.1、HTTP/2）
典型框架	Dubbo、gRPC、Thrift	OpenFeign、Spring Cloud REST、HTTPClient

---

2. 技术细节对比

2.1 性能

• RPC
  ✅ 优势：

  • 二进制协议（如 Dubbo 的 Hessian2/Kryo）序列化体积小，速度更快。
  • 长连接 + 多路复用（如 Netty 实现），减少 TCP 握手开销。
    ❌ 劣势：
  • 协议定制化，跨语言需额外适配（如 Dubbo 的多语言支持较弱）。

• HTTP
  ✅ 优势：

  • 标准化，天然支持跨语言（任何语言都有 HTTP 库）。
    ❌ 劣势：
  • 文本协议（JSON/XML）序列化开销大，头部冗余（如 HTTP Headers）。
  • 默认短连接（HTTP/1.1 可复用但不如 RPC 高效）。

二、示例用法

举个例子，发布文章送积分，一个是文章模块，一个是积分模块，还有个api模块。

下面通过一个完整的示例，演示如何使用 Dubbo 实现「发布文章送积分」的分布式业务场景。假设系统分为三个模块：

1. article-service（文章服务）
2. points-service（积分服务）
3. api-gateway（API 网关，提供 HTTP 接口）

---

1. 项目结构

dubbo-demo/
├── api-module/               # 公共API模块（定义接口和DTO）
│   ├── ArticleService.java    # 文章服务接口
│   ├── PointsService.java     # 积分服务接口
│   └── dto/                   # 数据传输对象
├── article-service/          # 文章服务实现
│   └── ArticleServiceImpl.java
├── points-service/           # 积分服务实现
│   └── PointsServiceImpl.java
└── api-gateway/              # HTTP网关（Spring Boot）
    └── ArticleController.java

---

2. 关键代码实现

2.1 公共API模块（api-module）

定义 Dubbo 服务接口和 DTO，供其他模块依赖。

// ArticleService.java - 文章服务接口
public interface ArticleService {
    void publishArticle(ArticleDTO article);
}

// PointsService.java - 积分服务接口
public interface PointsService {
    void addPoints(Long userId, int points);
}

// ArticleDTO.java - 数据传输对象
@Data
public class ArticleDTO implements Serializable {
    private Long id;
    private String title;
    private String content;
    private Long authorId;
}

2.2 积分服务（points-service）

实现积分逻辑，暴露 Dubbo 服务。

// PointsServiceImpl.java
@Service  // Spring Bean
@DubboService  // 暴露Dubbo服务（Dubbo 3.0+注解）
public class PointsServiceImpl implements PointsService {
    @Override
    public void addPoints(Long userId, int points) {
        System.out.printf("[积分服务] 用户 %d 增加 %d 积分\n", userId, points);
        // 实际业务：更新数据库积分表...
    }
}

2.3 文章服务（article-service）

调用积分服务，实现发布文章逻辑。

// ArticleServiceImpl.java
@Service
@DubboService
public class ArticleServiceImpl implements ArticleService {
    @DubboReference  // 引用远程积分服务
    private PointsService pointsService;

    @Override
    public void publishArticle(ArticleDTO article) {
        System.out.printf("[文章服务] 发布文章: %s\n", article.getTitle());
        // 1. 保存文章到数据库...
        // 2. 调用积分服务赠送积分
        pointsService.addPoints(article.getAuthorId(), 10); // 送10积分
    }
}

2.4 API网关（api-gateway）

提供 HTTP 接口，内部调用 Dubbo 服务。

// ArticleController.java
@RestController
public class ArticleController {
    @DubboReference
    private ArticleService articleService;

    @PostMapping("/articles")
    public String publishArticle(@RequestBody ArticleDTO article) {
        articleService.publishArticle(article);
        return "文章发布成功";
    }
}

---

3. 配置说明

3.1 注册中心配置（以 Nacos 为例）

# article-service 和 points-service 的 application.yml
dubbo:
  application:
    name: article-service  # 或 points-service
  registry:
    address: nacos://127.0.0.1:8848  # Nacos地址
  protocol:
    name: dubbo
    port: 20880  # 默认Dubbo协议端口

3.2 依赖配置（Maven）

<!-- 所有模块需添加Dubbo依赖 -->
<dependency>
    <groupId>org.apache.dubbo</groupId>
    <artifactId>dubbo-spring-boot-starter</artifactId>
    <version>3.2.0</version>
</dependency>
<!-- Nacos注册中心 -->
<dependency>
    <groupId>com.alibaba.nacos</groupId>
    <artifactId>nacos-client</artifactId>
    <version>2.2.2</version>
</dependency>

---

4. 运行流程

1. 启动注册中心：
   先启动 Nacos（bin/startup.sh）。
2. 启动服务提供者：
   启动 points-service 和 article-service，服务会自动注册到 Nacos。
3. 启动API网关：
   启动 api-gateway，通过 HTTP 接口对外提供服务。
4. 测试调用：
   发送 POST 请求到网关：

   curl -X POST http://localhost:8080/articles \
   -H "Content-Type: application/json" \
   -d '{"title":"Dubbo实战","content":"...","authorId":123}'
   

5. 输出结果：

   [文章服务] 发布文章: Dubbo实战
   [积分服务] 用户 123 增加 10 积分
   

---

5. 关键设计点

1. 服务解耦：
   • 文章服务不直接操作积分数据库，通过 RPC 调用积分服务。
2. 事务一致性：
   • 如需保证“发布文章+送积分”的事务一致性，可集成 Seata（通过 @GlobalTransactional 注解）。
3. 容错处理：
   • 在 @DubboReference 中配置重试策略和熔断规则：

     @DubboReference(retries = 2, cluster = "failfast")
     private PointsService pointsService;
     

---

6. 注意事项

在 Spring Boot 项目中整合 Dubbo 时，需要在启动类上添加 @EnableDubbo 注解，以激活 Dubbo 的自动配置功能（包括服务暴露、引用、注册中心连接等）。以下是具体说明和示例：

1. @EnableDubbo 的作用

• 开启 Dubbo 的 Spring 支持：扫描 @DubboService（服务提供者）和 @DubboReference（服务消费者）注解。
• 初始化 Dubbo 配置：加载 application.yml 或 application.properties 中的 Dubbo 相关配置（如注册中心地址、协议等）。

2. 完整示例代码

在服务提供者（Provider）中启用

// points-service/src/main/java/com/example/PointsApplication.java
import org.apache.dubbo.config.spring.context.annotation.EnableDubbo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
@EnableDubbo  // 关键注解：启用Dubbo功能
public class PointsApplication {
    public static void main(String[] args) {
        SpringApplication.run(PointsApplication.class, args);
    }
}

在服务消费者（Consumer）中启用

// api-gateway/src/main/java/com/example/ApiGatewayApplication.java
import org.apache.dubbo.config.spring.context.annotation.EnableDubbo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
@EnableDubbo  // 关键注解：启用Dubbo功能
public class ApiGatewayApplication {
    public static void main(String[] args) {
        SpringApplication.run(ApiGatewayApplication.class, args);
    }
}

3. 替代方案（Dubbo 3.0+）

从 Dubbo 3.0 开始，如果满足以下条件，可以省略 @EnableDubbo：

1. 使用 @DubboService 和 @DubboReference 注解（而非旧版的 @Service 和 @Reference）。
2. 项目中已正确配置 spring-cloud-starter-dubbo 或 dubbo-spring-boot-starter 依赖。

但为了明确性和兼容性，建议显式添加 @EnableDubbo。

---

通过这个例子，可以清晰看到 Dubbo 如何实现跨服务的透明化调用。如果需要进一步扩展（如超时控制、服务分组），只需调整 Dubbo 的配置注解即可。