Json Dom 怎么玩转？

在如今的 Java 开发中，虽然已经有了 Jackson、Gson 和 Fastjson2 等重量级选手，但 Snack4（及其历史版本，统称为 Snack 序列）凭借其独特的 "JSON DOM" 模式，在复杂数据处理和动态转换场景中杀出了一条血路。

很多开发者习惯了传统的 Bean -> JSON 映射，而面对不规则数据、深层嵌套或动态结构时，往往感到力不从心。今天我们就结合 Snack 的核心设计，聊聊 JSON DOM 到底该怎么玩？

一、 什么是 JSON DOM？

在传统的 POJO 模式中，我们需要先定义好类结构。如果 JSON 多出一个字段或少一个字段，处理起来会很麻烦。

JSON DOM (Document Object Model) 的思路则完全不同：它将一段 JSON 数据看作一棵树。你可以像操作 HTML DOM 一样，通过节点路径去增删改查，而不需要预先定义繁琐的 Java Bean。

Snack4 的核心对象是 ONode，它既是一个节点，也是整棵树的入口。类似于 Xml Node。

依赖包	描述
org.noear:snack4	提供 dom 构建与编解码基础支持
org.noear:snack4-jsonpath	提供 json path 查询支持
org.noear:snack4-jsonschema	提供 json schema 校验支持

二、 核心玩法：快速上手

1. 任意转换：一句话搞定

Snack4 最强大的地方在于它极度简洁的 API。

// JSON 字符串转为 ONode (DOM 结构)
ONode node = ONode.ofJson(jsonString);

// 将 ONode 转回 JSON 字符串
String json = node.toJson();

// 将 ONode 转为 Java Bean
User user = node.toBean(User.class);

2. 链式操作：像导航一样优雅

假设你有如下嵌套 JSON：{"user": {"address": {"city": "Shanghai"}}}。 如果你想获取城市名，传统写法需要多次判空，但在 Snack4 中：

String city = node.get("user").get("address").get("city").getString();

如果其中任何一级不存在，它会返回一个"虚拟节点"而不是 null，从而有效避免了 NullPointerException。

三、 进阶玩法：玩转动态数据

1. 路径导航 (JsonPath)

Snack4 支持类似 XPath 的路径选择器，这是玩转 DOM 的精髓：

// 获取数组中所有用户的名字
List<String> names = node.select("$.users[*].name").toBean(List.class);

// 修改某个深层属性
node.select("$.order.price").fill(99.9);

2. 动态构建：告别 Map 嵌套

如果你需要手动拼装一个复杂的 JSON，不需要再写 Map<String, Object> map = new HashMap<>()：

ONode data = new ONode();
data.get("id").setValue(1001);
data.get("tags").add("Java").add("JSON");
data.get("info").get("status").setValue("active");

System.out.println(data.toJson());

3. 灵活的数据转换 (From & To)

Snack4 不仅能处理 JSON，它本质上是一个通用数据转换引擎。

• Map/List -> ONode
• Entity -> ONode
• ONode -> XML (需要插件支持)

这种中转站式的设计，让你在处理不同来源的数据时，能统一成 ONode 这一种形态进行逻辑加工。

ONode.ofJson(json).toBean(UserDto.class);
ONode.ofBean(map).toBean(UserDto.class);
ONode.ofBean(new UserInfo()).toBean(UserDto.class);

四、 为什么选择 Snack 这种模式？

1. 轻量级：没有沉重的依赖，非常适合分布式环境、微服务或安卓开发。
2. 弱类型友好：对于对接第三方 API（结构不稳定）、处理大字段或日志分析等场景，JSON DOM 模式比 POJO 模式灵活。
3. 极简 API：所有的操作几乎都围绕 ONode 展开，学习成本极低。

五、 总结

如果说传统的 JSON 框架是"模具浇筑"（必须先有类），那么 Snack4 就是"橡皮泥捏造"（随心所欲变形）。

放下对 POJO 的执念，尝试用树的思想去俯瞰数据。 当你学会了用 ONode 自由穿梭在 JSON 结构中时，你会发现处理数据竟然可以如此丝滑。