Dubbo介绍及示例用法

Dubbo

是什么?

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

核心特性

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

对比 OpenFeign

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

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

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

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

1. 项目结构

markdown 复制代码
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,供其他模块依赖。

java 复制代码
// 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 服务。

java 复制代码
// 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)

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

java 复制代码
// 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 服务。

java 复制代码
// 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 为例)

yaml 复制代码
# 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)

xml 复制代码
<!-- 所有模块需添加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-servicearticle-service,服务会自动注册到 Nacos。

  3. 启动API网关
    启动 api-gateway,通过 HTTP 接口对外提供服务。

  4. 测试调用
    发送 POST 请求到网关:

    bash 复制代码
    curl -X POST http://localhost:8080/articles \
    -H "Content-Type: application/json" \
    -d '{"title":"Dubbo实战","content":"...","authorId":123}'
  5. 输出结果

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

5. 关键设计点

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

      java 复制代码
      @DubboReference(retries = 2, cluster = "failfast")
      private PointsService pointsService;

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

相关推荐
霖檬ing2 分钟前
K8s——配置管理(1)
java·贪心算法·kubernetes
Vic101011 小时前
Java 开发笔记:多线程查询逻辑的抽象与优化
java·服务器·笔记
Biaobiaone1 小时前
Java中的生产消费模型解析
java·开发语言
特立独行的猫a1 小时前
11款常用C++在线编译与运行平台推荐与对比
java·开发语言·c++
louisgeek1 小时前
Java 位运算
java
hweiyu002 小时前
Maven 私库
java·maven
Super Rookie2 小时前
Spring Boot 企业项目技术选型
java·spring boot·后端
写不出来就跑路2 小时前
Spring Security架构与实战全解析
java·spring·架构
ZeroNews内网穿透3 小时前
服装零售企业跨区域运营难题破解方案
java·大数据·运维·服务器·数据库·tcp/ip·零售
sleepcattt3 小时前
Spring中Bean的实例化(xml)
xml·java·spring