java怎么读取返回的json数据

Java中解析返回JSON数据的实用指南**

在当今的软件开发中,JSON（JavaScript Object Notation）已成为数据交换的主流格式之一，无论是调用RESTful API、处理前端传来的数据，还是读取配置文件，我们经常需要在Java应用程序中处理JSON数据，本文将详细介绍几种在Java中读取（解析）返回JSON数据的常用方法，从传统的库到现代的便捷工具，帮助你快速上手。

为什么选择JSON？

在开始之前,简单回顾一下JSON的优势：

• 轻量级：相比XML，JSON更简洁，传输数据量更小。
• 易读易写：格式清晰，人类可读性强。
• 易于解析：大多数编程语言都有成熟的JSON解析库。
• 语言无关：虽然源自JavaScript，但它是独立于语言的。

Java中常用的JSON解析库

Java标准库本身不直接支持JSON的解析,因此我们需要借助第三方库，目前最流行和广泛使用的有：

1. Jackson：功能强大，性能优异，社区活跃，是Spring Framework默认的JSON处理库。
2. Gson：Google开发的库，API简单直观，易于使用。
3. org.json：一个轻量级的JSON库，API相对底层。
4. Fastjson：阿里巴巴开发的库，解析速度快，但前些年有一些安全漏洞，需注意版本选择。

本文将重点介绍Jackson和Gson，因为它们在功能和易用性上表现突出，也是目前项目中的首选。

准备工作：添加依赖

在使用这些库之前,你需要将它们添加到你的项目中。

Maven依赖 (Jackson):

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version> <!-- 使用最新稳定版本 -->
</dependency>

Maven依赖 (Gson):

<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.10.1</version> <!-- 使用最新稳定版本 -->
</dependency>

如果你使用Gradle,相应的依赖如下：

Gradle依赖 (Jackson):

implementation 'com.fasterxml.jackson.core:jackson-databind:2.15.2'

Gradle依赖 (Gson):

implementation 'com.google.code.gson:gson:2.10.1'

使用Jackson解析JSON数据

Jackson提供了ObjectMapper类，它是JSON解析的核心。

将JSON字符串解析为Java对象（POJO）

这是最常见的场景,即JSON数据映射到一个Java实体类（Plain Old Java Object, POJO）。

步骤：

1. 创建一个与JSON结构对应的Java类。
2. 使用ObjectMapper的readValue()方法进行解析。

示例：

假设我们有以下JSON字符串：

{
  "name": "张三",
  "age": 30,
  "email": "zhangsan@example.com",
  "isStudent": false
}

1 创建对应的Java类：

public class User {
    private String name;
    private int age;
    private String email;
    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 String getEmail() { return email; }
    public void setEmail(String email) { this.email = email; }
    public boolean isStudent() { return isStudent; }
    public void setStudent(boolean student) { isStudent = student; }
    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                ", age=" + age +
                ", email='" + email + '\'' +
                ", isStudent=" + isStudent +
                '}';
    }
}

2 使用Jackson解析：

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
public class JacksonJsonExample {
    public static void main(String[] args) {
        String jsonString = "{\"name\":\"张三\",\"age\":30,\"email\":\"zhangsan@example.com\",\"isStudent\":false}";
        ObjectMapper objectMapper = new ObjectMapper();
        try {
            User user = objectMapper.readValue(jsonString, User.class);
            System.out.println(user);
            System.out.println("用户姓名: " + user.getName());
            System.out.println("用户年龄: " + user.getAge());
        } catch (JsonProcessingException e) {
            e.printStackTrace();
        }
    }
}

将JSON字符串解析为JsonNode（树模型）

如果JSON结构复杂多变,或者我们不需要预先定义完整的Java类，可以使用Jackson的树模型（JsonNode）。

示例：

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
public class JacksonJsonNodeExample {
    public static void main(String[] args) {
        String jsonString = "{\"name\":\"张三\",\"age\":30,\"address\":{\"city\":\"北京\",\"street\":\"中关村大街1号\"}}";
        ObjectMapper objectMapper = new ObjectMapper();
        try {
            JsonNode rootNode = objectMapper.readTree(jsonString);
            // 获取普通字段
            String name = rootNode.get("name").asText();
            int age = rootNode.get("age").asInt();
            System.out.println("姓名: " + name);
            System.out.println("年龄: " + age);
            // 获取嵌套对象
            JsonNode addressNode = rootNode.get("address");
            if (addressNode != null && !addressNode.isNull()) {
                String city = addressNode.get("city").asText();
                String street = addressNode.get("street").asText();
                System.out.println("城市: " + city);
                System.out.println("街道: " + street);
            }
        } catch (JsonProcessingException e) {
            e.printStackTrace();
        }
    }
}

解析JSON数组

如果返回的是JSON数组,我们可以将其解析为List<T>。

示例JSON数组：

[
  {"name":"张三","age":30},
  {"name":"李四","age":25}
]

解析为List

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.List;
public class JacksonJsonArrayExample {
    public static void main(String[] args) {
        String jsonArrayString = "[{\"name\":\"张三\",\"age\":30},{\"name\":\"李四\",\"age\":25}]";
        ObjectMapper objectMapper = new ObjectMapper();
        try {
            // 使用TypeReference来指定泛型类型
            List<User> userList = objectMapper.readValue(jsonArrayString, new TypeReference<List<User>>() {});
            userList.forEach(System.out::println);
        } catch (JsonProcessingException e) {
            e.printStackTrace();
        }
    }
}

import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
public class GsonJsonExample {
    public static void main(String[] args) {
        String jsonString = "{\"name\":\"张三\",\"age\":30,\"email\":\"zhangsan@example.com\",\"isStudent\":false}";
        Gson gson = new Gson();
        // 解析为User对象
        User user = gson.fromJson(jsonString, User.class);
        System.out.println(user);
        System.out.println("用户姓名: " + user.getName());
    }
}

import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.util.List;
public class GsonJsonArrayExample {
    public static void main(String[] args) {
        String jsonArrayString = "[{\"name\":\"张三\",\"age\":30},{\"name\":\"李四\",\"age\":25}]";
        Gson gson = new Gson();
        // 使用TypeToken来处理泛型列表
        List<User> userList = gson.fromJson(jsonArrayString, new TypeToken<List<User>>() {}.getType());
        userList.forEach(System.out::println);
    }
}

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.List;
import java.util.Map;
public class DynamicJsonExample {
    public static void main(String[] args) {
        String dynamicJson = "{\"name\":\"项目A\",\"version\":1.0,\"tags\":[\"技术\",\"创新\"],\"