如何用 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 类型映射。
备注:内容仅供参考。
