当json数据中存在一个字段，其值本身是一个表示json数组的字符串时，jackson的默认反序列化机制无法直接将其解析为java的`list`对象。本文将深入探讨这一常见问题，并提供一种健壮的解决方案。我们将通过实现自定义的`jsondeserializer`和`contextualdeserializer`，动态获取目标类型信息，从而实现将嵌套的json字符串正确反序列化为指定类型的`list`集合。
问题场景：嵌套JSON字符串的处理
在处理复杂的JSON数据时，我们有时会遇到一种特殊情况：某个字段的值不是标准的JSON数组或对象，而是一个包含JSON数组或对象内容的“字符串”。例如，考虑以下JSON结构：
{
"name": "g1",
"users": "[{\"name\":\"u1\",\"id\":1},{\"name\":\"u2\",\"id\":2}]"
}在这个JSON中，users字段的值是一个字符串，但该字符串内部实际上是一个标准的JSON数组，包含了两个用户对象。如果我们尝试将其反序列化为如下Java对象：
static class User {
private String name;
private Long id;
// Getters and Setters
public String getName() { return name; }
public void setName(String name) { this.name = name; }
public Long getId() { return id; }
public void setId(Long id) { this.id = id; }
}
static class Group {
private String name;
private List<User> users;
// Getters and Setters
public String getName() { return name; }
public void setName(String name) { this.name = name; }
public List<User> getUsers() { return users; }
public void setUsers(List<User> users) { this.users = users; }
}并使用Jackson的ObjectMapper进行默认反序列化：
ObjectMapper objectMapper = new ObjectMapper();
String jsonString = "{\"name\":\"g1\",\"users\":\"[{\"name\":\"u1\",\"id\":1},{\"name\":\"u2\",\"id\":2}]\"}";
Group group = objectMapper.readValue(jsonString, Group.class);此时，Jackson会尝试将users字段的整个字符串值作为单个字符串处理，而不是将其解析为List
解决方案：自定义JsonDeserializer
为了正确处理这种嵌套的JSON字符串，我们需要编写一个自定义的Jackson反序列化器。这个反序列化器需要能够识别users字段是一个字符串，然后将这个字符串的内容作为独立的JSON数据再次解析。
JsonDeserializer与ContextualDeserializer
Jackson提供了JsonDeserializer>是不够的，因为在反序列化器初始化时，我们可能无法知道List内部的具体类型（例如，User）。
这时，ContextualDeserializer接口就派上了用场。通过实现ContextualDeserializer，我们的反序列化器可以在运行时获取到其被应用到的属性（BeanProperty）的上下文信息，包括其完整的泛型类型。这使得我们能够动态地确定需要解析的内部类型。
实现RawJsonDeserializer
以下是一个通用的RawJsonDeserializer实现，它能够处理将字符串形式的JSON内容反序列化为任何指定类型的对象，包括泛型列表：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.BeanProperty;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.JavaType;
import com.fasterxml.jackson.databind.JsonDeserializer;
import com.fasterxml.jackson.databind.JsonMappingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.deser.ContextualDeserializer;
import com.fasterxml.jackson.databind.type.SimpleType;
import java.io.IOException;
import java.util.List;
public class RawJsonDeserializer<T> extends JsonDeserializer<T> implements ContextualDeserializer {
private final JavaType type; // 存储目标类型
// 默认构造器，用于Jackson初始化
public RawJsonDeserializer() {
// 初始类型设置为Object.class，会在createContextual中被更新
this.type = SimpleType.constructUnsafe(Object.class);
}
// 带类型参数的构造器，由createContextual调用
public RawJsonDeserializer(JavaType type) {
this.type = type;
}
/**
* createContextual方法是ContextualDeserializer的核心。
* 它在反序列化器被应用到特定属性时调用，允许我们根据属性的上下文信息创建
* 一个新的、具有特定类型参数的反序列化器实例。
*/
@Override
public JsonDeserializer<?> createContextual(DeserializationContext ctxt, BeanProperty property) throws JsonMappingException {
// property.getType() 获取当前属性的完整类型信息，例如 List<User>
// 我们创建一个新的RawJsonDeserializer实例，并将此类型传递给它
return new RawJsonDeserializer<>(property.getType());
}
/**
* deserialize方法执行实际的反序列化逻辑。
* 它接收当前JSON字段的JsonParser和DeserializationContext。
*/
@Override
public T deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
// p.getText() 获取当前JSON字段的原始字符串值
// p.getCodec() 获取当前使用的ObjectMapper实例
// 然后，我们使用这个ObjectMapper将获取到的字符串再次解析为之前在createContextual中确定的目标类型 (this.type)
return ((ObjectMapper) p.getCodec()).readValue(p.getText(), type);
}
}代码解析：
- RawJsonDeserializer() 构造器： 这是一个无参构造器，Jackson在初步加载反序列化器时会调用它。此时我们不知道具体的泛型类型，所以暂时将type设置为Object.class。
- RawJsonDeserializer(JavaType type) 构造器： 这是一个带JavaType参数的构造器，用于在createContextual方法中创建新的反序列化器实例，并传入具体的类型信息。
-
createContextual(DeserializationContext ctxt, BeanProperty property)：
- 这个方法是ContextualDeserializer接口的核心。当Jackson发现某个属性需要使用此自定义反序列化器时，它会调用此方法。
- property.getType()：这是关键所在！它返回当前被反序列化的Java属性的完整类型信息，例如，对于List
users;，它将返回一个代表List 的JavaType对象。 - 我们利用这个JavaType创建一个新的RawJsonDeserializer实例，并将其返回。Jackson会使用这个新的实例来处理当前属性的反序列化。
-
deserialize(JsonParser p, DeserializationContext ctxt)：
- 这是实际执行反序列化逻辑的方法。
- p.getText()：获取当前JSON token（在这里是users字段的字符串值）的文本内容，即"[{\"name\":\"u1\",\"id\":1},{\"name\":\"u2\",\"id\":2}]"。
- ((ObjectMapper) p.getCodec())：从当前的JsonParser中获取正在使用的ObjectMapper实例。
- readValue(p.getText(), type)：使用获取到的ObjectMapper，将p.getText()（即那个嵌套的JSON字符串）再次解析，这次是解析成在createContextual中确定的type（例如List
）。这样，Jackson就能正确地将内部字符串解析为List 对象。
应用自定义反序列化器
将上述自定义反序列化器应用到我们的Group类中的users字段上，需要使用@JsonDeserialize注解：
import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import java.util.List;
static class User {
private String name;
private Long id;
public String getName() { return name; }
public void setName(String name) { this.name = name; }
public Long getId() { return id; }
public void setId(Long id) { this.id = id; }
@Override
public String toString() {
return "User{name='" + name + "', id=" + id + '}';
}
}
static class Group {
private String name;
// 使用@JsonDeserialize注解指定自定义反序列化器
@JsonDeserialize(using = RawJsonDeserializer.class)
private List<User> users;
public String getName() { return name; }
public void setName(String name) { this.name = name; }
public List<User> getUsers() { return users; }
public void setUsers(List<User> users) { this.users = users; }
@Override
public String toString() {
return "Group{name='" + name + "', users=" + users + '}';
}
}现在，当Jackson反序列化Group对象时，遇到users字段，它会调用RawJsonDeserializer来处理。RawJsonDeserializer会先获取users字段的字符串值，然后将其重新解析为List
完整示例代码：
import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.BeanProperty;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.JavaType;
import com.fasterxml.jackson.databind.JsonDeserializer;
import com.fasterxml.jackson.databind.JsonMappingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import com.fasterxml.jackson.databind.deser.ContextualDeserializer;
import com.fasterxml.jackson.databind.type.SimpleType;
import java.io.IOException;
import java.util.List;
public class JacksonNestedJsonStringToList {
// ... (RawJsonDeserializer, User, Group classes as defined above) ...
public static void main(String[] args) throws IOException {
ObjectMapper objectMapper = new ObjectMapper();
String jsonString = "{\"name\":\"g1\",\"users\":\"[{\"name\":\"u1\",\"id\":1},{\"name\":\"u2\",\"id\":2}]\"}";
Group group = objectMapper.readValue(jsonString, Group.class);
System.out.println("Deserialized Group: " + group);
if (group != null && group.getUsers() != null) {
System.out.println("Users list size: " + group.getUsers().size());
group.getUsers().forEach(user -> System.out.println(" " + user));
}
}
}运行上述代码，将得到以下输出：
Deserialized Group: Group{name='g1', users=[User{name='u1', id=1}, User{name='u2', id=2}]}
Users list size: 2
User{name='u1', id=1}
User{name='u2', id=2}这表明嵌套的JSON字符串已成功反序列化为List
注意事项与最佳实践
- 性能开销： 这种方法涉及两次JSON解析：第一次是Jackson解析外部JSON结构时将users字段作为字符串读取，第二次是自定义反序列化器将这个字符串再次解析为内部的List。这会带来一定的性能开销。如果性能是关键考量，并且你有能力修改原始JSON结构，最好将users字段直接修改为JSON数组而不是字符串。
- 适用场景： 此方法特别适用于你无法控制JSON源数据格式，但又必须处理这种“JSON字符串中嵌套JSON”的情况。例如，某些遗留系统或第三方API可能返回此类数据。
- 错误处理： deserialize方法内部的readValue可能会抛出IOException。在实际应用中，你可能需要添加更健壮的错误处理逻辑，例如捕获异常并转换为JsonMappingException，或者返回一个默认值。
- 通用性： RawJsonDeserializer设计得非常通用，它可以用于反序列化任何以字符串形式存在的JSON内容到任何Java类型，不仅仅是List。
总结
通过实现Jackson的JsonDeserializer和ContextualDeserializer接口，我们成功地解决了将嵌套在字符串中的JSON数组反序列化为Java List对象的问题。ContextualDeserializer的强大之处在于其能够在运行时动态获取属性的类型信息，从而使得自定义反序列化器能够适应各种泛型类型。虽然这种方法会引入双重解析的性能开销，但它为处理不规范的JSON数据提供了一个灵活且强大的解决方案。
