34.6. 简单类型替换
概述
XML 允许使用 xsi:type
属性在兼容类型之间进行简单类型替换。但是,简单类型的默认映射到 Java 原语类型,但不完全支持简单类型替换。运行时可以处理基本的简单类型替换,但信息会丢失。可以自定义代码生成器来生成可方便简单类型替换的 Java 类。
默认映射和编组
因为 Java 原语类型不支持类型替换,因此默认简单类型映射到 Java 原语类型提供了支持简单类型替换的问题。如果尝试将一个变量传递给一个变量,则 Java 虚拟机 会提示
,即使定义类型允许的 schema 也会导致一个 int
。
要解决 Java 类型系统的限制,Apache CXF 允许在元素的 xsi:type
属性的值满足以下任一条件时进行简单类型替换:
- 它指定与元素的 schema 类型兼容的原语类型。
- 它指定从元素的 schema 类型限制限制的类型。
- 它指定从元素的 schema 类型中由扩展生成的复杂类型。
当运行时进行类型替换时,它不会保留元素的 xsi:type
属性中指定的类型的任何知识。如果类型替换从复杂的类型到简单类型,则只保留与简单类型直接相关的值。由 扩展添加的任何其他元素和属性都将丢失。
支持丢失类型替换
您可以自定义生成简单类型,以方便以下列方式支持简单类型替换:
将
globalBindings
自定义元素的mapSimpleTypeDef
设置为true
。这指示代码生成器,为全局范围中定义的所有命名简单类型创建 Java 值类。
更多信息请参阅 第 38.3 节 “为简单类型生成 Java 类”。
在
globalBindings
自定义元素中添加javaType
元素。这指示代码生成器将 XML 架构 primitive 类型的所有实例映射到特定的对象类。
在您要自定义的特定元素中添加
baseType
自定义元素。baseType
custom 元素允许您指定为表示属性生成的 Java 类型。为确保简单类型替换的最佳兼容性,请使用java.lang.Object
作为基础类型。更多信息请参阅 第 38.6 节 “指定 Element 或属性的基本类型”。