本文将介绍如何在 Spring Boot 应用中接收和处理包含动态字段的 JSON 对象。通过使用 Jackson 库提供的 JsonNode 类，你可以灵活地解析和操作 JSON 数据，而无需预先定义固定的 Java 类结构。这对于处理 schema 不固定的 API 请求非常有用，允许你以通用的方式访问和处理 JSON 数据的各个部分。
使用 JsonNode 处理动态 JSON
当你的 API 接收到的 JSON 结构不固定，或者包含大量可选字段时，预先定义一个完整的 Java 类来映射 JSON 结构可能并不方便。这时，com.fasterxml.jackson.databind.JsonNode 就派上用场了。JsonNode 是 Jackson 库中表示 JSON 节点的抽象类，它可以表示 JSON 对象、数组、数字、字符串等。
示例代码
以下是一个 Spring Boot 控制器示例，展示了如何使用 JsonNode 接收和处理 JSON 请求：
package com.example.demo.controller;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
import com.fasterxml.jackson.databind.JsonNode;
@RestController
public class DemoController {
@RequestMapping(value="/ping",method = RequestMethod.POST)
public JsonNode index(@RequestBody JsonNode jsonNode) {
System.out.println("Received JSON:"+jsonNode.toString());
return jsonNode;
}
}在这个例子中，@RequestBody JsonNode jsonNode 注解告诉 Spring 将请求体中的 JSON 数据绑定到 JsonNode 对象。 jsonNode.toString() 方法可以将 JsonNode 对象转换为字符串输出，方便查看接收到的 JSON 数据。
如何访问 JsonNode 中的数据
JsonNode 提供了多种方法来访问 JSON 数据：
- jsonNode.get("fieldName"): 获取指定字段的值，返回一个 JsonNode 对象。如果字段不存在，返回 null。
- jsonNode.path("fieldName"): 获取指定字段的值，返回一个 JsonNode 对象。如果字段不存在，返回 MissingNode 对象，它是一个特殊的 JsonNode，表示缺失的节点，避免了空指针异常。
- jsonNode.isObject(): 检查节点是否是 JSON 对象。
- jsonNode.isArray(): 检查节点是否是 JSON 数组。
- jsonNode.asText(): 将节点的值转换为字符串。
- jsonNode.asInt(): 将节点的值转换为整数。
- jsonNode.elements(): 获取 JSON 数组的迭代器。
- jsonNode.fieldNames(): 获取 JSON 对象字段名的迭代器。
以下是一个更完整的示例，展示了如何从 JsonNode 中提取数据：
@RestController
public class DemoController {
@RequestMapping(value="/process",method = RequestMethod.POST)
public String processJson(@RequestBody JsonNode jsonNode) {
// 获取 "Person" 对象
JsonNode personNode = jsonNode.get("Person");
if (personNode != null && personNode.isObject()) {
// 获取 "name" 字段
String name = personNode.get("name").asText();
// 获取 "age" 字段
int age = personNode.get("age").asInt();
// 获取 "hobby" 对象
JsonNode hobbyNode = personNode.get("hobby");
if (hobbyNode != null && hobbyNode.isObject()) {
// 遍历 "hobby" 对象中的字段
hobbyNode.fieldNames().forEachRemaining(field -> {
String value = hobbyNode.get(field).asText();
System.out.println("Hobby: " + field + " = " + value);
});
}
System.out.println("Name: " + name);
System.out.println("Age: " + age);
}
// 获取 "attribute" 字段
String attribute = jsonNode.get("attribute").asText();
System.out.println("Attribute: " + attribute);
return "Processed JSON";
}
}在这个示例中，我们首先获取 Person 对象，然后从中提取 name 和 age 字段。 接着，我们获取 hobby 对象，并使用 fieldNames() 方法遍历其所有字段，并打印出字段名和对应的值。最后，我们获取 attribute 字段的值。
注意事项
- 在使用 asText()、asInt() 等方法时，要确保节点的值是对应的数据类型，否则可能会抛出异常。
- 可以使用 jsonNode.has("fieldName") 方法检查节点是否包含指定的字段，避免访问不存在的字段。
- JsonNode 是不可变的，对 JsonNode 的修改会返回一个新的 JsonNode 对象。
总结
使用 JsonNode 可以方便地处理动态 JSON 数据，无需预先定义固定的 Java 类结构。 通过 get(), path(), asText(), asInt() 等方法，可以灵活地访问和操作 JSON 数据。 在处理不确定结构的 JSON 数据时，JsonNode 是一个非常有用的工具。
