Scala 序列化指南

Apache Fory™ Scala 为 Scala 类型提供优化的序列化器，构建在 Fory Java 之上。它支持所有 Scala 对象序列化：

• case 类序列化
• pojo/bean 类序列化
• object 单例序列化
• collection 序列化（Seq、List、Map 等）
• tuple 和 either 类型
• Option 类型
• Scala 2 和 3 枚举

同时支持 Scala 2 和 Scala 3。

特性

Fory Scala 继承了 Fory Java 的所有特性，并增加了 Scala 特定的优化：

• 高性能：JIT 代码生成、零拷贝、比传统序列化快 20-170 倍
• Scala 类型支持：为 case 类、单例、集合、元组、Option、Either 提供优化的序列化器
• 默认值支持：在 schema 演化期间自动处理 Scala 类的默认参数
• 单例保持：object 单例在反序列化后保持引用相等性
• Schema 演化：支持类 schema 变更的前向/后向兼容性

查看 Java 特性获取完整特性列表。

安装

使用 sbt 添加依赖：

libraryDependencies += "org.apache.fory" %% "fory-scala" % "0.14.1"

快速开始

import org.apache.fory.Fory
import org.apache.fory.serializer.scala.ScalaSerializers

case class Person(name: String, id: Long, github: String)
case class Point(x: Int, y: Int, z: Int)

object ScalaExample {
  // 创建启用 Scala 优化的 Fory
  val fory: Fory = Fory.builder()
    .withScalaOptimizationEnabled(true)
    .build()

  // 为 Scala 注册优化的 Fory 序列化器
  ScalaSerializers.registerSerializers(fory)

  // 注册你的类
  fory.register(classOf[Person])
  fory.register(classOf[Point])

  def main(args: Array[String]): Unit = {
    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 Scala 构建在 Fory Java 之上。大多数配置选项、特性和概念都直接适用于 Scala。请参考 Java 文档：

• 配置选项 - 所有 ForyBuilder 选项
• 基础序列化 - 序列化模式和 API
• 类型注册 - 类注册和安全性
• Schema 演化 - 前向/后向兼容性
• 自定义序列化器 - 实现自定义序列化器
• 压缩 - Int、long 和 string 压缩
• 故障排查 - 常见问题和解决方案

Scala 特定文档

• Fory 创建 - Scala 特定的 Fory 设置要求
• 类型序列化 - 序列化 Scala 类型
• 默认值 - Scala 类默认值支持