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