WSDL 生成

本主题定义了由 WSDL 生成器创建的对象。

生成的文件

下表显示了缺省文件和定义元素名称。<Message Set> 是提供的消息集名称,而 <Definition Name> 是向导所需的定义名称。

表 1. WSDL 文件命名约定
文件 文件名 文件扩展名 WSDL <definitions> 元素上的名称元素的值
服务文件(多文件格式或单一文件格式) <Message Set>Service wsdl <Definition Name>Service
绑定文件 <Message Set>Binding wsdl <Definition Name>Binding
接口文件 <Message Set>Interface wsdl <Definition Name>
模式文件 消息定义文件 xsd 不适用

报告文件

WSDL 生成器将生成操作的结果附加到报告文件,列出发生的所有错误。文件名为:

<Message Set>.wsdlgen.report.txt

WSDL 内容

下表显示了要在生成的 WSDL 中设置的元素/属性。按照由上而下的顺序描述元素,因为这些元素将出现在按照惯例排序的 WSDL 文档中。WSDL 定义的 <schema> 节不会显示,因为它直接与代理消息定义对应。

元素名称来自 WSDL 1.1 名称空间,除了以 soap 作为前缀的名称来自 WSDL SOAP 名称空间。操作元素出现在绑定和 portType 两部分中,因此某些操作在必要时是限定的,- 如 portType / 操作。

以下值整体应用于 WSDL 定义:

表 2. WSDL 对象
元素 Attribute
定义 xmlns 指定名称空间前缀。
定义 targetNamespace <Company Domain Name>/<Message Set>/definitions,其中 <Company Domain Name> 是向导需要的,<Message Set> 是消息集的名称。
message name <operation>-<role>,其中 <operation> 是关联的类别名称,<role> 是输入、输出或故障。
部分 name 代理消息 M 的名称。如果样式设置为rpc,则使用类型属性定义主体部分。如果未设置,则使用元素属性定义主体部分。
portType name <Message Set>
绑定 name
  • “<Message Set>SOAP_HTTP_ Binding”
  • “<Message Set>SOAP_JMS_ Binding”
soap:binding style 来自新建 WSDL 定义向导中设置的 Style 值。

以下值应用于每个单独的 WSDL 操作(WSDL 操作表示为消息类别):

表 3. WSDL <operation> 对象
元素 Attribute
操作 name 消息类别的名称
soap:operation style 来自新建 WSDL 定义向导中设置的 Style 值。
输入、输出 name 未生成此可选属性。
故障 name 操作故障部分
soap:body namespace
  • 如果已将样式设置为 rpc,则值就是相应代理消息的命名空间。
  • 如果已将样式设置为文档,则不会生成属性。
soap:header、soap:fault、soap:body use 设置为字面值
portType / 操作 parameterOrder
  • 如果将样式设置为文档,则不会生成属性。
  • 如果未将样式设置为 rpc,输入部分为 I1..IN 而输出部分为 O1..ON。这是空格分隔的部分列表,省略了所有显式标识的回路部分(或 O1,如果未指定任何回路部分)。例如:
    I1 I2 I3 O2 O3 O4

消息集

从消息集生成 WSDL 的主要结果是供外部工具箱(如 .NET)使用的 WSDL 定义。不过,代理通常也需要解析该 WSDL 描述的运行时 SOAP 消息。缺省情况下,WSDL 生成器将保留消息集 SOAP,以供 MRM XML 解析器使用。本部分描述了这样做的意义。

如果将指定的 WSDL 样式设置为 rpc:

验证注释

注释生成的 WSDL,以表明它是否与基本概要文件兼容。WSDL 生成器将对 wsdl:port 元素或要求一致性的最高级别的元素发出以下要求:

<wsdl:definitions etc.
  xmlns:wsi="http://ws-i.org/schemas/conformanceClaim/"\>

  <wsdl:port name="etc" binding="etc">
      <wsdl:documentation>
        <wsi:Claim conformsTo="http://ws-i.org/profiles/basic/1.0"/>
      </wsdl:documentation>
相关概念
消息建模
消息模型
相关任务
开发消息模型
使用消息定义文件
使用消息模型对象
从消息集生成 Web Service 定义
相关参考
消息模型引用信息
消息模型对象属性
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
ad15761_