第 32 章 基本数据绑定概念
摘要
有多个常规主题适用于 Apache CXF 如何处理类型映射。
32.1. 包含和导入架构定义
概述
Apache CXF 支持使用 include 和 import schema 标签，包含和导入 schema 定义。通过这些标签，您可以将外部文件或资源的定义插入到 schema 元素的范围。包括和导入的重要区别是：
- 包括在属于包含架构元素的同一目标命名空间中的定义中。
- 导入会进入属于包含架构元素的不同目标命名空间的定义中。
XSD:include 语法
include 指令使用以下语法：
<include schemaLocation="anyURI" />任何URI 提供的引用的 schema 必须属于所属架构相同的目标命名空间，或者完全属于任何目标命名空间。如果引用的 schema 不属于任何目标命名空间，则在包含它时会自动将其添加到包含的 schema 命名空间中。
例 32.1 “包含 Another Schema 的 Schema 示例” 显示包含另一个 XML 架构文档的 XML 架构文档示例。
例 32.1. 包含 Another Schema 的 Schema 示例
<definitions targetNamespace="http://schemas.redhat.com/tests/schema_parser"
xmlns:tns="http://schemas.redhat.com/tests/schema_parser"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://schemas.xmlsoap.org/wsdl/">
<types>
<schema targetNamespace="http://schemas.redhat.com/tests/schema_parser"
xmlns="http://www.w3.org/2001/XMLSchema">
<include schemaLocation="included.xsd"/>
<complexType name="IncludingSequence">
<sequence>
<element name="includedSeq" type="tns:IncludedSequence"/>
</sequence>
</complexType>
</schema>
</types>
...
</definitions>例 32.2 “包含的 Schema 示例” 显示所含架构文件的内容。
例 32.2. 包含的 Schema 示例
<schema targetNamespace="http://schemas.redhat.com/tests/schema_parser"
xmlns="http://www.w3.org/2001/XMLSchema">
<!-- Included type definitions -->
<complexType name="IncludedSequence">
<sequence>
<element name="varInt" type="int"/>
<element name="varString" type="string"/>
</sequence>
</complexType>
</schema>XSD:import 语法
import 指令使用以下语法：
<import namespace="namespaceAnyURI" schemaLocation="schemaAnyURI" />
导入的定义必须属于 namespaceAnyURI 目标命名空间。如果 namespaceAnyURI 为空或未指定，则导入的模式定义是不限定的。
例 32.3 “导入 Another Schema 的 Schema 示例” 演示了导入另一个 XML 架构的 XML 架构示例。
例 32.3. 导入 Another Schema 的 Schema 示例
<definitions targetNamespace="http://schemas.redhat.com/tests/schema_parser"
xmlns:tns="http://schemas.redhat.com/tests/schema_parser"
xmlns:imp="http://schemas.redhat.com/tests/imported_types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://schemas.xmlsoap.org/wsdl/">
<types>
<schema targetNamespace="http://schemas.redhat.com/tests/schema_parser"
xmlns="http://www.w3.org/2001/XMLSchema">
<import namespace="http://schemas.redhat.com/tests/imported_types"
schemaLocation="included.xsd"/>
<complexType name="IncludingSequence">
<sequence>
<element name="includedSeq" type="imp:IncludedSequence"/>
</sequence>
</complexType>
</schema>
</types>
...
</definitions>例 32.4 “导入架构示例” 显示导入的 schema 文件的内容。
例 32.4. 导入架构示例
<schema targetNamespace="http://schemas.redhat.com/tests/imported_types"
xmlns="http://www.w3.org/2001/XMLSchema">
<!-- Included type definitions -->
<complexType name="IncludedSequence">
<sequence>
<element name="varInt" type="int"/>
<element name="varString" type="string"/>
</sequence>
</complexType>
</schema>使用非引用模式文档
使用在服务的 WSDL 文档中没有引用的 schema 文件中定义的类型是三个步骤：
-
使用
xsd2wsdl工具将架构文档转换为 WSDL 文档。 使用生成的 WSDL 文档上的
wsdl2java工具为类型生成 Java。重要您将收到
wsdl2java工具的警告，表示 WSDL 文档没有定义任何服务。您可以忽略这个警告。- 将生成的类添加到类路径中。
