# Dubbo应用开发之基于Dubbo协议的springboot规范性开发

## Dubbo协议简介

1. Dubbo的默认协议，⾃⼰定义的私有协议，基于TCP层，默认的通信⽅式是Netty4

2. Dubbo采⽤单⼀⻓连接和 NIO 异步通讯，适合于⼩数据量⼤并发的服务调⽤。反之，Dubbo 缺省协议不适合传送⼤数据量的服务，⽐如传⽂件，传视频等



### 客户端传输数据的流程
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10363742/dee418f22f8a825fb76aa7dee9d2d41e.png)



## Dubbo协议帧的组成

| 区域   | 长度 | 字段        | 位级说明                                              |
| ------ | ---- | ----------- | ----------------------------------------------------- |
| Header | 2 B  | Magic       | 0xda 0xbb（固定）                                     |
|        | 1 B  | Flag        | 高 4 位=SerializationId；低 4 位=Req/Res+TwoWay+Event |
|        | 1 B  | Status      | **只在响应帧有效**，200=20，500=90…                   |
|        | 8 B  | Request Id  | Long 大端，异步匹配用                                 |
|        | 4 B  | Data Length | 消息体字节数（不含头）                                |
| Body   | N B  | Payload     | 由 SerializationId 指定的序列化器填充                 |

### Status状态码

| 码值 | 含义                  |
| ---- | --------------------- |
| 20   | OK                    |
| 30   | CLIENT\_TIMEOUT       |
| 31   | SERVER\_TIMEOUT       |
| 40   | BAD\_REQUEST          |
| 50   | BAD\_RESPONSE         |
| 60   | SERVICE\_NOT\_FOUND   |
| 70   | SERVICE\_ERROR        |
| 80   | SERVER\_ERROR         |
| 90   | CLIENT\_ERROR         |
| 100  | THREADPOOL\_EXHAUSTED |

## 注册中心的作用

在使用Dubbo的过程中,客户端调用服务端集群需要先通过注册中心拉取服务列表.在代码中也不需要写那一段繁琐的配置调用地址,现阶段主要是用来简化开发中的配置.

这里我们选择的注册中心为zookeeper,选择3.6.1的版本

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10363742/9f394f9e42ead93cb9c38cc327c95c39.png)


下载地址: https://archive.apache.org/dist/zookeeper/zookeeper-3.6.1/

> 直接下载第一个apache-zookeeper-3.6.1-bin.tar.gz ,解压即可使用
>
> 进入目录中的conf下修改zoo_sample.cfg为zoo.cfg
>
> 修改zoo.cfg文件,可以看到有一个dataDir的属性.这个是zookeeper的存储树状结构的临时目录,我们需要创建一个数据目录并且将目录位置进行配置D:\DevApp\apache-zookeeper-3.6.1-bin\data,这里我创建的data目录和conf同级,然后修改dataDir的属性
>
> 启动服务端
>
> bin/zkServer.sh start (如果没有设置JavaHome环境会启动报错!)
>
> bin/zkServer.sh stop
>
> bin/zkServer.sh status 
>
> 启动客户端
>
> bin/zkCli.sh

**启动成功**

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10363742/b4bfb77242393ecdad01b8aa6f3c6b4c.png)


可以下载一个zookeeper的图形化管理界面工具 https://github.com/vran-dev/PrettyZoo/releases/tag/v2.1.1,我这里是直接下载的win的版本.



![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10363742/8ad0d4bdcff35c9ead8ae290aaac140d.png)


## 基于SpringBoot规范性开发

> 这次我们将从最开始的父工程开始创建,不使用springboot作为我们的父工程依赖

### 重新创建新项目dubbo-protocol-demo

dubbo-protocol-demo作为我们整个项目的父工程,也作为我们依赖管理的工具

pom.xml

```xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.hust</groupId>
    <artifactId>dubbo-protocol-demo</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>
    <modules>
        <module>dubbo-protocol-api</module>
    </modules>

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

        <dubbo.version>3.2.0</dubbo.version>
        <spring-boot.version>2.7.12</spring-boot.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.apache.dubbo</groupId>
            <artifactId>dubbo-spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>org.apache.dubbo</groupId>
            <artifactId>dubbo-dependencies-zookeeper-curator5</artifactId>
            <version>${dubbo.version}</version>
            <type>pom</type>
            <exclusions>
                <exclusion>
                    <artifactId>zookeeper</artifactId>
                    <groupId>org.apache.zookeeper</groupId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.apache.dubbo</groupId>
            <artifactId>dubbo-bom</artifactId>
            <version>${dubbo.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>${spring-boot.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
</project>
```

到这里父工程的开发就已经完成了,下面开始api模块的开发

### 创建子模块dubbo-protocol-api

创建一个com.hust.service.UserService,定义一个登录的接口

```java
package com.hust.service;

public interface UserService {
    Boolean login(String username, String password);
}
```

创建子模块记得指定父工程为dubbo-protcol-demo

### 创建子模块dubbo-protocol-provider

pom.xml

```xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>com.hust</groupId>
        <artifactId>dubbo-protocol-demo</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>

    <artifactId>dubbo-protocol-provider</artifactId>

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <dependency>
            <groupId>com.hust</groupId>
            <artifactId>dubbo-protocol-api</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>
    </dependencies>

</project>
```

将dubbo-protocol-api作为依赖添加进来,然后实现api模块的UserService方法

com.hust.service.impl.UserServiceImpl

```java
package com.hust.service.Impl;

import com.hust.service.UserService;
import org.apache.dubbo.config.annotation.DubboService;

@DubboService
public class UserServiceImpl implements UserService {
    @Override
    public Boolean login(String username, String password) {
        System.out.println("用户名：" + username + " 密码：" + password);
        return false;
    }
}

```

#### 增加服务启动类

ProviderApplication.java

```java
package com.hust;

import org.apache.dubbo.config.spring.context.annotation.EnableDubbo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
@EnableDubbo
public class ProviderApplication {
    public static void main(String[] args) {
        SpringApplication.run(ProviderApplication.class, args);
    }
}
```

#### 创建springboot配置文件

application.yml

```yml
spring:
  application:
    name: dubbo-protocol-provider

dubbo:
  protocol:
    name: dubbo
    port: -1
# 指定注册中心地址
  registry:
    address: zookeeper://127.0.0.1:2181
```

启动服务后如下图,可以在zookeeper的图形化管理界面找到这个服务,说明服务已经注册到了zookeeper中.

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10363742/5a3d6e5387b755891726b0cb13fe45bc.png)


### 创建子模块dubbo-protocol-consumer

#### 引入依赖pom.xml

还是只需要引入api模块

```xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>com.hust</groupId>
        <artifactId>dubbo-protocol-demo</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>

    <artifactId>dubbo-protocol-cunsumer</artifactId>

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>
    <dependencies>
        <dependency>
            <groupId>com.hust</groupId>
            <artifactId>dubbo-protocol-api</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>
    </dependencies>

</project>

```

#### 创建springboot配置文件

application.yml

```yml
spring:
  application:
    name: dubbo-protocol-consumer

dubbo:
# 指定注册中心地址
  registry:
    address: zookeeper://127.0.0.1:2181
```

这里只需要指定注册中心地址即可

#### 创建主启动类

ConsumerApplication.java

```java
package com.hust;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class ConsumerApplication {
    public static void main(String[] args) {
        SpringApplication.run(ConsumerApplication.class, args);
    }
}
```

#### 创建测试类

```java
import com.hust.ConsumerApplication;
import com.hust.service.UserService;
import org.apache.dubbo.config.annotation.DubboReference;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;

@SpringBootTest(classes = ConsumerApplication.class)
public class TestDubbo {
    @DubboReference
    private UserService userService;

    @Test
    public void testDubbo() {
        System.out.println(userService.login("admin", "11111"));
    }
}

```

#### 调用成功

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-10363742/e76af51f6c12e7e97c7f71491dd3b24b.png)


> 以上就是在基于springboot的Dubbo使用中引入注册中心的完整开发流程

Dubbo的默认协议，⾃⼰定义的私有协议，基于TCP层，默认的通信⽅式是Netty4

Dubbo应用开发之基于Dubbo协议的springboot规范性开发

后端开发

后端

架构设计

开发工具

详解Dubbo协议与SpringBoot整合开发流程，包括Dubbo私有协议特点、Zookeeper注册中心配置、服务提供者与消费者模块搭建。提供Dubbo3.2+SpringBoot2.7实战案例，涵盖协议帧结构解析、服务注册发现、接口定义与远程调用全流程。

2026新春采购季

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Dubbo应用开发之基于Dubbo协议的springboot规范性开发-腾讯云开发者社区-腾讯云

Dubbo应用开发之基于Dubbo协议的springboot规范性开发

Dubbo应用开发之基于Dubbo协议的springboot规范性开发

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐