“Web Service 客户机”向导帮助您生成 Java™ bean 代理和样本应用程序。样本 Web 应用程序演示如何对代理文件进行编码。
先决条件:
- 如果要将 Apache Jakarta Tomcat servlet 容器用作服务器,则必须安装它,为它配置实例,并创建一个以它作为目标的 Web 项目,如创建 Apache Tomcat 服务器和 Web 项目中所述。
- 如果您正在使用 WebSphere® 服务器,则创建一个以适当服务器为目标的动态 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”页面:选择要生成的代理类型以及是否将测试它。
- “客户机环境配置”页面:为 Web Service 客户机选择运行时环境和服务器。
- 单击资源管理选项并选择
Apache Axis 1.0 运行时环境,然后选择想要运行 Web Service 客户机的服务器。 如果想要使用 IBM® SOAP 运行时环境或 IBM WebSphere 运行时环境,请参阅相应的任务。
- 选择想要创建 Web Service 客户机的项目的类型和名称。
- 如果输入现有项目的名称,则项目类型字段必须与现有项目的项目类型字段相匹配。确保选择作为“客户机 Web 项目”的项目与“服务 Web 项目”不同,否则,服务将被客户机生成的构件覆盖。
- 如果输入一个尚不存在的项目的名称,则向导将为您创建该项目。
- 注意,Axis 和 SOAP 运行时客户机支持的唯一项目类型是 Web 项目。如果想要在 Java、EJB 或应用程序客户机项目中创建客户机,则必须为客户机选择 WebSphere 运行时环境。
- “选择 Web Service”页面:输入将用来生成客户机的 WSDL、WSIL 或 HTML 文件的 URI。也可以选择从此文件生成 WSIL 文件。
- “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。该方法的结果将显示在结果窗格中。
- 如果选择了使用“通用测试客户机”来测试生成的代理,则将在浏览器窗口中的以下 URL 处启动该代理:http://localhost:9080/UTC/preload?object= BeanPackage. BeanServiceProxy。在“引用”窗格中的“对象引用”下面,展开代理存根以显示
Web Service 的方法。单击想要测试的方法,在“参数”窗格中输入值并单击调用。将在下面生成结果。
- 如果选择了使用“Web Service 资源管理器”来测试 Web Service,则“Web Service 资源管理器”将打开。选择想要测试的操作,输入必需的信息并单击执行。结果将显示在“状态”窗格中。
有关创建 Web 项目的更多信息,参阅 Web 应用程序开发文档。