本文档旨在指导开发者在使用 Gson 库将 JSON 数据转换为 Java 对象时，如何正确处理 JSON 中可能出现的空列表情况，避免 MalformedJsonException 异常。通过调整 Java 类的结构和使用 Gson 的注解，可以有效地解决空列表带来的解析问题，确保数据转换的顺利进行。
Gson 是一个流行的 Java 库，用于在 Java 对象和 JSON 数据之间进行序列化和反序列化。在使用 Gson.fromJson() 方法时，如果 JSON 结构与 Java 类的定义不完全匹配，可能会遇到各种问题，例如 MalformedJsonException。本文将重点介绍如何处理 JSON 中列表为空的情况。
问题分析
当 JSON 数据中的列表（例如 product 列表中的 value 字段）为空时（[]），Gson 仍然会尝试将该列表映射到 Java 类中对应的 List 属性。如果 Java 类中对列表元素的定义存在问题，例如期望列表中的元素具有某个特定的属性，但实际上列表为空，就会导致解析错误。
立即学习“Java免费学习笔记（深入）”；
解决方案
解决此问题的关键在于确保 Java 类的定义能够正确地反映 JSON 数据的结构，并使用 Gson 的注解来指导解析过程。
1. 定义 Java 类
根据提供的 JSON 示例，我们定义以下 Java 类：
import com.google.gson.annotations.Expose;
import com.google.gson.annotations.SerializedName;
import java.util.List;
public class ProductDTO {
@SerializedName("title")
@Expose
private String title;
@SerializedName("product")
@Expose
private List product = null;
public String getTitle() {
return title;
}
public void setTitle(String title) {
this.title = title;
}
public List getProduct() {
return product;
}
public void setProduct(List product) {
this.product = product;
}
} import com.google.gson.annotations.Expose;
import com.google.gson.annotations.SerializedName;
import java.util.List;
public class Product {
@SerializedName("key")
@Expose
private String key;
@SerializedName("value")
@Expose
private List value = null;
public String getKey() {
return key;
}
public void setKey(String key) {
this.key = key;
}
public List getValue() {
return value;
}
public void setValue(List value) {
this.value = value;
}
} import com.google.gson.annotations.Expose;
import com.google.gson.annotations.SerializedName;
public class Value {
@SerializedName("valueName")
@Expose
private String valueName;
public String getValueName() {
return valueName;
}
public void setValueName(String valueName) {
this.valueName = valueName;
}
}2. 使用 Gson 注解
- @SerializedName: 用于指定 JSON 字段的名称与 Java 类中属性的名称之间的映射关系。例如，@SerializedName("title") 表示将 JSON 中的 "title" 字段映射到 Java 类的 title 属性。
- @Expose: 用于控制哪些属性应该被序列化和反序列化。如果一个属性没有使用 @Expose 注解，那么 Gson 默认会忽略该属性。
3. 解析 JSON 数据
import com.google.gson.Gson;
public class Main {
public static void main(String[] args) {
String jsonPayload = "{\n" +
" \"title\": \"title\",\n" +
" \"product\" : [\n" +
" {\n" +
" \"key\": \"product1\",\n" +
" \"value\": [{\n" +
" \"valueName\": \"productValue1\"\n" +
" }],\n" +
" \"date\" : \"2022-10-11\"\n" +
" },\n" +
" {\n" +
" \"key\": \"product2\",\n" +
" \"value\": []\n" +
" }\n" +
" ]\n" +
"}";
Gson gson = new Gson();
ProductDTO productDTO = gson.fromJson(jsonPayload, ProductDTO.class);
System.out.println("Title: " + productDTO.getTitle());
if (productDTO.getProduct() != null) {
for (Product product : productDTO.getProduct()) {
System.out.println("Key: " + product.getKey());
if (product.getValue() != null) {
for (Value value : product.getValue()) {
System.out.println("ValueName: " + value.getValueName());
}
} else {
System.out.println("Value list is null");
}
}
} else {
System.out.println("Product list is null");
}
}
}注意事项
- 确保 Java 类的属性类型与 JSON 数据的类型匹配。
- 使用 @SerializedName 注解来正确映射 JSON 字段和 Java 属性。
- 使用 @Expose 注解来控制序列化和反序列化的行为。
- 在处理列表时，要考虑列表为空的情况，并进行适当的判断和处理。
总结
通过正确定义 Java 类和使用 Gson 的注解，可以有效地解决在使用 Gson 解析 JSON 数据时遇到的空列表问题。确保 Java 类的结构能够准确地反映 JSON 数据的结构，并使用注解来指导解析过程，可以避免 MalformedJsonException 异常，并确保数据转换的顺利进行。
