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