首页
/ Apache Fory 0.11.0版本中的序列化器变更与问题解析

Apache Fory 0.11.0版本中的序列化器变更与问题解析

2025-06-25 18:18:59作者:卓炯娓

Apache Fory作为一款高性能的Java序列化框架,在0.11.0版本中引入了一些重要的架构变更,特别是针对Map和Collection类型序列化的处理方式。这些变更虽然带来了更优化的性能设计,但也导致了一些兼容性问题。

序列化器继承体系变更

在0.11.0版本中,Fory对Map和Collection类型的序列化器提出了新的要求:必须分别继承AbstractMapSerializer和AbstractCollectionSerializer。这一变更背后的设计理念是为了更好地支持代码生成(codegen)优化路径。

当序列化包含Map或Collection字段的类时,Fory会检查序列化器是否支持代码生成优化。如果支持,序列化过程将采用更高效的路径:

  1. 写入Map/Collection类信息(如果不是final类)
  2. 写入大小信息
  3. 调用onCollectionWrite方法
  4. 使用生成的代码序列化键值对或元素

对于不支持代码生成的序列化器,框架会回退到传统的Serializer.write方法。这种设计特别适合处理Scala集合等不符合Java集合接口规范的类。

常见问题与解决方案

1. 序列化器继承验证错误

开发者可能会遇到类似"Serializer must extend AbstractMapSerializer"的错误。这表示自定义的Map/Collection序列化器没有继承框架要求的基类。

解决方案有两种:

  • 继承MapSerializer(更简单)
  • 继承AbstractMapSerializer(更灵活)
// 简单实现方案
public class CustomMapSerializer extends MapSerializer<CustomMap> {
    public CustomMapSerializer(Fury fury) {
        super(fury, CustomMap.class);
    }
}

2. 空指针异常问题

0.11.0版本中引入的一个bug会导致在某些情况下抛出NullPointerException。这个问题已在后续提交中被修复,建议开发者升级到包含修复的版本。

性能考量

开发者需要注意,使用框架自动生成的序列化代码通常比自定义序列化器更快,除非自定义实现能够利用数据的特定属性进行优化。框架生成的代码路径经过高度优化,在大多数情况下都能提供最佳性能。

对于追求极致序列化大小的场景,自定义序列化器仍然有价值。例如,原始问题中提到的一个案例中,自定义序列化器将数据大小从104字节优化到了44字节。

最佳实践建议

  1. 对于标准Map/Collection实现,优先使用框架自动生成的序列化
  2. 对于自定义集合类,根据需求选择继承MapSerializer或AbstractMapSerializer
  3. 在性能与序列化大小之间权衡,选择最适合应用场景的方案
  4. 关注框架文档更新,了解最新的序列化器实现指南

未来版本中,AbstractMapSerializer可能会更名为MapLikeSerializer以更准确地反映其用途,这将使API设计更加直观。开发者可以关注这一变更,但当前版本中仍应按照现有规范实现序列化器。

通过理解这些变更背后的设计理念和掌握正确的实现方法,开发者可以充分利用Fory框架提供的高性能序列化能力,同时避免升级过程中的兼容性问题。

登录后查看全文
热门项目推荐

项目优选

收起
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
122
175
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
824
492
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
164
256
HarmonyOS-ExamplesHarmonyOS-Examples
本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
388
366
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
176
260
MateChatMateChat
前端智能化场景解决方案UI库,轻松构建你的AI应用,我们将持续完善更新,欢迎你的使用与建议。 官网地址:https://matechat.gitcode.com
719
102
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
324
1.07 K
ShopXO开源商城ShopXO开源商城
🔥🔥🔥ShopXO企业级免费开源商城系统,可视化DIY拖拽装修、包含PC、H5、多端小程序(微信+支付宝+百度+头条&抖音+QQ+快手)、APP、多仓库、多商户、多门店、IM客服、进销存,遵循MIT开源协议发布、基于ThinkPHP8框架研发
JavaScript
89
15
note-gennote-gen
一款跨平台的 Markdown AI 笔记软件,致力于使用 AI 建立记录和写作的桥梁。
TSX
79
2
WxJavaWxJava
微信开发 Java SDK,支持微信支付、开放平台、公众号、视频号、企业微信、小程序等的后端开发,记得关注公众号及时接受版本更新信息,以及加入微信群进行深入讨论
Java
820
22