如何让JAXB生成的XML显示空元素（String、Long、Integer类型）

针对你的需求，以下是几种可行的解决方案，覆盖JAXB原生配置、自定义适配器以及替代框架三种思路：

一、JAXB原生方案：使用nillable属性 #

JAXB提供@XmlElement(nillable = true)注解，标记字段即使为null也需生成XML元素，生成的元素会带有xsi:nil="true"属性，符合XML Schema规范。

修改模型类 #

给每个需要保留的字段的@XmlElement添加nillable = true：

@XmlElement(name = "model:field2", nillable = true)
public void setField2(String field2) {
   this.field2 = field2;
}

输出效果 #

编组后null字段会生成：

<model:field2 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>

如果你的场景严格要求不带xsi:nil的空元素（如<model:field2></model:field2>），可采用下面的适配器方案。

二、JAXB自定义适配器：将null转为空值 #

通过XmlAdapter实现类型转换，把null值映射为空字符串，从而生成空元素，适合统一处理大量字段的场景。

1. 编写通用适配器 #

针对不同类型编写适配器：

• String类型适配器：

import javax.xml.bind.annotation.adapters.XmlAdapter;

public class NullToEmptyStringAdapter extends XmlAdapter<String, String> {
    @Override
    public String unmarshal(String v) {
        return v;
    }

    @Override
    public String marshal(String v) {
        return v == null ? "" : v;
    }
}

• Integer类型适配器（生成空元素而非0）：

public class NullIntegerToEmptyAdapter extends XmlAdapter<String, Integer> {
    @Override
    public Integer unmarshal(String v) {
        return v.isEmpty() ? null : Integer.parseInt(v);
    }

    @Override
    public String marshal(Integer v) {
        return v == null ? "" : v.toString();
    }
}

2. 全局配置适配器 #

在包下创建package-info.java文件，批量配置所有对应类型的适配器，无需逐个字段添加注解：

@XmlJavaTypeAdapters({
    @XmlJavaTypeAdapter(type = String.class, value = NullToEmptyStringAdapter.class),
    @XmlJavaTypeAdapter(type = Integer.class, value = NullIntegerToEmptyAdapter.class),
    @XmlJavaTypeAdapter(type = Long.class, value = NullLongToEmptyAdapter.class)
})
package com.your.package;

import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter;
import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapters;

输出效果 #

所有null字段会生成空元素：

<model:field2></model:field2>

三、替代方案：使用Jackson XML模块 #

如果JAXB的配置过于繁琐，可以改用Jackson的XML数据格式模块，配置更灵活，能轻松实现保留所有字段（包括null）的需求。

1. 引入依赖（Maven） #

<dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-xml</artifactId>
    <version>2.15.2</version>
</dependency>

2. 修改模型类注解 #

替换JAXB注解为Jackson XML注解：

import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty;
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlRootElement;

@JacksonXmlRootElement(localName = "model:MyModel")
public class MyModel {
    private String field1;
    private String field2;
    private String field3;

    public MyModel() {}

    public String getField1() {
        return field1;
    }

    @JacksonXmlProperty(localName = "model:field1")
    public void setField1(String field1) {
        this.field1 = field1;
    }

    // 其他字段同理添加@JacksonXmlProperty注解
}

3. 配置并编组 #

import com.fasterxml.jackson.databind.SerializationFeature;
import com.fasterxml.jackson.dataformat.xml.XmlMapper;

public class MyApplication {
    public static void main(String[] args) throws Exception {
        MyModel myModel = new MyModel();
        myModel.setField1("cat");
        myModel.setField3("dog");

        XmlMapper xmlMapper = new XmlMapper();
        xmlMapper.enable(SerializationFeature.INDENT_OUTPUT);
        // 强制输出所有字段，包括null值
        xmlMapper.setSerializationInclusion(com.fasterxml.jackson.annotation.JsonInclude.Include.ALWAYS);

        xmlMapper.writeValue(System.out, myModel);
    }
}

输出效果 #

直接生成包含空元素的XML：

<model:MyModel>
  <model:field1>cat</model:field1>
  <model:field2/>
  <model:field3>dog</model:field3>
</model:MyModel>

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