基于 Java 接口模式开发 triple 服务时，底层的序列化机制实现

本文介绍基于 Java 接口模式开发 triple 服务时，底层的序列化机制实现。

1 介绍

Dubbo 实现的 triple 协议易用性更好（不绑定 Protobuf），开发者可以继续使用 Java 接口 直接定义服务。对于期望平滑升级、没有多语言业务或者不熟悉 Protobuf 的用户而言，Java 接口方式是最简单的使用 triple 的方式。

以下介绍这种协议模式下的底层序列化细节：框架会用一个内置的 protobuf 对象将 request 和 response 进行包装（wrapper），也就是对象会被序列化两次，第一次是使用如 serialization=hessian 指定的方式进行序列化，第二次是用 protobuf wrapper 对第一步中序列化后的 byte[] 进行包装后传输。

2 使用方式

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

2.1 添加依赖

使用 triple 协议，必须先添加如下依赖：

<dependencies>
    <dependency>
        <groupId>com.google.protobuf</groupId>
        <artifactId>protobuf-java</artifactId>
        <version>3.19.6</version>
    </dependency>
    <!-- 提供 protobuf-json 格式请求支持 -->>
    <dependency>
        <groupId>com.google.protobuf</groupId>
        <artifactId>protobuf-java-util</artifactId>
        <version>3.19.6</version>
    </dependency>
</dependencies>

2.2 配置启用

只要是基于 Java 接口方式模式使用 triple 协议 ，就会使用 protobuf wrapper 序列化，只要定义 Java 接口并启用 triple 协议即可：

通过 Java 接口定义 Dubbo 服务：

public interface GreetingsService {
    String sayHi(String name);
}

配置使用 triple 协议（如果要设置底层使用的序列化协议，需要继续设置 serialization，如 hessian、msgpack 等）：

# application.yml (Spring Boot)
dubbo:
 protocol:
   name: tri
   serialization: hessian

或

# dubbo.properties
dubbo.protocol.name=tri
dubbo.protocol.serialization=hessian

或

<dubbo:protocol name="tri" serialization="hessian"/>

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