PAYATHON 2026

如何用 JAXB 将 Double 编组为带 xsi:type 的 Value 元素

技术老齐

结论

保留 XJC 生成的 Object 属性和 @XmlElement(name = "Value"),直接把 Double 赋给该属性即可。无需改成 @XmlAnyElement(lax = true),也无需编写 XmlAdapter:

Parent parent = new Parent();
parent.setValue(12.34d);

属性声明为 xs:anyType,对应的 Java 类型为 Object。编组时,JAXB 会根据实际对象的运行时类型写出 xsi:type,结果通常如下:

<Value
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xs="http://www.w3.org/2001/XMLSchema"
    xsi:type="xs:double">12.34</Value>

其中的前缀可能是 xs、xsd 或 ns3,不会改变 XML 的含义。类型由命名空间 URI 和本地名称 double 共同确定,前缀文本本身没有特殊含义。

原始 Schema 如何表达这种数据

下面的元素没有显式指定 type:

<s:element minOccurs="0" maxOccurs="1" name="Value"/>

在 XML Schema 中,这类元素默认使用 xs:anyType。XJC 通常会生成以下代码:

@XmlElement(name = "Value")
protected Object value;

public Object getValue() {
    return value;
}

public void setValue(Object value) {
    this.value = value;
}

这里将属性声明为 Object 是正确的。JAXB 编组时发现实际值为 Double,就会用 xsi:type 将运行时类型写入 XML。

完整用法可以写成:

Parent parent = new Parent();
parent.setValue(Double.valueOf(12.34));

return parent;

如果对象由 Spring Web Services 的 @Endpoint 返回,配置正常的 Jaxb2Marshaller 会继续完成 SOAP Body 的编组,无需单独构造 Value 节点。

撤销 @XmlAnyElement 补丁

@XmlAnyElement 用于处理 Schema 中的通配元素,例如:

<xs:any processContents="lax"/>

这表示属性保存的是一个名称未知的完整 XML 元素。常见的 Java 表示形式包括:

  • org.w3c.dom.Element
  • 带元素声明的 JAXBElement<?>
  • JAXB 已知且具有根元素映射的对象

当前场景中的元素名称 Value 已经确定,只有内容类型是动态的,所以不属于通配元素。改用 @XmlAnyElement 后,JAXB 会把属性值当作完整元素处理,而非 Value 元素的内容。这会导致 DOM 节点带上独立的命名空间声明,XML 结构也会随之改变。

应删除构建阶段的补丁,让生成代码恢复为:

@XmlElement(name = "Value")
protected Object value;

外部 javaType 绑定为什么不适用

jaxb:javaType 主要用于 XML Schema 简单类型与 Java 类型之间的词法转换,例如将某个自定义 xs:simpleType 转换为指定的 Java 类。

当前元素的有效类型是 xs:anyType,无法通过 parseMethod 和 printMethod 固定转换。将 javaType 或 XmlAdapter<Object, Object> 附加到该元素,既不符合这种定制方式通常适用的 Schema 组件,也无法根据运行时对象选择相应的 XML 类型。

如果强制将值转换为字符串,JAXB 生成 xsi:type 所需的运行时类型信息也会丢失。

JAXBElement<Double> 为什么没有生成 xsi:type

JAXBElement 保存元素的 QName、声明类型和元素值。例如:

JAXBElement<Double> element = new JAXBElement<>(
    new QName(NAMESPACE, "Value"),
    Double.class,
    inputDouble
);

这段代码中的声明类型是 Double.class,运行时值也是 Double。两者类型一致,JAXB 没有必要额外写出 xsi:type。

下面的代码还存在类型错误:

JAXBElement<Double> element = ...;
element.setValue(inputDouble.toString());

JAXBElement<Double> 只能接收 Double 值,不能设置为 String。如果通过原始类型或强制转换绕过编译检查,还可能导致声明类型与实际值不一致。

setSupportJaxbElementClass(true) 只决定 Spring Jaxb2Marshaller 是否将 JAXBElement 视为受支持的根对象,不能强制 JAXB 输出 xsi:type。

无需手动管理命名空间前缀

xsi:type 的值是 QName。只要相应前缀都绑定到 http://www.w3.org/2001/XMLSchema,下面三种写法就是等价的:

xsi:type="xs:double"
xsi:type="xsd:double"
xsi:type="ns3:double"

JAXB 会自行选择前缀,并写出对应的 xmlns 声明。客户端的 XML 解析器应按命名空间 URI 解析 QName,不能只比较前缀字符串。

因此,无需要求输出结果逐字符等于:

<Value xsi:type="xsd:double">12.34</Value>

判断结果是否正确时,应检查以下内容:

  • 元素名称是 Value
  • xsi:type 属性位于 http://www.w3.org/2001/XMLSchema-instance 命名空间
  • 属性值解析后的 QName 是 {http://www.w3.org/2001/XMLSchema}double
  • 文本值是 12.34

如果对方系统错误地依赖固定前缀,可以使用 JAXB RI 专有的 namespace prefix mapper 进行兼容。正常的 JAXB 编组不需要这项配置。

推荐实现

生成类保持原样:

@XmlElement(name = "Value")
protected Object value;

在 Endpoint 中直接设置实际类型:

@Endpoint
public class TestEndpoint {

    @PayloadRoot(namespace = NAMESPACE, localPart = "Request")
    @ResponsePayload
    public Response handle(@RequestPayload Request request) {
        Parent parent = new Parent();
        parent.setValue(12.34d);

        Response response = new Response();
        response.setParent(parent);
        return response;
    }
}

生成的 SOAP 内容可能如下:

<Value
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xs="http://www.w3.org/2001/XMLSchema"
    xsi:type="xs:double">12.34</Value>

客户端处理 xs:anyType 时,可以根据 xsi:type 将值还原为 Double。移除 xsi:type 后,客户端只能确认它是一个任意类型的 Value 元素,因此可能返回 DOM Element。

同样的方式也适用于 JAXB 已知的其他简单类型。处理复杂结构时,需要将对应类加入 JAXBContext,并为其建立明确的 JAXB 类型映射。

备注:内容仅供参考。