使用Jackson序列化嵌套类的问题及类结构说明

看起来你在处理Jackson序列化带嵌套接口的类时遇到了麻烦——我先把你给出的类结构补全（方便后续示例），然后针对常见问题给出解决方案：

先补全完整的类结构（匹配你给出的片段）：

public interface AInf { 
    String getUniqueKey(); 
    // 其他getter方法
} 
public interface BInf { 
    String getUniqueKey(); 
    // 其他getter方法
} 
public interface CInf { 
    String getUniqueKey(); 
    // 其他getter方法
} 

class A implements AInf { 
    private String name; 
    private String uniqueKey; 
    private CInf c; 

    // 构造器、getter、setter
} 

class B implements BInf { 
    private String name; 
    private String uniqueKey; 

    // 构造器、getter、setter
}

class C implements CInf {
    private String uniqueKey;
    private String detail;

    // 构造器、getter、setter
}

1. 核心问题：序列化接口类型字段（比如A类中的CInf c） #

Jackson默认无法直接序列化接口类型，因为它不知道要关联哪个具体实现类。这里有两种常用解决方案：

方法一：添加类型信息注解（通用场景） #

在接口上标记@JsonTypeInfo和@JsonSubTypes，告诉Jackson如何识别实现类，序列化时会自动添加类型标识字段，反序列化时也能正确解析：

import com.fasterxml.jackson.annotation.JsonTypeInfo;
import com.fasterxml.jackson.annotation.JsonSubTypes;

@JsonTypeInfo(
    use = JsonTypeInfo.Id.NAME,
    include = JsonTypeInfo.As.PROPERTY,
    property = "type" // 自动添加到JSON中的类型标识字段
)
@JsonSubTypes({
    @JsonSubTypes.Type(value = C.class, name = "c") // 绑定接口的实现类
})
public interface CInf { 
    String getUniqueKey(); 
}

序列化后的A对象JSON会类似：

{
  "name": "testA",
  "uniqueKey": "A123",
  "c": {
    "type": "c",
    "uniqueKey": "C456",
    "detail": "testDetail"
  }
}

方法二：指定固定实现类（字段始终为某一实现类） #

如果A类中的c字段实际永远是C类的实例，可以直接在字段上用@JsonDeserialize指定实现类，无需添加类型标识：

class A implements AInf { 
    private String name; 
    private String uniqueKey; 
    @JsonDeserialize(as = C.class)
    private CInf c; 

    // getter、setter
}

2. 确保所有需要序列化的字段被识别 #

Jackson默认只序列化有public getter的字段，或者可以通过@JsonProperty强制标记私有字段：

• 给无getter的私有字段添加注解：

class A implements AInf { 
    @JsonProperty // 让Jackson识别这个私有字段，无需写getter
    private String name; 
    private String uniqueKey; 
    private CInf c; 

    // 其他方法
}

• 接口中的getter方法（比如getUniqueKey()）符合JavaBean规范，Jackson会自动映射到对应的uniqueKey字段，只要实现类正确实现了这些方法即可。

3. 处理多层嵌套的复杂结构 #

如果你的类有更深的嵌套（比如C类里还有其他接口类型字段），只需要把上面的方法递归应用：给每个接口添加类型信息注解，或者给嵌套字段指定实现类即可。

4. 自定义序列化逻辑（特殊场景） #

如果通用方案不满足需求，可以自定义序列化器来完全控制输出：

import com.fasterxml.jackson.core.JsonGenerator;
import com.fasterxml.jackson.databind.SerializerProvider;
import com.fasterxml.jackson.databind.ser.std.StdSerializer;

import java.io.IOException;

public class CInfSerializer extends StdSerializer<CInf> {
    protected CInfSerializer() {
        super(CInf.class);
    }

    @Override
    public void serialize(CInf value, JsonGenerator gen, SerializerProvider provider) throws IOException {
        gen.writeStartObject();
        gen.writeStringField("uniqueKey", value.getUniqueKey());
        // 针对不同实现类自定义序列化逻辑
        if (value instanceof C) {
            gen.writeStringField("detail", ((C) value).getDetail());
        }
        gen.writeEndObject();
    }
}

然后在接口或字段上指定这个序列化器：

@JsonSerialize(using = CInfSerializer.class)
public interface CInf { 
    String getUniqueKey(); 
}

内容的提问来源于stack exchange，提问作者SuhasD