Kotlin 序列化指南
Apache Fory™ Kotlin 基于 Fory Java 构建，为 Kotlin 类型提供了优化的序列化器。大多数标准 Kotlin 类型可以直接使用默认的 Fory Java 实现，而 Fory Kotlin 则为 Kotlin 特有的类型提供了额外的支持。
支持的类型包括：
data class序列化- 无符号原始类型：
UByte、UShort、UInt、ULong - 无符号数组：
UByteArray、UShortArray、UIntArray、ULongArray - 标准库类型：
Pair、Triple、Result - 范围：
IntRange、LongRange、CharRange以及等差数列 - 集合：
ArrayDeque、空集合（emptyList、emptyMap、emptySet） kotlin.time.Duration、kotlin.text.Regex、kotlin.uuid.Uuid
特性
Fory Kotlin 继承了 Fory Java 的所有特性，并增加了 Kotlin 特定的优化：
- 高性能：JIT 代码生成、零拷贝，比传统序列化快 20-170 倍
- Kotlin 类型支持：为数据类、无符号类型、范围和标准库类型提供优化的序列化器
- 默认值支持：在 schema 演化期间自动处理 Kotlin 数据类的默认参数
- Schema 演化：支持类 schema 变更的前向/后向兼容性
完整特性列表请参阅 Java 特性。
安装
Maven
<dependency>
<groupId>org.apache.fory</groupId>
<artifactId>fory-kotlin</artifactId>
<version>0.14.1</version>
</dependency>
Gradle
implementation("org.apache.fory:fory-kotlin:0.14.1")
快速开始
import org.apache.fory.Fory
import org.apache.fory.ThreadSafeFory
import org.apache.fory.serializer.kotlin.KotlinSerializers
data class Person(val name: String, val id: Long, val github: String)
data class Point(val x: Int, val y: Int, val z: Int)
fun main() {
// 创建 Fory 实例（应该重用）
val fory: ThreadSafeFory = Fory.builder()
.requireClassRegistration(true)
.buildThreadSafeFory()
// 注册 Kotlin 序列化器
KotlinSerializers.registerSerializers(fory)
// 注册你的类
fory.register(Person::class.java)
fory.register(Point::class.java)
val p = Person("Shawn Yang", 1, "https://github.com/chaokunyang")
println(fory.deserialize(fory.serialize(p)))
println(fory.deserialize(fory.serialize(Point(1, 2, 3))))
}
基于 Fory Java 构建
Fory Kotlin 基于 Fory Java 构建。Fory Java 的大多数配置选项、特性和概念直接适用于 Kotlin。请参阅 Java 文档了解：
- 配置选项 - 所有 ForyBuilder 选项
- 基础序列化 - 序列化模式和 API
- 类型注册 - 类注册和安全性
- Schema 演化 - 前向/后向兼容性
- 自定义序列化器 - 实现自定义序列化器
- 压缩 - Int、long 和字符串压缩
- 故障排除 - 常见问题和解决方案