Apache Fury 序列化框架新增字段显式标记功能解析

Apache Fury 作为一款高性能的 Java 序列化框架，近期在社区推动下新增了一个重要特性：通过注解显式标记需要序列化的字段。这一改进解决了传统序列化方案中需要大量标记 transient 字段的痛点，为开发者提供了更灵活的字段控制能力。

功能背景

在传统的 Java 序列化方案中，开发者若想排除某些字段的序列化，通常需要将其标记为 transient。但在某些场景下，特别是迁移现有项目时，项目中可能已经使用了自定义注解来标记需要序列化的字段，此时若要求将所有非序列化字段改为 transient 会带来大量改造工作。

Apache Fury 的新特性允许开发者通过简单的注解配置，实现"仅序列化标记字段"的模式，这与常见的 ORM 框架（如 Hibernate）中通过注解标记持久化字段的思路一致，大大提升了框架的易用性。

技术实现

框架新增了 @Expose 注解作为字段级别的标记。当类中的字段被标记为该注解时，Fury 序列化器将只处理这些被显式标记的字段，忽略其他所有未标记字段。这一行为与现有的 @Ignore 注解形成了互斥关系——两者不能同时作用于同一字段。

实现核心位于 Descriptor 类的字段描述符创建逻辑中。框架在构建字段描述符映射时，会检查字段上的注解标记，根据配置决定是否包含该字段到最终的序列化流程中。

使用示例

开发者可以通过以下方式使用这一新特性：

@Data
@AllArgsConstructor
class UserData {
  @Expose private int userId;      // 将被序列化
  @Expose private String username; // 将被序列化
  private String password;         // 不会被序列化
  private transient String token;  // 传统方式标记不序列化
}

当配置 Fury 使用显式标记模式后，序列化 UserData 对象时只会处理 userId 和 username 字段，其他字段（包括非 transient 的 password）都会被自动忽略。

设计考量

在功能设计过程中，社区重点讨论了以下几个关键点：

1. 注解命名：最终选定 @Expose 作为标准注解名称，既保持了简洁性，又准确表达了其功能含义
2. 兼容性处理：与现有 @Ignore 注解形成互斥关系，避免配置冲突
3. 错误处理：当检测到字段同时标记了 @Expose 和 @Ignore 时，框架会抛出 RuntimeException

最佳实践

对于考虑采用这一特性的开发者，建议：

1. 在领域模型定义中保持一致性，选择单一策略（要么全量序列化+transient排除，要么显式标记）
2. 对于新项目，显式标记模式能提供更清晰的序列化边界控制
3. 迁移现有项目时，可逐步将原有注解替换为 @Expose

该特性已合并到主分支，用户可以通过 snapshot 版本进行测试体验，预计将在近期发布的正式版本中提供给所有用户。这一改进进一步丰富了 Apache Fury 的序列化策略选项，使其能够适应更多样化的应用场景。