Apache Fury在GraalVM原生镜像中的实践指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00863/article/details/148578881

Apache Fury在GraalVM原生镜像中的实践指南

fury A blazingly fast multi-language serialization framework powered by JIT and zero-copy. 项目地址: https://gitcode.com/gh_mirrors/fury3/fury

什么是GraalVM原生镜像

GraalVM原生镜像技术能够将Java代码预先编译(AOT)为本地机器码，从而构建出启动更快、体积更小、资源占用更低的应用程序。与传统的JVM运行方式不同，原生镜像不包含JIT编译器，也不支持反射操作（除非显式配置反射文件）。

为什么选择Apache Fury

Apache Fury在GraalVM原生镜像环境中表现优异，主要原因在于：

性能优势：Fury会在GraalVM构建时生成所有序列化器代码（包括JIT框架和MethodHandle/LambdaMetafactory相关代码），运行时直接使用这些预生成的代码，无需额外开销。
配置简化：相比GraalVM原生要求的手动配置反射JSON和序列化JSON文件，使用Fury只需简单调用register方法注册需要序列化的类，大幅降低了配置复杂度。
自动适配：Fury会自动禁用asyncCompilationEnabled选项，因为原生镜像运行时环境不支持JIT编译。

使用指南

基础配置要求

必须将Fury实例声明为类的静态字段
必须在类初始化时注册所有需要序列化的类
需要在resources/META-INF/native-image/$xxx/native-image.properties中配置构建时初始化类

非线程安全模式示例

public class Example {
  // 记录类定义
  public record Record(int f1, String f2, List<String> f3, Map<String, Long> f4) {}
  
  // 静态Fury实例
  static Fury fury;
  
  static {
    fury = Fury.builder().build();
    fury.register(Record.class, true); // 注册并生成序列化代码
  }
  
  public static void main(String[] args) {
    Record record = new Record(10, "abc", List.of("str1", "str2"), Map.of("k1", 10L, "k2", 20L));
    byte[] bytes = fury.serialize(record);
    Object o = fury.deserialize(bytes);
  }
}

对应的native-image.properties配置：

Args = --initialize-at-build-time=org.apache.fury.graalvm.Example

线程安全模式示例

public class ThreadSafeExample {
  public record Foo(int f1, String f2, List<String> f3, Map<String, Long> f4) {}
  
  static ThreadSafeFury fury;
  
  static {
    fury = new ThreadLocalFury(classLoader -> {
      Fury f = Fury.builder().build();
      f.register(Foo.class, true);
      return f;
    });
  }
  
  public static void main(String[] args) {
    Foo foo = new Foo(10, "abc", List.of("str1", "str2"), Map.of("k1", 10L, "k2", 20L));
    byte[] bytes = fury.serialize(foo);
    Object o = fury.deserialize(bytes);
  }
}