首页 > 软件编程 > java > Java处理接口返回的JSON数据

浅析Java中如何处理接口返回的JSON数据

2026-04-02 08:58:08 作者：lifewange

在 Java 里处理接口返回的 JSON,最常用的是 Jackson 或 Gson 这两个库,下面小编将用最简单,最实用的方式教你,快跟随小编一起学习一下吧

在 Java 里处理接口返回的 JSON，最常用的是 Jackson 或 Gson 这两个库。下面我用最简单、最实用的方式教你：拿到接口返回的 JSON 字符串 → 转成 Java 对象 / Map → 直接取值。

一、先引入依赖（二选一）

1. 使用 Jackson（Spring 默认，最常用）

Maven：

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

2. 使用 Gson（谷歌出品，轻量）

Maven：

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

二、假设接口返回 JSON 如下

{
  "code": 200,
  "msg": "请求成功",
  "data": {
    "id": 1001,
    "username": "zhangsan",
    "age": 25
  }
}

三、方式 1：JSON → Java 对象（最规范）

1. 先建实体类

import lombok.Data;
// 整体返回结构
@Data
public class ApiResult {
    private Integer code;
    private String msg;
    private User data;
}
// data 里的用户对象
@Data
public class User {
    private Integer id;
    private String username;
    private Integer age;
}

不用 Lombok 就手写 getter/setter。

2. Jackson 解析

import com.fasterxml.jackson.databind.ObjectMapper;

public class JsonTest {
    public static void main(String[] args) throws Exception {
        // 接口返回的 JSON 字符串
        String json = "{\"code\":200,\"msg\":\"请求成功\",\"data\":{\"id\":1001,\"username\":\"zhangsan\",\"age\":25}}";

        ObjectMapper mapper = new ObjectMapper();
        ApiResult result = mapper.readValue(json, ApiResult.class);

        // 直接取值
        System.out.println(result.getCode());    // 200
        System.out.println(result.getMsg());     // 请求成功
        System.out.println(result.getData().getUsername()); // zhangsan
    }
}

3. Gson 解析

import com.google.gson.Gson;

public class JsonTest {
    public static void main(String[] args) {
        String json = "{\"code\":200,\"msg\":\"请求成功\",\"data\":{\"id\":1001,\"username\":\"zhangsan\",\"age\":25}}";

        Gson gson = new Gson();
        ApiResult result = gson.fromJson(json, ApiResult.class);

        System.out.println(result.getCode());
        System.out.println(result.getData().getUsername());
    }
}

四、方式 2：JSON → Map（快速取值，不用建类）

适合不想写实体类、临时解析的场景。

Jackson 转 Map

ObjectMapper mapper = new ObjectMapper();
Map<String, Object> map = mapper.readValue(json, Map.class);

int code = (int) map.get("code");
String msg = (String) map.get("msg");

Map<String, Object> data = (Map) map.get("data");
String username = (String) data.get("username");

Gson 转 Map

Gson gson = new Gson();
Map<String, Object> map = gson.fromJson(json, Map.class);

double code = (double) map.get("code"); // Gson 数字默认 double
String username = (String) ((Map) map.get("data")).get("username");

五、结合你刚才的 POST 请求完整示例

把 POST 请求 + JSON 解析放一起：

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import com.fasterxml.jackson.databind.ObjectMapper;

public class PostWithJsonParse {
    public static void main(String[] args) throws Exception {
        String url = "https://httpbin.org/post";
        String jsonParams = "{\"username\":\"test\",\"password\":\"123456\"}";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .POST(HttpRequest.BodyPublishers.ofString(jsonParams))
                .header("Content-Type", "application/json")
                .build();

        // 获取返回 JSON
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        String json = response.body();

        // 解析 JSON
        ObjectMapper mapper = new ObjectMapper();
        Map<String, Object> resultMap = mapper.readValue(json, Map.class);

        System.out.println("url: " + resultMap.get("url"));
        System.out.println("data: " + resultMap.get("data"));
    }
}

六、常见小问题

字段名不一致：用 @JsonProperty("user_name")

JSON 数组：转 List<实体类>

Jackson：List<User> list = mapper.readValue(json, new TypeReference<>(){});

null 值：解析不会报错，会自动为 null

到此这篇关于浅析Java中如何处理接口返回的JSON数据的文章就介绍到这了,更多相关Java处理接口返回的JSON数据内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！