第 32 章 基本数据绑定概念
摘要
有一些常规主题适用于 Apache CXF 处理类型映射的方式。
32.1. 包含和导入架构定义
概述
Apache CXF 支持使用 include 和 import schema 标签包含和导入模式定义。通过这些标签，您可以将来自外部文件或资源的定义插入到 schema 元素的范围中。包括和导入之间的基本区别是：
- 包含在属于所属模式元素相同的目标命名空间的定义中。
- 导入（导入）包括属于所属 schema 元素的不同目标命名空间的定义。
xsd:include syntax
include 指令具有以下语法：
<include schemaLocation="anyURI" />引用的 schema （由 anyURI 指定）必须与所属模式属于同一目标命名空间，或者不属于任何目标命名空间。如果引用的 schema 不属于任何目标命名空间，它将在包含的 schema 命名空间中自动采用。
例 32.1 “包含另一个 Schema 的 Schema 示例” 显示包含另一个 XML Schema 文档的 XML Schema 文档示例。
例 32.1. 包含另一个 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 示例” 显示已包含的 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 syntax
import 指令具有以下语法：
<import namespace="namespaceAnyURI" schemaLocation="schemaAnyURI" />
导入的定义必须属于 namespaceAnyURI 目标命名空间。如果 namespaceAnyURI 为空或保持未指定，则导入的 schema 定义不是完全限定的。
例 32.3 “Imports Another Schema 的 Schema 示例” 显示导入另一个 XML Schema 的 XML Schema 的示例。
例 32.3. Imports 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 “Imported Schema 示例” 显示导入的 schema 文件的内容。
例 32.4. Imported Schema 示例
<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 文档没有定义任何服务。您可以忽略这个警告。- 将生成的类添加到您的类路径。
