SJF4J：Java 的结构化 JSON 门面

Source: Dev.to

引言

在 Java 中处理 JSON 通常意味着在两种方式之间做选择：

• 数据绑定（POJO） – 强类型，但僵硬
• 树模型（JsonNode / Map） – 灵活，但无结构

大多数库迫使你只能选其一并接受相应的权衡。

SJF4J（Simple JSON Facade for Java）采用了不同的思路：

• 不是 JSON 解析器 – 它是构建在现有解析器（如 Jackson）之上的外观层
• 提供 统一的节点模型
• 支持 结构化 + 动态访问
• 提供 基于模式的能力
• 实现 JSON 语义操作

目标是让 JSON 处理更加一致、富表达且可扩展。在 SJF4J 中，所有 JSON 值都被视为具有统一行为的节点。你可以通过以下方式对其进行操作：

• 面向对象的 API（JsonObject、JsonArray）
• 静态工具类（Nodes）

支持两种访问风格：

• toXxx() → 类型安全访问
• asXxx() → 语义转换

这消除了在不同解析风格之间频繁切换的需求。

混合模型（JOJO）

一个关键特性是 SJF4J 不强制在 POJO 与动态 JSON 之间划定严格边界。你可以定义结构化字段，同时仍然允许灵活扩展。

public class Student extends JsonObject {
    private String name;
    private Map scores;
    private List friends;
}

这既不是传统的 POJO，也不是原始的 JSON 树——它是 SJF4J 所称的 JOJO（JSON Object Java Object）混合模型。

核心特性

导航与 Patch

• 类似 JSON Path 的导航
• Patch 风格的更新

student.putByPath("$.profile.name", "Alice");

这些特性让你无需手动遍历即可操作深层嵌套结构。

模式集成

SJF4J 将 JSON Schema 作为运行时概念进行集成：

• 动态验证数据
• 支持条件规则
• 将领域不变式与运行时约束分离

这补充了传统的验证方式，如 Jakarta Bean Validation。

横切操作

• 路径导航
• Patch 更新
• 模式验证

全部基于现有解析器构建，性能取决于底层实现。

性能考虑

• 在典型场景下开销适中。
• 在某些情况下（例如 JOJO + 优化 I/O），性能可与直接使用解析器相当，甚至略有提升。

设计目标是在不显著增加成本的前提下提供丰富能力。

何时使用 SJF4J

适用场景：

• JSON 结构部分是动态的。
• 需要既有类型化访问又有灵活字段。
• 模式随时间演进。
• 需要统一的 JSON 操作模型。

不太需要的情况：

• 你的模式完全静态。
• 只需要简单的序列化/反序列化。

与其他库的关系

Jackson 和 Gson 擅长：

• 序列化 / 反序列化
• 数据绑定

SJF4J 关注的是不同的层面：

• 将 JSON 视为 结构化数据模型
• 横切操作（路径、Patch、模式）
• 静态 + 动态的混合访问

它 不 替代现有库，而是基于它们之上构建。

项目

https://github.com/sjf4j-projects/sjf4j