java中json怎么用

Java中处理JSON数据是一项常见的任务，但Java本身并未内置对JSON的支持，因此需要依赖第三方库来实现这一功能,以下是几种主流的JSON处理方案及其详细用法：

常用JSON库对比

库名称	开发背景	特点	适用场景
Gson	谷歌开发	API简单易用，支持泛型、注解配置，适合快速开发	小型项目或需要简洁代码的场景
Jackson	FasterXML社区维护	高性能、功能全面（如流式解析）、支持复杂数据结构及高级特性	企业级应用、高吞吐量系统
FastJson	阿里巴巴开源	国产优秀方案，解析速度快且占用内存低，兼容特殊语法（如注释）	国内环境优先选择
org.json	Apache孵化	轻量级基础实现，无额外依赖，但功能相对有限	简单需求或学习用途

---

Gson的核心操作示例

添加依赖（Maven配置）

<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.8.9</version>
</dependency>

对象与JSON互转

假设有一个用户类 User：

class User {
    private String name;
    private int age;
    // getters/setters省略...
}

• 序列化（Java→JSON）：将对象转为JSON字符串，例如创建用户实例后调用 Gson().toJson()：

  User user = new User("Alice", 30);
  Gson gson = new Gson();
  String jsonStr = gson.toJson(user); // {"name":"Alice","age":30}

• 反序列化（JSON→Java）：通过 fromJson() 方法重建对象：

  String jsonInput = "{"name":"Bob","age":25}";
  User newUser = gson.fromJson(jsonInput, User.class);

集合类型的处理

对于List或Map等复杂结构同样适用：

List<User> users = Arrays.asList(new User("Charlie", 40), new User("David", 28));
Type listType = new TypeToken<List<User>>(){}.getType(); // 获取泛型类型信息
String listJson = gson.toJson(users, listType); // [{"name":"Charlie","age":40},...]

---

Jackson的高级特性实践

集成方式（Maven坐标）

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.13.1</version>
</dependency>

对象映射与注解控制

通过注解可精准调控字段行为：

class Product {
    @JsonProperty("p_id") private Long id;      // 自定义键名
    @JsonInclude(JsonInclude.Include.NON_NULL) String description; // 忽略null值
    // ...其他字段
}

使用时配合 ObjectMapper：

ObjectMapper om = new ObjectMapper();
om.enable(SerializationFeature.INDENT_OUTPUT); // 美化输出格式
String prettyPrintedJson = om.writeValueAsString(product);

流式API提升性能

针对大文件或网络传输场景,采用逐事件读取模式避免全量加载内存：

JsonParser parser = om.getFactory().createParser(new File("largeData.json"));
while (parser.nextToken() != null) {
    if (JsonToken.START_OBJECT == parser.currentToken()) {
        // 处理每个独立的对象片段
    }
}

---

FastJson的特色功能

作为国产利器,其独特优势包括：

• 异步支持：基于NIO实现非阻塞解析；
• 脚本引擎兼容：允许嵌入JavaScript表达式动态修改数据；
• 日期格式化插件：内置多种时间格式自适应解析，典型用法如下：

  // Maven依赖
  <dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.83</version>
  </dependency>
  // 代码示例
  JSONObject jsonObj = JSONObject.parseObject(jsonStr);
  User parsedUser = jsonObj.toJavaObject(User.class);

---

异常处理最佳实践

无论使用哪种库，都应捕获并妥善处理以下异常情况：
| 错误类型 | 可能原因 | 解决方案 |
|————————|——————————|——————————|
| JsonSyntaxException | JSON文本不符合规范 | 校验输入源的数据合法性 |
| MismatchedInputException| 结构不匹配（如类型冲突） | 检查Java类与JSON结构的对应关系|
| UnrecognizedPropertyException | 存在多余字段 | 配置忽略策略（如@JsonIgnore）|

例如在Gson中可通过注册类型适配器增强鲁棒性：

gsonBuilder.registerTypeAdapterFactory(new MyCustomAdapterFactory());

---

性能优化建议

1. 复用解析器实例：避免频繁创建新对象；
2. 禁用不必要的特性：如Jackson中的自动缩进功能仅调试时启用；
3. 合理设置缓冲区大小：特别是处理大文件时调整IO缓冲参数；
4. 预热机制：启动阶段预加载核心类减少运行时开销。

---

FAQs

Q1: 如何选择最适合项目的JSON库？
A: 根据具体需求权衡：①轻量化选Gson；②高性能复杂场景用Jackson；③国内环境优先考虑FastJson；④纯学术目的可用org.json，同时需考虑社区活跃度、文档完善度等因素。

Q2: 遇到循环引用导致栈溢出怎么办？
A: 所有主流库均提供解决方案：Gson通过serializeSpecialFloatingPointValues=false配置断环；Jackson则使用@JsonManagedReference与@JsonBackReference注解实现双向关联管理