使用 IBM SOAP 运行时环境从 WSDL 文档生成 Java 客户机代理和样本应用程序

“Web Service 客户机”向导帮助您生成 Java™ bean 代理和样本应用程序。样本 Web 应用程序演示如何对代理文件进行编码。

先决条件:
  1. 如果您正在使用 WebSphere 服务器,则创建一个以适当服务器为目标的动态 Web 项目,如创建 WebSphere 服务器和 Web 项目中所述。
  2. 发现 WSDL 文档并将它导入 Web 项目中。只能使用包含 service 元素的 WSDL 文件。

要从发现的 WSDL 文档生成 Java 客户机代理和样本应用程序:

  1. 切换至 J2EE 透视图(窗口 > 打开透视图 > J2EE)。
  2. 在“项目资源管理器”视图中,选择要生成样本应用程序的 Web 项目。
  3. 单击文件 > 新建 > 其它。选择 Web Service 以显示各种 Web Service 向导。选择 Web Service 客户机向导。单击下一步
  4. “Web Service”面板:选择要生成的代理的类型并选择是否要测试它。
  5. “客户机环境配置”页面:为 Web Service 客户机选择运行时环境和服务器。
    1. 单击资源管理选项并选择 IBM® SOAP 运行时环境,然后选择想要运行 Web Service 客户机的服务器。 如果想要使用 Apache Axis 1.0 运行时环境或 IBM WebSphere 运行时环境,请参阅相应的任务。
    2. 选择想要创建 Web Service 客户机的项目的类型和名称。
      • 如果输入现有项目的名称,则项目类型字段必须与现有项目的项目类型字段相匹配。确保选择作为“客户机 Web 项目”的项目与“服务 Web 项目”不同,否则,服务将被客户机生成的构件覆盖。
      • 如果输入一个尚不存在的项目的名称,则向导将为您创建该项目。
      • 注意,Axis 和 SOAP 运行时客户机支持的唯一项目类型是 Web 项目。如果想要在 Java、EJB 或应用程序客户机项目中创建客户机,则必须为客户机选择 WebSphere 运行时环境。
    3. 选择现有 EAR 或输入一个唯一名称以使 Web Service 客户机与 Web Service EAR 以外的另一 EAR 相关联。注意:对 Web Service 和 Web Service 客户机选择不同的 EAR 可以减少遇到运行时错误的机会,但是将使用较多系统资源。
  6. “选择 Web Service”面板:输入将用来生成 Java bean 的 WSDL、WSIL 或 HTML 文件的 URI。也可以选择从此文件生成 WSIL 文件。
  7. “生成 Web Service 绑定代理”面板:选择绑定和代理选项。
  8. “Web Service 代理测试”面板:选择将用来测试代理的测试工具以及想要包括在代理中的方法。注意,“通用测试客户机”(UTC)仅与在 WebSphere 服务器上部署的 Web Service 客户机兼容。单击完成

注意:

要点:建议选择服务 WSDL 文档,而不是绑定 WSDL 文档,以便生成包含完整端点信息的客户机代理。service 元素是您将发布的“企业服务”的基础。不能使用没有 service 元素的 WSDL 文档来发布“企业服务”。如果根据 WSDL 绑定文档生成代理,必须在调用该代理中的任何其它方法之前调用 setEndPoint() 方法来设置端点 URL。 根据 WSDL 绑定文档生成的代理不自动提供端点 URL。

生成的 Java bean 代理提供了至 Web Service 的远程过程调用接口。样本 Web 应用程序演示如何对代理文件进行编码。

一旦生成了 Java 客户机代理,就可使用“Web Service”样本 JSP 或“通用测试客户机”并通过代理来测试 Web Service 的方法。

有关创建 Web 项目的更多信息,参阅 Web 应用程序开发文档。

使用条款 | 反馈
(C) Copyright IBM Corporation 1999, 2005. All Rights Reserved.