如何使用Java获取JSON数据：从入门到实践
在当今的软件开发中,JSON（JavaScript Object Notation）已成为数据交换的主流格式之一，无论是调用第三方API、处理前端传来的数据，还是读取配置文件，我们经常需要使用Java来解析和获取JSON数据，本文将详细介绍如何使用Java获取JSON数据，涵盖从基础库到流行框架的多种方法，并提供实用示例。
JSON与Java：基础认知
JSON是一种轻量级的数据交换格式,以易于阅读和编写的文本形式存储和传输数据，其基本结构包括：
- 对象：无序的键值对集合，用 包裹，如
{"name":"张三", "age":25}。 - 数组：有序的值列表，用
[]包裹，如[{"name":"李四"}, {"name":"王五"}]。
Java本身没有内置的JSON处理类,因此需要借助第三方库或框架来解析JSON，目前主流的工具有：
- 原生JSON库：如
org.json（简单易用，适合轻量级场景）。 - Jackson：高性能，功能强大，是Spring框架的默认JSON处理器。
- Gson：Google开发，简洁易用，适合对象与JSON的互转。
- Fastjson：阿里巴巴开发，解析速度快，但需注意版本安全性（建议使用2.x版本）。
使用org.json库获取JSON数据
org.json是一个轻量级的JSON处理库，无需额外依赖（仅需添加jar包或Maven依赖），适合快速处理JSON数据。
添加依赖
Maven依赖：
<dependency>
<groupId>org.json</groupId>
<artifactId>json</artifactId>
<version>20231013</version>
</dependency>
解析JSON对象
假设有以下JSON字符串：
String jsonString = "{\"name\":\"张三\", \"age\":25, \"isStudent\":false}";
获取JSON中的数据：
import org.json.JSONObject;
public class OrgJsonExample {
public static void main(String[] args) {
String jsonString = "{\"name\":\"张三\", \"age\":25, \"isStudent\":false}";
// 将JSON字符串转换为JSONObject对象
JSONObject jsonObject = new JSONObject(jsonString);
// 获取字符串类型的值
String name = jsonObject.getString("name");
System.out.println("姓名: " + name);
// 获取整数类型的值
int age = jsonObject.getInt("age");
System.out.println("年龄: " + age);
// 获取布尔类型的值
boolean isStudent = jsonObject.getBoolean("isStudent");
System.out.println("是否为学生: " + isStudent);
// 获取值（默认返回String，可通过第二个参数指定类型）
String ageStr = jsonObject.getString("age");
System.out.println("年龄（字符串）: " + ageStr);
}
}
解析JSON数组
假设有以下JSON数组字符串：
String jsonArrayString = "[{\"name\":\"李四\", \"age\":30}, {\"name\":\"王五\", \"age\":28}]";
获取数组中的数据：
import org.json.JSONArray;
import org.json.JSONObject;
public class OrgJsonArrayExample {
public static void main(String[] args) {
String jsonArrayString = "[{\"name\":\"李四\", \"age\":30}, {\"name\":\"王五\", \"age\":28}]";
// 将JSON字符串转换为JSONArray对象
JSONArray jsonArray = new JSONArray(jsonArrayString);
// 遍历数组
for (int i = 0; i < jsonArray.length(); i++) {
JSONObject jsonObject = jsonArray.getJSONObject(i);
String name = jsonObject.getString("name");
int age = jsonObject.getInt("age");
System.out.println("第" + (i + 1) + "个人: " + name + ", 年龄: " + age);
}
}
}
处理嵌套JSON
JSON数据可能是嵌套的,
String nestedJsonString = "{\"user\":{\"name\":\"赵六\", \"contact\":{\"email\":\"zhaoliu@example.com\", \"phone\":\"13800138000\"}}, \"level\":\"VIP\"}";
获取嵌套数据：
import org.json.JSONObject;
public class NestedJsonExample {
public static void main(String[] args) {
String nestedJsonString = "{\"user\":{\"name\":\"赵六\", \"contact\":{\"email\":\"zhaoliu@example.com\", \"phone\":\"13800138000\"}}, \"level\":\"VIP\"}";
JSONObject jsonObject = new JSONObject(nestedJsonString);
// 获取嵌套的JSONObject
JSONObject userObject = jsonObject.getJSONObject("user");
String name = userObject.getString("name");
System.out.println("用户名: " + name);
// 获取多层嵌套的值
JSONObject contactObject = userObject.getJSONObject("contact");
String email = contactObject.getString("email");
String phone = contactObject.getString("phone");
System.out.println("邮箱: " + email);
System.out.println("电话: " + phone);
// 获取顶层值
String level = jsonObject.getString("level");
System.out.println("会员等级: " + level);
}
}
使用Jackson获取JSON数据
Jackson是Java生态中最流行的JSON库之一,广泛应用于Spring Boot、微服务等框架，它提供了高性能的流式API（JsonParser）和树模型（JsonNode），适合处理复杂JSON数据。
添加依赖
Maven依赖：
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.15.2</version>
</dependency>
解析JSON为JsonNode（树模型）
JsonNode是Jackson的树模型，类似于XML的DOM解析，适合动态获取JSON数据（尤其是当JSON结构不固定时）。
示例：
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
public class JacksonExample {
public static void main(String[] args) throws Exception {
String jsonString = "{\"name\":\"钱七\", \"age\":35, \"hobbies\":[\"阅读\", \"旅行\", \"摄影\"]}";
// 创建ObjectMapper对象
ObjectMapper objectMapper = new ObjectMapper();
// 将JSON字符串转换为JsonNode对象
JsonNode jsonNode = objectMapper.readTree(jsonString);
// 获取普通字段
String name = jsonNode.get("name").asText();
int age = jsonNode.get("age").asInt();
System.out.println("姓名: " + name);
System.out.println("年龄: " + age);
// 获取数组字段
JsonNode hobbiesNode = jsonNode.get("hobbies");
System.out.print("爱好: ");
for (JsonNode hobby : hobbiesNode) {
System.out.print(hobby.asText() + " ");
}
System.out.println();
// 处理嵌套JSON（假设有嵌套结构）
String nestedJson = "{\"user\":{\"name\":\"孙八\", \"address\":{\"city\":\"北京\", \"district\":\"朝阳区\"}}}";
JsonNode nestedNode = objectMapper.readTree(nestedJson);
String city = nestedNode.get("user").get("address").get("city").asText();
System.out.println("城市: " + city);
}
}
将JSON转换为Java对象（POJO）
如果JSON结构固定,可以将其转换为Java对象（POJO），便于面向对象操作。
首先定义Java类：
public class User {
private String name;
private int age;
private boolean isStudent;
// 必须提供无参构造器
public User() {}
// getter和setter方法
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public boolean isStudent() {
return isStudent;
}
public void setStudent(boolean student) {
isStudent = student;
}
@Override
public String toString() {
return "User{name='" + name + "', age=" + age + ", isStudent=" + isStudent + "}";
}
}
然后使用Jackson转换：
import com.fasterxml.jackson.databind.ObjectMapper;
public class JacksonPojoExample {
public static void main(String[] args) throws Exception {
String jsonString = "{\"name\":\"周九\", \"age\":40, \"isStudent\":false}";
ObjectMapper objectMapper = new ObjectMapper();
// 将JSON字符串转换为User对象
User user = objectMapper.readValue(jsonString, User.class);
// 通过对象获取数据
System.out.println("用户信息: " + user);
System.out.println("姓名: " + user.getName());
System.out.println("年龄: " + user.getAge());
}
}
还没有评论，来说两句吧...