Java 序列化指南
Apache Fory™ 提供极速的 Java 对象序列化，基于 JIT 编译和零拷贝技术。当只需要 Java 对象序列化时，这种模式相比跨语言对象图序列化提供更好的性能。
特性
高性能
- JIT 代码生成：高度可扩展的 JIT 框架在运行时使用异步多线程编译生成序列化器代码，通过以下方式提供 20-170 倍的加速：
- 内联变量以减少内存访问
- 内联方法调用以消除虚拟分派开销
- 最小化条件分支
- 消除哈希查找
- 零拷贝：直接内存访问，无中间缓冲区拷贝；行格式支持随机访问和部分序列化
- 变长编码：对整数和长整型进行优化压缩
- 元数据共享：缓存的类元数据减少冗余类型信息
- SIMD 加速：支持 Java Vector API 用于数组操作（Java 16+）
即插即用替代
- 100% JDK 序列化兼容：支持
writeObject/readObject/writeReplace/readResolve/readObjectNoData/Externalizable - Java 8-24 支持：适用于所有现代 Java 版本，包括 Java 17+ 的 record
- GraalVM Native Image：支持 AOT 编译，无需反射配置
高级特性
- 引用跟踪：自动处理共享引用和循环引 用
- Schema 演化：类 schema 变更的前向/后向兼容性
- 多态性：完全支持继承层次结构和接口
- 深拷贝：高效深度克隆复杂对象图并保留引用
- 安全性：类注册和可配置的反序列化策略
快速开始
注意，Fory 的创建成本不低，应该在多次序列化之间复用 Fory 实例，而不是每次都创建。你应该将 Fory 作为静态全局变量，或者某个单例对象或有限对象的实例变量。
单线程使用
import java.util.List;
import java.util.Arrays;
import org.apache.fory.*;
import org.apache.fory.config.*;
public class Example {
public static void main(String[] args) {
SomeClass object = new SomeClass();
// 注意 Fory 实例应该在多次不同对象的序列化之间复用。
Fory fory = Fory.builder().withLanguage(Language.JAVA)
.requireClassRegistration(true)
.build();
// 注册类型可以减少类名序列化开销，但不是必须的。
// 如果启用了类注册，所有自定义类型都必须注册。
// 如果未指定 id，注册顺序必须一致
fory.register(SomeClass.class);
byte[] bytes = fory.serialize(object);
System.out.println(fory.deserialize(bytes));
}
}
多线程使用
import java.util.List;
import java.util.Arrays;
import org.apache.fory.*;
import org.apache.fory.config.*;
public class Example {
public static void main(String[] args) {
SomeClass object = new SomeClass();
// 注意 Fory 实例应该在多次不同对象的序列化之间复用。
ThreadSafeFory fory = new ThreadLocalFory(classLoader -> {
Fory f = Fory.builder().withLanguage(Language.JAVA)
.withClassLoader(classLoader).build();
f.register(SomeClass.class, 1);
return f;
});
byte[] bytes = fory.serialize(object);
System.out.println(fory.deserialize(bytes));
}
}
Fory 实例复用模式
import java.util.List;
import java.util.Arrays;
import org.apache.fory.*;
import org.apache.fory.config.*;
public class Example {
// 复用 fory。
private static final ThreadSafeFory fory = new ThreadLocalFory(classLoader -> {
Fory f = Fory.builder().withLanguage(Language.JAVA)
.withClassLoader(classLoader).build();
f.register(SomeClass.class, 1);
return f;
});
public static void main(String[] args) {
SomeClass object = new SomeClass();
byte[] bytes = fory.serialize(object);
System.out.println(fory.deserialize(bytes));
}
}
线程安全
Fory 提供多种线程安全序列化选项：
ThreadLocalFory
使用线程本地存储为每个线程维护独立的 Fory 实例：
ThreadSafeFory fory = new ThreadLocalFory(classLoader -> {
Fory f = Fory.builder().withLanguage(Language.JAVA)
.withClassLoader(classLoader).build();
f.register(SomeClass.class, 1);
return f;
});
byte[] bytes = fory.serialize(object);
System.out.println(fory.deserialize(bytes));
ThreadSafeForyPool
对于虚拟线程或不适合使用线程本地存储的环境，使用 buildThreadSafeForyPool：
ThreadSafeFory fory = Fory.builder()
.withLanguage(Language.JAVA)
.withRefTracking(false)
.withCompatibleMode(CompatibleMode.SCHEMA_CONSISTENT)
.withAsyncCompilation(true)
.buildThreadSafeForyPool(minPoolSize, maxPoolSize);
注意，在 ForyBuilder 上调用 buildThreadSafeFory() 将创建 ThreadLocalFory 实例。这在使用虚拟线程的环境中可能不合适，因为每个线程都会创建自己的 Fory 实例，这是一个相对昂贵的操作。对于虚拟线程，另一种选择是使用 buildThreadSafeForyPool。
Builder 方法
// 单线程 Fory
Fory fory = Fory.builder()
.withLanguage(Language.JAVA)
.withRefTracking(false)
.withCompatibleMode(CompatibleMode.SCHEMA_CONSISTENT)
.withAsyncCompilation(true)
.build();
// 线程安全 Fory (ThreadLocalFory)
ThreadSafeFory fory = Fory.builder()
.withLanguage(Language.JAVA)
.withRefTracking(false)
.withCompatibleMode(CompatibleMode.SCHEMA_CONSISTENT)
.withAsyncCompilation(true)
.buildThreadSafeFory();