理解问题：Jackson默认行为的挑战
在使用jackson进行xml序列化时，当一个java类中包含一个泛型列表（例如list
考虑以下Java类定义：
// 抽象基类
public abstract class Animal {}
// 动物子类
public class Dog extends Animal {}
public class Cat extends Animal {}
// 包含动物列表的Zoo类
// @JacksonXmlRootElement(localName = "Zoo") // 在自定义序列化方案中，此注解可能被@JsonSerialize取代
public class Zoo {
// @JacksonXmlProperty // 在自定义序列化方案中，此注解可能被@JsonSerialize取代
// @JacksonXmlElementWrapper(useWrapping = false) // 尝试去除包装器，但对标签名无直接作用
List animals = new ArrayList<>();
} 当我们尝试序列化一个Zoo实例，其中包含Dog和Cat对象：
import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.dataformat.xml.XmlMapper;
public class SerializationDemo {
public static void main(String[] args) throws JsonProcessingException {
Zoo zoo = new Zoo();
zoo.animals.add(new Dog());
zoo.animals.add(new Cat());
zoo.animals.add(new Dog());
// 使用XmlMapper进行序列化
XmlMapper mapper = new XmlMapper();
String xml = mapper.writerWithDefaultPrettyPrinter().writeValueAsString(zoo);
System.out.println(xml);
}
}我们期望得到的XML输出是这样的：
然而，Jackson默认的序列化结果却可能是：
或者带有包装器的形式（取决于@JacksonXmlElementWrapper的配置），但核心问题是，列表中的每个元素都被序列化成了泛型标签（如
解决方案：自定义Jackson XML序列化器
要实现将多态列表元素序列化为各自类型对应的XML标签，最直接且有效的方法是编写一个自定义的Jackson序列化器。通过自定义序列化器，我们可以完全控制Zoo对象及其animals列表的XML输出结构。
1. 定义自定义序列化器
我们需要创建一个继承自com.fasterxml.jackson.databind.ser.std.StdSerializer
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 ZooSerializer extends StdSerializer{ public ZooSerializer() { this(null); } public ZooSerializer(Class t) { super(t); } @Override public void serialize(Zoo zoo, JsonGenerator jg, SerializerProvider sp) throws IOException { // 开始写入Zoo对象的XML标签 // 由于Zoo类本身被@JsonSerialize注解，这里实际上是处理Zoo内部的内容 // jg.writeStartObject(); // 这一行如果Zoo是根元素，Jackson会自行处理其开始标签 for (Animal animal : zoo.animals) { // 为每个Animal子类写入一个XML空标签，标签名为其类名 // 例如，如果是Dog对象，则写入 // 如果是Cat对象，则写入 jg.writeNullField(animal.getClass().getSimpleName()); } // jg.writeEndObject(); // 这一行如果Zoo是根元素，Jackson会自行处理其结束标签 } }
代码解释：
- StdSerializer
：表示这个序列化器是为Zoo类服务的。 - serialize(Zoo zoo, JsonGenerator jg, SerializerProvider sp)：这是核心方法。
- JsonGenerator jg：用于向输出流写入JSON/XML事件。
- zoo.animals：遍历Zoo对象中的动物列表。
- animal.getClass().getSimpleName()：获取当前动物对象的实际类名（如"Dog"或"Cat"）。
- jg.writeNullField(...)：这是关键。在XML模式下，writeNullField("TagName")会生成一个
的空标签。这正是我们所期望的输出格式。
2. 应用自定义序列化器
在Zoo类上使用@JsonSerialize注解，指定使用我们自定义的ZooSerializer。
import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import java.util.ArrayList;
import java.util.List;
// 抽象基类和子类保持不变
public abstract class Animal {}
public class Dog extends Animal {}
public class Cat extends Animal {}
// Zoo类现在使用自定义序列化器
@JsonSerialize(using = ZooSerializer.class)
public class Zoo {
List animals = new ArrayList<>();
} 3. 运行示例
现在，再次运行之前的序列化示例代码：
import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.dataformat.xml.XmlMapper;
public class SerializationDemo {
public static void main(String[] args) throws JsonProcessingException {
Zoo zoo = new Zoo();
zoo.animals.add(new Dog());
zoo.animals.add(new Cat());
zoo.animals.add(new Dog());
XmlMapper mapper = new XmlMapper();
String xml = mapper.writerWithDefaultPrettyPrinter().writeValueAsString(zoo);
System.out.println(xml);
}
}输出结果将是：
这正是我们期望的XML结构，每个多态列表元素都以其具体的类名作为XML标签。
注意事项与权衡
虽然自定义序列化器能够精确控制XML输出，但这种方法并非没有代价。
- 失去Jackson内置的多态支持： Jackson提供了@JsonTypeInfo和@JsonSubTypes等注解，用于在JSON/XML中嵌入类型信息，从而实现自动的多态序列化和反序列化。使用自定义序列化器意味着放弃了这些内置的便利性。
-
需要配套自定义反序列化器： 如果你需要将上述生成的XML反序列化回Java对象，Jackson将无法自动识别
和 标签并创建对应的Dog和Cat实例。你必须编写一个自定义的JsonDeserializer来手动解析这些标签并构建正确的对象图。这会显著增加开发和维护的复杂性。 - 代码侵入性： 自定义序列化器通常需要直接操作JsonGenerator，这使得序列化逻辑与数据结构耦合更紧密，可能降低代码的灵活性。
- 适用场景： 这种方法最适合于对XML输出结构有非常严格且固定要求，且不经常需要反序列化的特定场景。对于更通用的多态序列化需求，强烈建议优先考虑Jackson的@JsonTypeInfo和@JsonSubTypes注解，它们提供了更灵活、更自动化的解决方案。
总结
当Jackson的默认XML序列化行为无法满足多态列表中元素需要以其具体类型作为XML标签的需求时，实现自定义JsonSerializer是一个有效的解决方案。通过手动控制JsonGenerator的输出，可以精确地生成期望的XML结构。然而，采用此方案意味着放弃了Jackson内置的多态序列化便利性，并且在需要反序列化时，必须额外开发对应的自定义反序列化器。因此，在选择此方法之前，务必充分评估其对项目整体复杂性和可维护性的影响。
