dubbo 协议支持的序列化 on Apache Dubbo

Hessian

Mon, 01 Jan 0001 00:00:00 +0000

1 介绍

Hessian序列化是一种支持动态类型、跨语言、基于对象传输的网络协议，Java对象序列化的二进制流可以被其他语言（如，c++，python）。特性如下：

自描述序列化类型。不依赖外部描述文件或者接口定义，用一个字节表示常用的基础类型，极大缩短二进制流。
语言无关，支持脚本语言
协议简单，比Java原生序列化高效
相比hessian1，hessian2中增加了压缩编码，其序列化二进制流大小是Java序列化的50%，序列化耗时是Java序列化的30%，反序列化耗时是Java序列化的20%。

2 使用方式

在 Dubbo 框架中，当使用 dubbo 通信协议时，默认使用 Hessian2 作为序列化。

2.1 配置启用

# application.yml (Spring Boot)
dubbo:
 protocol:
 serialization: hessian2

或

# dubbo.properties
dubbo.protocol.serialization=hessian2

# or
dubbo.consumer.serialization=hessian2

# or
dubbo.reference.com.demo.DemoService.serialization=hessian2

或

<dubbo:protocol serialization="hessian2" />

 <!-- or -->
<dubbo:consumer serialization="hessian2" />

 <!-- or -->
<dubbo:reference interface="xxx" serialization="hessian2" />

Fastjson2

Mon, 01 Jan 0001 00:00:00 +0000

1 介绍

FASTJSON v2是FASTJSON项目的重要升级，目标是为下一个十年提供一个高性能的JSON库。通过同一套API，

支持JSON/JSONB两种协议，JSONPath 是一等公民。
支持全量解析和部分解析。
支持Java服务端、客户端Android、大数据场景。
支持Kotlin https://alibaba.github.io/fastjson2
支持JSON Schema https://alibaba.github.io/fastjson2
支持Android 8+
支持Graal Native-Image
支持 JSON Schema https://alibaba.github.io/fastjson2

2 使用方式

2.1 添加依赖

<dependencies>
 <dependency>
 <groupId>com.alibaba.fastjson2</groupId>
 <artifactId>fastjson2</artifactId>
 <version>2.0.23</version>
 </dependency>
</dependencies>

注：Fastjson2 序列化仅 Dubbo > 3.1.0 版本支持。在 Dubbo > 3.2.0 中将替代 Hessian 作为默认序列化方式。

2.2 配置启用

# application.yml (Spring Boot)
dubbo:
 protocol:
 serialization: fastjson2

或

# dubbo.properties
dubbo.protocol.serialization=fastjson2

# or
dubbo.consumer.serialization=fastjson2

# or
dubbo.reference.com.demo.DemoService.serialization=fastjson2

或

<dubbo:protocol serialization="fastjson2" />

<!-- or -->
<dubbo:consumer serialization="fastjson2" />

<!-- or -->
<dubbo:reference interface="xxx" serialization="fastjson2" />

Fastjson

Mon, 01 Jan 0001 00:00:00 +0000

1 介绍

Fastjson 是一个 Java 库，可用于将 Java 对象转换为其 JSON 表示形式。它还可用于将 JSON 字符串转换为等效的 Java 对象。 Fastjson 可以处理任意 Java 对象，包括您没有源代码的预先存在的对象。

2 使用方式

2.1 添加依赖

<dependencies>
 <dependency>
 <groupId>org.apache.dubbo.extensions</groupId>
 <artifactId>dubbo-serialization-fastjson</artifactId>
 <version>3.3.0</version>
 </dependency>
 <dependency>
 <groupId>com.alibaba</groupId>
 <artifactId>fastjson</artifactId>
 <version>1.2.83</version>
 </dependency>
</dependencies>

2.2 配置启用

# application.yml (Spring Boot)
dubbo:
 protocol:
 serialization: fastjson

或

# dubbo.properties
dubbo.protocol.serialization=fastjson

# or
dubbo.consumer.serialization=fastjson

# or
dubbo.reference.com.demo.DemoService.serialization=fastjson

或

<dubbo:protocol serialization="fastjson" />

<!-- or -->
<dubbo:consumer serialization="fastjson" />

<!-- or -->
<dubbo:reference interface="xxx" serialization="fastjson" />

3 支持的rpc协议

Avro

Mon, 01 Jan 0001 00:00:00 +0000

1 介绍

Avro是一种远程过程调用和数据序列化框架，是在Apache的Hadoop项目之内开发的。它使用JSON来定义数据类型和通讯协议，使用压缩二进制格式来序列化数据。它主要用于Hadoop，它可以为持久化数据提供一种序列化格式，并为Hadoop节点间及从客户端程序到Hadoop服务的通讯提供一种电报格式。

2 使用方式

2.1 添加依赖

<dependencies>
 <dependency>
 <groupId>org.apache.dubbo.extensions</groupId>
 <artifactId>dubbo-serialization-avro</artifactId>
 <version>3.3.0</version>
 </dependency>
 <dependency>
 <groupId>org.apache.avro</groupId>
 <artifactId>avro</artifactId>
 <version>1.11.1</version>
 </dependency>
</dependencies>

2.2 配置启用

# application.yml (Spring Boot)
dubbo:
 protocol:
 serialization: avro

或

# dubbo.properties
dubbo.protocol.serialization=avro

# or
dubbo.consumer.serialization=avro

# or
dubbo.reference.com.demo.DemoService.serialization=avro

或

<dubbo:protocol serialization="avro" />

<!-- or -->
<dubbo:consumer serialization="avro" />

<!-- or -->
<dubbo:reference interface="xxx" serialization="avro" />

FST

Mon, 01 Jan 0001 00:00:00 +0000

1 介绍

FST序列化全称是Fast Serialization，它是对Java序列化的替换实现。既然前文中提到Java序列化的两点严重不足，在FST中得到了较大的改善，FST的特征如下：

比JDK提供的序列化提升了10倍，体积也减少 3-4 倍多
支持堆外Maps，和堆外Maps的持久化
支持序列化为JSON

2 使用方式

2.1 添加依赖

<dependencies>
 <dependency>
 <groupId>org.apache.dubbo.extensions</groupId>
 <artifactId>dubbo-serialization-fst</artifactId>
 <version>3.3.0</version>
 </dependency>
 <dependency>
 <groupId>de.ruedigermoeller</groupId>
 <artifactId>fst</artifactId>
 <version>3.0.3</version>
 </dependency>
</dependencies>

2.2 配置启用

# application.yml (Spring Boot)
dubbo:
 protocol:
 serialization: fst

或

# dubbo.properties
dubbo.protocol.serialization=fst

# or
dubbo.consumer.serialization=fst

# or
dubbo.reference.com.demo.DemoService.serialization=fst

或

<dubbo:protocol serialization="fst" />

 <!-- or -->
<dubbo:consumer serialization="fst" />

 <!-- or -->
<dubbo:reference interface="xxx" serialization="fst" />

3 注册被序列化类

要让Kryo和FST完全发挥出高性能，最好将那些需要被序列化的类注册到dubbo系统中，实现如下

回调接口

public class SerializationOptimizerImpl implements SerializationOptimizer {

 public Collection<Class> getSerializableClasses() {
 List<Class> classes = new LinkedList<Class>();
 classes.add(BidRequest.class);
 classes.add(BidResponse.class);
 classes.add(Device.class);
 classes.add(Geo.class);
 classes.add(Impression.class);
 classes.add(SeatBid.class);
 return classes;
 }
}

然后在XML配置中添加：

Gson

Mon, 01 Jan 0001 00:00:00 +0000

1 介绍

Gson是Google公司发布的一个开放源代码的Java库，主要用途为序列化Java对象为JSON字符串，或反序列化JSON字符串成Java对象。

2 使用方式

2.1 添加依赖

<dependencies>
 <dependency>
 <groupId>org.apache.dubbo.extensions</groupId>
 <artifactId>dubbo-serialization-gson</artifactId>
 <version>3.3.0</version>
 </dependency>
 <dependency>
 <groupId>com.google.code.gson</groupId>
 <artifactId>gson</artifactId>
 <version>2.10.1</version>
 </dependency>
</dependencies>

2.2 配置启用

# application.yml (Spring Boot)
dubbo:
 protocol:
 serialization: gson

或

# dubbo.properties
dubbo.protocol.serialization=gson

# or
dubbo.consumer.serialization=gson

# or
dubbo.reference.com.demo.DemoService.serialization=gson

或

<dubbo:protocol serialization="gson" />

 <!-- or -->
<dubbo:consumer serialization="gson" />

 <!-- or -->
<dubbo:reference interface="xxx" serialization="gson" />

Kryo

Mon, 01 Jan 0001 00:00:00 +0000

1 介绍

Kryo是一种非常成熟的序列化实现，已经在Twitter、Groupon、Yahoo以及多个著名开源项目（如Hive、Storm）中广泛的使用。

2 使用方式

2.1 添加依赖

<dependencies>
 <dependency>
 <groupId>org.apache.dubbo.extensions</groupId>
 <artifactId>dubbo-serialization-kryo</artifactId>
 <version>1.0.1</version>
 </dependency>
 <dependency>
 <groupId>com.esotericsoftware</groupId>
 <artifactId>kryo</artifactId>
 <version>5.4.0</version>
 </dependency>
 <dependency>
 <groupId>de.javakaffee</groupId>
 <artifactId>kryo-serializers</artifactId>
 <version>0.45</version>
 </dependency>
</dependencies>

2.2 配置启用

# application.yml (Spring Boot)
dubbo:
 protocol:
 serialization: kryo

或

# dubbo.properties
dubbo.protocol.serialization=kryo

# or
dubbo.consumer.serialization=kryo

# or
dubbo.reference.com.demo.DemoService.serialization=kryo

或

<dubbo:protocol serialization="kryo" />

 <!-- or -->
<dubbo:consumer serialization="kryo" />

 <!-- or -->
<dubbo:reference interface="xxx" serialization="kryo" />

3 注册被序列化类

要让Kryo和FST完全发挥出高性能，最好将那些需要被序列化的类注册到dubbo系统中，实现如下

回调接口

public class SerializationOptimizerImpl implements SerializationOptimizer {

 public Collection<Class> getSerializableClasses() {
 List<Class> classes = new LinkedList<Class>();
 classes.add(BidRequest.class);
 classes.add(BidResponse.class);
 classes.add(Device.class);
 classes.add(Geo.class);
 classes.add(Impression.class);
 classes.add(SeatBid.class);
 return classes;
 }
}

然后在XML配置中添加：

MessagePack

Mon, 01 Jan 0001 00:00:00 +0000

1 介绍

MessagePack是一种计算机数据交换格式。它是一种二进制形式，用于表示简单的数据结构，如数组和关联数组。MessagePack 旨在尽可能紧凑和简单。

2 使用方式

2.1 添加依赖

<dependencies>
 <dependency>
 <groupId>org.apache.dubbo.extensions</groupId>
 <artifactId>dubbo-serialization-msgpack</artifactId>
 <version>3.3.0</version>
 </dependency>
 <dependency>
 <groupId>org.msgpack</groupId>
 <artifactId>msgpack-core</artifactId>
 <version>0.9.3</version>
 </dependency>

 <dependency>
 <groupId>org.msgpack</groupId>
 <artifactId>jackson-dataformat-msgpack</artifactId>
 <version>0.9.3</version>
 </dependency>
</dependencies>

2.2 配置启用

# application.yml (Spring Boot)
dubbo:
 protocol:
 serialization: msgpack

或

# dubbo.properties
dubbo.protocol.serialization=msgpack

# or
dubbo.consumer.serialization=msgpack

# or
dubbo.reference.com.demo.DemoService.serialization=msgpack

或

<dubbo:protocol serialization="msgpack" />

 <!-- or -->
<dubbo:consumer serialization="msgpack" />

 <!-- or -->
<dubbo:reference interface="xxx" serialization="msgpack" />