2.3. 在合同中添加数据单元
概述
根据您选择如何创建 WSDL 合同的方式,创建新数据定义需要不同的知识。Apache CXF GUI 工具提供了很多用于描述使用 XML 架构数据类型的辅助工具。其他 XML 编辑器提供不同的帮助级别。无论您选择哪种编辑器,最好了解结果合同应是什么样子。
步骤
定义 WSDL 合同中使用的数据涉及以下步骤:
- 确定合同描述的接口中使用的所有数据单元。
-
在您的合同中创建 type 元素。
创建一个
schema
元素,如 例 2.1 “WSDL 合同的 schema 条目” 所示,作为type
元素的子元素。targetNamespace
属性指定定义新数据类型的命名空间。最佳实践是定义提供目标命名空间访问权限的命名空间。不应更改剩余的条目。例 2.1. WSDL 合同的 schema 条目
<schema targetNamespace="http://schemas.iona.com/bank.idl" xmlns="http://www.w3.org/2001/XMLSchema" xmlns:xsd1="http://schemas.iona.com/bank.idl" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
-
对于作为元素集合的每个复杂类型,请使用
complexType
元素定义数据类型。请参阅 第 2.5.1 节 “定义数据结构”。 -
对于每个数组,使用
complexType
元素定义数据类型。请参阅 第 2.5.2 节 “定义数组”。 -
对于从简单类型派生的每个复杂类型,请使用
simpleType
元素定义数据类型。请参阅 第 2.5.4 节 “根据限制定义类型”。 -
对于每个枚举的类型,使用
simpleType
元素定义数据类型。请参阅 第 2.5.5 节 “定义枚举类型”。 -
对于每个元素,使用 element
元素
定义它。请参阅 第 2.6 节 “定义元素”。