从 WSDL 文档生成 Java 客户机代理和样本应用程序

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

先决条件：

创建动态 Web 项目，如创建 WebSphere^® 服务器和 Web 项目中所述。因为启动 WebSphere Application Server 可能要花费几分钟时间（这取决于计算机的速度），所以强烈建议您在运行 Web Service 向导之前启动服务器。要启动服务器，在“服务器”视图（窗口 > 显示视图 > 服务器）中选择它，右键单击并单击启动。
发现 WSDL 文档并将它导入 Web 项目中。只能使用包含 service 元素的 WSDL 文件。

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

切换至 J2EE 透视图（窗口 > 打开透视图 > J2EE）。
在“项目资源管理器”视图中，选择要生成样本应用程序的 Web 项目。
单击文件 > 新建 > 其他。选择 Web Service 以显示各种 Web Service 向导。选择 Web Service 客户机向导。单击下一步。
Web Service 页面：选择将用来生成客户机的 WSDL 文件。（可选）可以选择执行下列操作：
1. 选择您想使用滑块来完成的 Web Service 客户机开发阶段：
  - 开发：这将开发 Web Service 的 WSDL 定义和实现。此阶段包括诸如以下任务：创建一些模块，这些模块将包含适当的生成的代码、WSDL 文件、部署描述符和 Java 文件。
  - 装配：在目标应用程序服务器需要的情况下，此阶段确保将主管 Web Service 客户机的项目与 EAR 相关联。
  - 部署：此阶段将为客户机创建部署代码。
  - 安装：此阶段将在目标服务器上安装和配置 Web 模块和 EAR。如果需要对 WSDL 文件的端点进行任何更改，则将在此阶段中进行这些更改。
  - 启动：一旦在服务器上安装了客户机，此阶段就会启动服务器。
  - 测试：此阶段将提供各种选项来测试服务，例如，使用“Web Service 资源管理器”或样本 JSP 来测试服务。
2. 选择服务器：将显示缺省服务器。如果您想将服务部署到另一服务器上，则单击链接以指定另一服务器。
3. 选择运行时：将显示缺省运行时。如果您想将服务部署到另一运行时，则单击链接以指定另一运行时。
4. 选择服务项目：将显示一个项目，它包含在工作空间中所选择的项目。要选择另一个项目和 EAR，单击项目链接。确保选择作为“客户机 Web 项目”的项目与“服务 Web 项目”不同，否则，服务将被客户机生成的工件覆盖。
5. 监视 Web Service：这将通过“TCP/IP 监视器”来发送 Web Service 流量，“TCP/IP 监视器”可以监测由 Web Service 生成的 SOAP 流量，还可以测试此流量以保持 WS-I 一致性。还可以手工设置 TCP/IP 监视器，如使用 TCP/IP 监视器来测试 Web Service 中所述。
“Web Service 代理”页面：此页面显示用于代理的选项。它列示了将生成代理的文件夹，且可以选择为代理启用安全性并创建名称空间与包之间的定制映射。单击下一步。
“Web Service 客户机名称空间至包映射”页面：Web Service 客户机向导从指定 WSDL 生成许多 Java 文件。缺省情况下，它将根据 WSDL 文件中指定的名称空间创建包名。要覆盖此缺省行为，可以为 WSDL 文件中部分或全部名称空间指定您自己的包名。如果在前一页面上选择了定义名称空间至包的定制映射，则可以在此页面上通过单击添加来输入定制映射对。或者，可以单击导入以从 .properties 文件中导入定制映射对。属性文件的内容必须采用 namespace=package 格式。从 WSDL 生成 Java 时还可以选择禁用数据绑定并使用 SOAP 元素。单击下一步。
“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 了。该方法的结果将显示在结果窗格中。
如果选择了使用通用测试客户机来测试生成的代理，则将在浏览器窗口中的以下 URL 处启动该代理：http://localhost:9080/UTC/preload?object= BeanPackage. BeanServiceProxy。在“引用”窗格中的“对象引用”下面，展开代理存根以显示 Web Service 的方法。单击想要测试的方法，在“参数”窗格中输入值并单击调用。将在下面生成结果。
如果选择了使用“Web Service 资源管理器”来测试 Web Service，则“Web Service 资源管理器”将打开。选择想要测试的操作，输入必需的信息并单击执行。结果将显示在“状态”窗格中。

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

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