Dubbo介绍及示例用法

一、Dubbo基本介绍

Dubbo是什么？

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

核心特性

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

对比 OpenFeign

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

1. 核心概念对比

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 相关配置（如注册中心地址、协议等）。

1. 完整示例代码

在服务提供者（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); } }

1. 替代方案（Dubbo 3.0+）

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

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

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

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