这描述了在工作台中如何使用“新建消息定义文件”向导从 WSDL 创建新的消息定义。
开始之前:
要执行此任务,必须先完成下列任务:
在开始该任务之前,应注意以下各点:
- 应确保 Web service 具有最高的互操作性:
- 尽可能使用 WSDL 的文档类型
- 在必须使用 rpc 样式 WSDL 时,使用字面值编码
- 在必须使用 SOAP 编码的 rpc 样式时,确保 WSDL 操作定义已使用有效目标名称空间属性限定
- WSDL 定义可以可选地分割到多个文件。典型的排列为顶级服务定义文件导入绑定文件,绑定文件导入界面文件,这将最终导入或包含模式定义文件。
- 当您从 WSDL 文件创建新消息定义文件时,该 WSDL 文件必须已经存在于您的消息集项目中。如果该 WSDL 被分割为多个文件(如上所述),则您可以导入顶级文件或绑定文件。在这种情况下,使用相对位置导入的文件和其引用的任何文件在 WSDL 导入运行前必须在工作空间中。
- 在导入两个或多个共享公共模式定义的 WSDL 文件时,应该将它们导入不同的消息集项目,以避免任何名称冲突的可能性。
- 您应该添加一个 XML 物理格式层,并对您正在向其添加新消息定义文件的消息集启用名称空间支持。
为了提高 Web service 的互操作性,应避免为参与 Web service 过程的消息定制不必要的 XML 物理格式层。
重要: 请注意,文件的扩展名必须为小写形式的 .wsdl。
以下步骤涵盖创建全新的消息定义文件,以及覆盖现有文件的内容。
要从 WSDL 文件创建消息定义:
- 切换到“代理应用程序开发”透视图。
- 通过从工作台菜单单击文件 > 新建 > 消息定义文件,以打开新建消息定义文件向导。 或者,您可以通过右键单击先前导入到工作台的 .wsdl 文件,并单击菜单上的新建 > 消息定义文件来打开该向导。
- 在选项的显示列表中,单击 WSDL 文件将其选中,然后单击下一步。
- 单步遍历向导的其余部分根据要求填入详细信息。
注: - 许多面板和选项可能取决于在向导中所做的设置,并且可能不会始终显示。
- 向导中的某些字段可能显示为灰色。这可能是由于字段具有强制设置,字段只有一个可能的值,或者是由于已做的其他设置而未使用。
当使用向导完成 WSDL 导入后:
- 导入文件时请仔细检查所创建报告中的任何错误。此报告可在包含您试图创建的消息定义的项目中的 log 目录中找到。此报告具有 <wsdl-file-name>.wsdl.report.txt 文件描述符,其中 <wsdl-file-name> 是您正在导入的 WSDL 定义的名称。
- 查看工作台任务列表中显示的消息以检查是否出现任何新警告或错误。
注: 在导入过程中,任何必需的 SOAP 封包和 SOAP 编码消息定义都自动添加到您的消息集中。如果需要,还可以选择新选项 IBM 提供的消息来通过“新建消息定义文件”向导来手动导入这些内容。