淺析Java中如何處理接口返回的JSON數(shù)據(jù)
更新時(shí)間：2026年04月02日 09:02:48 作者：lifewange
在?Java?里處理接口返回的?JSON,最常用的是?Jackson?或?Gson?這兩個(gè)庫,下面小編將用最簡(jiǎn)單,最實(shí)用的方式教你,快跟隨小編一起學(xué)習(xí)一下吧
在 Java 里處理接口返回的 JSON，最常用的是 Jackson 或 Gson 這兩個(gè)庫。下面我用最簡(jiǎn)單、最實(shí)用的方式教你：拿到接口返回的 JSON 字符串 → 轉(zhuǎn)成 Java 對(duì)象 / Map → 直接取值。
一、先引入依賴（二選一）
1. 使用 Jackson（Spring 默認(rèn)，最常用）
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>二、假設(shè)接口返回 JSON 如下
{
"code": 200,
"msg": "請(qǐng)求成功",
"data": {
"id": 1001,
"username": "zhangsan",
"age": 25
}
}三、方式 1：JSON → Java 對(duì)象（最規(guī)范）
1. 先建實(shí)體類
import lombok.Data;
// 整體返回結(jié)構(gòu)
@Data
public class ApiResult {
private Integer code;
private String msg;
private User data;
}
// data 里的用戶對(duì)象
@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\":\"請(qǐng)求成功\",\"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()); // 請(qǐng)求成功
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\":\"請(qǐng)求成功\",\"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（快速取值，不用建類）
適合不想寫實(shí)體類、臨時(shí)解析的場(chǎng)景。
Jackson 轉(zhuǎn) 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 轉(zhuǎn) Map
Gson gson = new Gson();
Map<String, Object> map = gson.fromJson(json, Map.class);
double code = (double) map.get("code"); // Gson 數(shù)字默認(rèn) double
String username = (String) ((Map) map.get("data")).get("username");
五、結(jié)合你剛才的 POST 請(qǐng)求完整示例
把 POST 請(qǐng)求 + 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 數(shù)組：轉(zhuǎn) List<實(shí)體類>
Jackson：List<User> list = mapper.readValue(json, new TypeReference<>(){});
null 值：解析不會(huì)報(bào)錯(cuò)，會(huì)自動(dòng)為 null
到此這篇關(guān)于淺析Java中如何處理接口返回的JSON數(shù)據(jù)的文章就介紹到這了,更多相關(guān)Java處理接口返回的JSON數(shù)據(jù)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
IDEA中使用Docker Compose容器編排的實(shí)現(xiàn)
這篇文章主要介紹了IDEA中使用Docker Compose容器編排的實(shí)現(xiàn)，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-07-07
Eclipse Web項(xiàng)目打成war包的方法圖解
當(dāng)Tomcat啟動(dòng)后該壓縮文件自動(dòng)解壓縮，war包方便了web工程的發(fā)布，那么Eclipse中如何將Web項(xiàng)目打成war包呢？下面小編通過圖文并茂的方式給大家講解下Eclipse Web項(xiàng)目打成war包的方法，一起看看吧2016-08-08
Spring?Boot中@Import三種使用方式實(shí)例詳解
這篇文章主要介紹了Spring?Boot中@Import三種使用方式,主要有引入普通類，引入importSelector的實(shí)現(xiàn)類及引入importBeanDefinitionRegister的實(shí)現(xiàn)類，結(jié)合實(shí)例代碼給大家講解的非常詳細(xì)，需要的朋友可以參考下2022-11-11
java比較兩個(gè)list是否相同equals的代碼詳解
在本篇文章里小編給大家分享的是關(guān)于java比較兩個(gè)list是否相同equals的代碼詳解，有需要的朋友們可以參考學(xué)習(xí)下。2020-02-02
深入講解基于JDK的動(dòng)態(tài)代理機(jī)制
眾所周知相比于靜態(tài)代理，動(dòng)態(tài)代理避免了開發(fā)人員編寫各個(gè)繁鎖的靜態(tài)代理類，下面這篇文章主要給大家介紹了關(guān)于基于JDK的動(dòng)態(tài)代理機(jī)制的相關(guān)資料，文中通過圖文以及示例代碼介紹的非常詳細(xì)，需要的朋友可以參考下2018-07-07
SpringBoot整合緩存方式(Caffeine、Redis)
SpringBoot整合緩存注解包括@EnableCaching、@Cachable、@CachePut和@CacheEvict,分別用于配置緩存管理器和標(biāo)記緩存操作,文章詳細(xì)介紹了整合Caffeine和Redis緩存的步驟,并展示了配置類與控制層代碼,優(yōu)點(diǎn)是快速應(yīng)用緩存,缺點(diǎn)是無法精細(xì)處理緩存2026-05-05
Java?String源碼contains題解重復(fù)疊加字符串匹配
這篇文章主要為大家介紹了Java?String源碼contains題解重復(fù)疊加字符串匹配示例詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2022-11-11
Java實(shí)現(xiàn)航空航班管理系統(tǒng)
這篇文章主要為大家詳細(xì)介紹了Java實(shí)現(xiàn)航空航班管理系統(tǒng)，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2021-07-07
解決Eclipse Tomcat OutOfMemoryError:PermGen space的問題
今天小編就為大家分享一篇關(guān)于解決Eclipse Tomcat OutOfMemoryError:PermGen space的問題，小編覺得內(nèi)容挺不錯(cuò)的，現(xiàn)在分享給大家，具有很好的參考價(jià)值，需要的朋友一起跟隨小編來看看吧2018-12-12
Spring中過濾器(Filter)和攔截器(Interceptor)的區(qū)別和聯(lián)系解析
在我們?nèi)粘５拈_發(fā)中，我們經(jīng)常會(huì)用到Filter和Interceptor，這篇文章主要介紹了Spring中過濾器(Filter)和攔截器(Interceptor)的區(qū)別和聯(lián)系?,需要的朋友可以參考下2022-10-10