如何在 triple 协议场景下使用 protobuf、json 序列化

本文介绍 protobuf 序列化，如何在 triple 协议场景下使用 protobuf、json 序列化。

1 介绍

Protobuf（Protocol Buffers） 是由 Google 开发的一种轻量级、高效的数据交换格式，它被用于结构化数据的序列化、反序列化和传输。 相比于XML 和JSON 等文本格式，Protobuf 具有更小的数据体积、更快的解析速度和更强的可扩展性。

2 使用方式

在使用 Protobuf(IDL) 开发 triple 通信服务 的时候，dubbo server 将自动启用 protobuf、protobuf-json 序列化模式支持。

2.1 添加依赖

使用 triple + protobuf 模式，必须添加以下依赖：

1. <dependencies>
2. <dependency>
3. <groupId>com.google.protobuf</groupId>
4. <artifactId>protobuf-java</artifactId>
5. <version>3.19.6</version>
6. </dependency>
7. <!-- 提供 protobuf-json 格式请求支持 -->>
8. <dependency>
9. <groupId>com.google.protobuf</groupId>
10. <artifactId>protobuf-java-util</artifactId>
11. <version>3.19.6</version>
12. </dependency>
13. </dependencies>

2.2 配置启用

只要是基于 Protobuf(IDL) 开发模式进行 triple 协议通信 ，就会使用 protobuf 序列化，只要定义 protobuf 文件并启用 triple 协议即可。

当使用 cURL 访问 triple 服务时，是会启用 protobuf-json 序列化模式

1. curl \
2. --header "Content-Type: application/json" \
3. --data '{"name":"Dubbo"}' \
4. http://localhost:50052/org.apache.dubbo.samples.tri.unary.Greeter/greet/

protobuf 服务定义示例：

1. syntax = "proto3";
2. option java_multiple_files = true;
3. package org.apache.dubbo.samples.tri.unary;

5. message GreeterRequest {
6. string name = 1;
7. }
8. message GreeterReply {
9. string message = 1;
10. }

12. service Greeter{
13. rpc greet(GreeterRequest) returns (GreeterReply);
14. }

协议配置：

1. # application.yml (Spring Boot)
2. dubbo:
3. protocol:
4. name: tri

或

1. # dubbo.properties
2. dubbo.protocol.name=tri

或

1. <dubbo:protocol name="tri" />

最后修改 September 13, 2024: Refactor website structure (#2860) (1a4b998f54b)