Web Service 向导帮助您从现有 WSDL 文档创建框架 bean。框架 bean 包含与 WSDL 文档中描述的操作相对应的一组方法。创建 bean 时,每个方法都具有通过编辑该 bean 替换的基本实现。
先决条件:
- 创建动态 Web 项目,如创建 WebSphere® 服务器和
Web 项目中所述。因为启动 WebSphere Application Server 可能要花费几分钟时间(这取决于计算机的速度),所以强烈建议您在运行 Web Service 向导之前启动服务器。要启动服务器,在“服务器”视图(窗口 > 显示视图 > 服务器)中选择它,右键单击并单击启动。
- 创建或发现 WSDL 文档并将它导入 Web 项目中。只能使用包含 service 元素的 WSDL 文件。
要使用 WebSphere JAX-RPC 运行时环境从 WSDL 文档创建框架 Java™ bean:
- 切换至 J2EE 透视图(窗口 > 打开透视图 > J2EE)。
- 在“项目资源管理器”视图中,选择要创建框架 bean Web Service 的 Web 项目,并选择已创建或已导入的 WSDL 文件。
- 单击文件 > 新建 > 其他。选择 Web Service 以显示各种 Web Service 向导。选择 Web Service 向导。单击下一步。
- “Web Service”页面:选择将自顶向下 Java bean Web Service 作为 Web Service 类型。(可选)可以选择执行下列操作:
- 选择您想使用滑块来完成的 Web Service 开发阶段:
- 开发:这将开发 Web Service 的 WSDL 定义和实现。此阶段包括诸如以下任务:创建一些模块,这些模块将包含适当的生成的代码、WSDL 文件、部署描述符和 Java 文件。
- 装配:在目标应用程序服务器需要的情况下,此阶段确保将主管 Web Service 或客户机的项目与 EAR 相关联。
- 部署:此阶段将为 Web Service 创建部署代码。
- 安装:此阶段将在目标服务器上安装和配置 Web 模块和 EAR。如果需要对 WSDL 文件的端点进行任何更改,则将在此阶段中进行这些更改。
- 启动:一旦在服务器上安装了 Web Service,此阶段就会启动服务器。
- 测试:此阶段将提供各种选项来测试服务,例如,使用“Web Service 资源管理器”或样本 JSP 来测试服务。
- 选择服务器:将显示缺省服务器。如果您想将服务部署到另一服务器上,则单击链接以指定另一服务器。
- 选择运行时:将显示缺省运行时。如果您想将服务部署到另一运行时,则单击链接以指定另一运行时。
- 选择服务项目:将显示在工作空间中所选择的项目。要选择另一个项目和 EAR,单击项目链接。 确保选择作为“客户机 Web 项目”的项目与“服务 Web 项目”不同,否则,服务将被客户机生成的工件覆盖。
- 如果想要创建客户机,则选择要生成的代理类型,然后对该客户机重复执行上述步骤。
- 发布 Web Service:这将启动“Web Service 资源管理器”以将 Web Service 发布至 UDDI 注册中心。
- 监视 Web Service:这将通过“TCP/IP 监视器”来发送 Web Service 流量,“TCP/IP 监视器”可以监测由 Web Service 生成的 SOAP 流量,还可以测试此流量以保持 WS-I 一致性。还可以手工设置 TCP/IP 监视器,如使用 TCP/IP 监视器来测试 Web Service 中所述。
- “Web Service 框架 Java Bean 配置”页面:
- 框架文件夹:输入想要创建 Java bean
框架的位置。
- 设置服务部署作用域。这指示如何部署服务器实现。应用程序会将实现类的一个实例用于所有请求。对于每个请求,都会创建实现类的新实例。对于每个会话,都会创建实现类的新实例。
- 可以选择是否想对此 Web Service 启用安全性;安全性不符合 WS-I。
- 定义名称空间至包的定制映射:如果想要查看或编辑包与名称空间之间的映射,则选中此复选框。
- “Web Service 名称空间至包映射”页面:Web Service 向导从指定 WSDL 生成许多 Java 文件。缺省情况下,它将根据
WSDL 文件中指定的名称空间创建包名。要覆盖此缺省行为,可以为 WSDL 文件中部分或全部名称空间指定您自己的包名。如果在前一页面上选择了定义名称空间至包的定制映射,则可以在此页面上通过单击添加来输入定制映射对。或者,可以单击导入以从 .properties 文件中导入定制映射对。属性文件的内容必须采用 namespace=package 格式。
- “Web Service 代理”页面:如果已经选择了生成代理,则此页面将显示该代理的选项。它列示了将生成代理的文件夹,且可以选择为代理启用安全性并创建名称空间与包之间的定制映射。
- “Web Service 客户机名称空间至包映射”页面:如果在前一页面上选择了定义名称空间至包的定制映射,则可以在此页面上通过单击添加来输入定制映射对。或者,可以单击导入以从 .properties 文件中导入定制映射对。属性文件的内容必须采用 namespace=package 格式。
- “Web Service 发布”页面:如果选择了将 Web Service 发布到
UDDI 注册中心,则使用此页面来启动“Web Service 资源管理器”并选择将把
Web Service 发布至的 UDDI 注册中心。单击完成。
创建 Web Service 之后,根据您选择的选项不同,可能会发生下列情况:
- 如果选择了使用 Web Service JSP 来测试生成的代理,则会在 Web 浏览器中的以下 URL 处启动代理:http://localhost: port/ WebProjectClient/sampleBeanName/WebServiceName/TestClient.jsp。通过选择一种方法,为该方法输入一个值,然后单击调用,这样就可以使用此样本应用程序来测试 Web Service 了。该方法的结果将显示在结果窗格中。由于这是一个具有基本方法实现的 Java bean 框架,因此将返回一个值 -3。
- 如果选择了使用通用测试客户机来测试生成的代理,则将在浏览器窗口中的以下 URL 处启动该代理:http://localhost:9080/UTC/preload?object= BeanPackage. BeanServiceProxy。在“引用”窗格中的“对象引用”下面,展开代理存根以显示
Web Service 的方法。单击想要测试的方法,在“参数”窗格中输入值并单击调用。将在下面生成结果。
- 如果选择了使用“Web Service 资源管理器”来测试 Web Service,则“Web Service 资源管理器”将打开。选择想要测试的操作,输入必需的信息并单击执行。结果将显示在“状态”窗格中。
- 如果选择了发布 Web Service,则会启动“Web Service 资源管理器”,它将显示把
Web Service 发布到“IBM® UDDI 测试注册中心”所必需的页面。遵循发布 Web Service 中的指示信息来完成此任务。