在Java开发中，处理JSON数据是一项常见任务，无论是从API接口获取数据，还是读取配置文件，掌握JSON的读取方法都是必备技能，本文将详细介绍如何使用Java读取JSON数据，涵盖多种主流库的使用方法、核心代码示例及注意事项,帮助开发者快速上手实践。
JSON与Java的关联性
JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，以键值对的形式组织数据，结构清晰且易于人阅读和机器解析，在Java中，JSON数据通常需要转换为Java对象（如POJO、List、Map等）才能进行业务处理，这一过程称为“反序列化”，选择合适的JSON库可以简化开发流程，常见的Java JSON处理库包括Gson、Jackson、org.json等，它们各具特点,适用于不同场景。
使用Gson读取JSON
Google开发的Gson库是处理JSON的常用工具，其API简洁，支持复杂对象的转换，以下是使用Gson读取JSON的核心步骤：
添加依赖
在Maven项目的pom.xml中引入Gson依赖：
<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.10.1</version>
</dependency>
基本JSON解析
Gson通过JsonParser解析JSON字符串，并通过JsonElement获取数据：
import com.google.gson.JsonParser;
import com.google.gson.JsonElement;
String jsonStr = "{\"name\":\"张三\",\"age\":25,\"city\":\"北京\"}";
JsonElement jsonElement = JsonParser.parseString(jsonStr);
String name = jsonElement.getAsJsonObject().get("name").getAsString();
int age = jsonElement.getAsJsonObject().get("age").getAsInt();
System.out.println("姓名：" + name + "，年龄：" + age);
转换为Java对象
若JSON数据结构固定，可定义对应的Java类（POJO），通过Gson直接转换为对象：
class User {
private String name;
private int age;
private String city;
// 省略getter和setter方法
}
Gson gson = new Gson();
User user = gson.fromJson(jsonStr, User.class);
System.out.println("用户信息：" + user.getName() + "，" + user.getCity());
处理复杂JSON
对于嵌套JSON或数组，可通过递归或泛型实现转换，例如解析包含数组的JSON：
String jsonArrayStr = "[{\"name\":\"李四\",\"age\":30},{\"name\":\"王五\",\"age\":28}]";
User[] users = gson.fromJson(jsonArrayStr, User[].class);
for (User u : users) {
System.out.println(u.getName());
}
使用Jackson读取JSON
Jackson是另一个高性能的JSON库，广泛应用于Spring框架等企业级开发，其功能强大，支持流式处理、数据绑定等多种模式。
添加依赖
Maven依赖配置：
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.15.2</version>
</dependency>
基本对象绑定
Jackson通过ObjectMapper实现JSON与对象的转换：
import com.fasterxml.jackson.databind.ObjectMapper;
ObjectMapper mapper = new ObjectMapper();
User user = mapper.readValue(jsonStr, User.class);
System.out.println("Jackson解析结果：" + user.getCity());
解析JSON树模型
与Gson类似，Jackson提供JsonNode模型处理动态JSON：
import com.fasterxml.jackson.databind.JsonNode;
JsonNode rootNode = mapper.readTree(jsonStr);
JsonNode nameNode = rootNode.path("name");
System.out.println("姓名：" + nameNode.asText());
处理日期和复杂类型
Jackson支持自定义日期格式处理，
ObjectMapper mapper = new ObjectMapper();
mapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd"));
String dateJson = "{\"birthday\":\"1998-05-20\"}";
User user = mapper.readValue(dateJson, User.class);
使用org.json读取JSON
org.json是一个轻量级JSON库，无需额外依赖（仅需org.json包），适合简单场景。
基本解析
import org.json.JSONObject;
String jsonStr = "{\"name\":\"赵六\",\"age\":35}";
JSONObject jsonObject = new JSONObject(jsonStr);
String name = jsonObject.getString("name");
int age = jsonObject.getInt("age");
System.out.println("姓名：" + name + "，年龄：" + age);
解析JSON数组
import org.json.JSONArray;
String jsonArrayStr = "[{\"name\":\"钱七\",\"age\":40}]";
JSONArray jsonArray = new JSONArray(jsonArrayStr);
JSONObject firstObj = jsonArray.getJSONObject(0);
System.out.println("姓名：" + firstObj.getString("name"));
不同库的适用场景
- Gson：适合Android开发或需要简单API的场景，对泛型和复杂对象支持友好。
- Jackson：性能优异，支持流式处理（适合大文件解析），是企业级开发的首选。
- org.json：轻量级，适合小型项目或仅需基础JSON操作的场景，无需引入复杂依赖。
注意事项
- 异常处理：JSON解析时需处理
JsonSyntaxException（Gson）、JsonProcessingException（Jackson）等异常，避免程序崩溃。 - 字段匹配：POJO类的字段名需与JSON的key一致，可通过
@SerializedName（Gson）或@JsonProperty（Jackson）注解自定义映射关系。 - 性能优化：对于频繁JSON操作，建议复用
Gson或ObjectMapper实例，避免重复创建。 - 安全性：避免直接解析不可信的JSON数据，防止恶意输入导致的安全风险（如注入攻击）。
Java读取JSON数据的方法多样，开发者可根据项目需求选择合适的库，Gson和Jackson功能全面，适合复杂业务场景；org.json则以其轻便性适合简单任务，掌握核心API、异常处理及性能优化技巧，能显著提升开发效率，在实际应用中，建议结合具体场景灵活选择工具,确保代码的健壮性和可维护性。
