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

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

先决条件:

  1. 如果要将 Apache Jakarta Tomcat servlet 容器用作服务器,则必须安装它,为它配置实例,并创建一个以它作为目标的 Web 项目,如创建 Apache Tomcat 服务器和 Web 项目中所述。
  2. 发现 WSDL 文档并将它导入 Web 项目中。只能使用包含 service 元素的 WSDL 文件。
要从发现的 WSDL 文档生成 Java 客户机代理和样本应用程序:
  1. 切换至 J2EE 透视图(窗口 > 打开窗口 > J2EE)。
  2. 在“导航器”视图中,选择要生成样本应用程序的 Web 项目。
  3. 单击文件 > 新建 > 其他。选择 Web service 以显示各种 Web service 向导。选择 Web service 客户机向导。单击下一步
  4. Web service 页面:
    1. 输入将用来生成客户机的 WSDL、WSIL 或 HTML 文件的 URI。
    2. 选择要生成的代理类型
    3. 选择 Web service 开发过程中需要使用滑块完成的阶段:
      • 开发:这将创建客户机代码
      • 汇编:
      • 部署:这将为客户机创建部署代码
      • 安装:这将在选择的服务器上安装客户机
      • 启动:一旦在服务器上安装了客户机,这就将启动服务器
      • 测试:这将为测试客户机提供各个选项
    4. 选择服务器:这会显示缺省服务器。如果需要将客户机部署到另一服务器上,则请单击该链接以指定另一服务器。
    5. 选择运行时:这会显示缺省运行时。如果需要将客户机部署到另一运行时上,则请单击该链接以指定另一运行时。
    6. 选择客户机项目:这会显示工作空间中包含所选项目的项目。要选择另一项目和 EAR,请单击项目链接。 请确保选择作为“客户机 Web 项目”的项目与“服务 Web 项目”不同,否则,服务将被客户机生成的工件覆盖。
    7. 监控 Web service:这将通过“TCP/IP 监视器”来发送 Web service 流量,从而使您可以监测由 Web service 生成的 SOAP 流量,还可以测试此流量以检查 WS-I 一致性。或者,可以手工设置 TCP/IP 监视器,如 使用 TCP/IP 监视器来测试 Web service 中所述
  5. “Web service 代理”页面:此面板显示用于代理的选项。它列示了将生成代理的文件夹,且您可以选择创建名称空间与包之间的定制映射。
  6. “Web service 名称空间至包映射”页面:如果在上一页选择了定义名称空间至包的定制映射,则可以在此页面上通过单击添加来输入定制映射对。
  7. “Web service 客户机测试”页面:如果选择了测试客户机,则此页面会显示。请选择将用来测试代理的测试工具以及需要包括在代理中的方法。注意,“通用测试客户机”(UTC)仅与在 WebSphere® 服务器上部署的 Web service 客户机兼容。
  8. 单击完成。如果已经选择了测试代理,测试客户机就会在浏览器窗口中打开。

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

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

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