2.3. 在合同中添加数据单元
概述
根据您选择创建 WSDL 合同的方式,创建新的数据定义需要不同的知识。Apache CXF GUI 工具为使用 XML Schema 描述数据类型提供了多个帮助。其他 XML 编辑器可提供不同级别的帮助。无论您选择哪种编辑器,都最好了解所生成合同应看的内容。
流程
定义 WSDL 合同中使用的数据涉及以下步骤:
- 确定合同描述的接口中使用的所有数据单元。
-
在您的合同中创建
类型
元素。 创建一个
架构
元素,如 例 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 节 “定义枚举类型”。 -
对于每个元素,使用
元素
来定义它。请参阅 第 2.6 节 “定义元素”。