使用 IBM SOAP 运行时环境时从企业 bean(EJB)创建 Web Service

先决条件:

Web Service 向导帮助您创建新的 Web Service、配置它以进行部署并将 Web Service 部署到服务器。一旦部署了 Web Service,向导将帮助您生成客户机代理和样本应用程序来测试该 Web Service。当完成测试后,可以使用“导出”向导将 Web Service 发布到“UDDI 企业注册中心”。

有关 EJB 应用程序开发的更多信息,参阅 EJB 工具。

注意:Rational Developer 产品支持从无状态的会话企业 bean 创建企业 bean Web Service。

正在创建的 Web Service 充当企业 bean 的客户机。在启动 Web Service 向导之前,必须部署企业 bean。

要从企业 bean 创建 Web Service:

  1. 切换至 J2EE 透视图(窗口 > 打开透视图 > J2EE)。
  2. 在“项目资源管理器”视图中,选择要创建 Web Service 的 Web 项目。

    或者,可以通过选择企业 bean(将从其创建 Web Service)并遵循其余步骤来从 J2EE 透视图启动 Web Service 向导。

  3. 单击文件 > 新建 > 其它。选择 Web Service 以显示各种 Web Service 向导。选择 Web Service 向导。单击下一步
  4. “Web Service”页面:从 Web Service 类型下拉列表中选择 EJB Web Service。可以有选择地执行下列操作:
    • 启动 Web 项目中的 Web Service - 如果不选择此选项,则将必须手工启动 Web Service。必须选择此选项才能启用此页面上的其它选项。
    • 启动“Web Service 资源管理器”以将 Web Service 发布到 UDDI 注册中心。
    • 为 Web Service 生成 Java™ bean 客户机代理。生成的 Java bean 客户机代理提供了 Web Service 的远程过程调用接口。
    • 测试 Web Service - 这允许您在生成代理之前在“Web Service 资源管理器”中测试 Web Service。
    • 通过“TCP/IP 监视器”来发送 Web Service 通信量,“TCP/IP 监视器”允许您监测由 Web Service 生成的 SOAP 流量,还可以测试此流量以保持 WS-I 一致性。
  5. “服务部署配置”页面:指定服务器和客户机部署设置。
    1. 单击编辑并选择 IBM® SOAP 运行时环境,然后选择想要运行 Web Service 和 Web Service 客户机的服务器。 如果想要使用 IBM WebSphere 运行时环境或 Apache Axis 1.0 运行时环境,请参阅相应的任务。
    2. 为 Web Service 选择 EJB 项目、路由器项目和 EAR。 如果它们尚不存在,则向导将为您创建它们。
    3. 选择想要创建 Web Service 客户机的项目的类型和名称。如果输入现有项目的名称,则项目类型字段必须与现有项目的项目类型字段相匹配。如果输入一个尚不存在的项目的名称,则向导将为您创建该项目。注意,Axis 和 SOAP 运行时客户机支持的唯一项目类型是 Web 项目。如果想要在 Java、EJB 或应用程序客户机项目中创建客户机,则必须为客户机选择 WebSphere 运行时环境。
    4. 选择现有 EAR 或输入一个唯一名称以使 Web Service 客户机与 Web Service EAR 以外的另一 EAR 相关联。注意:对 Web Service 和 Web Service 客户机选择不同的 EAR 可以减少遇到运行时错误的机会,但是将使用较多系统资源。
  6. “Web Service EJB 配置”面板:单击浏览 EJB Bean。这允许您浏览企业 bean 的 J2EE 透视图。
  7. 在“浏览企业 Bean”对话框中选择包含企业 Bean 的企业应用程序项目和 EJB 项目。然后选择企业 Bean 和 EJB 项目。单击确定。EJB 配置(例如,JNDI 提供者 URL、JNDI 初始上下文工厂、EJB JNDI 名称、EJB home 接口类名和 EJB 远程接口路径名)将自动完成。单击下一步

    注意:“浏览企业 Bean”对话框仅显示包含所选 Web 项目的企业应用程序项目。该对话框仅可用来选择那些与 Web项目一样包含在相同的企业应用程序项目中的企业 bean 和“EJB 项目”。

  8. “Web Service Java Bean 标识”面板:指定 Web Service URI 和作用域。(可选)可以选择使用静态方法和安全 SOAP。可以修改此页面上列示的文档和文件夹名,也可以接受缺省名称。
  9. “Web Service Java Bean 方法”面板:选择要显示的方法并选择输入和输出编码样式。如果想查看 Java 至 XML 映射,则选择显示服务器类型映射
  10. “Web Service Java 至 XML 映射”页面:如果已经选择了查看映射,则在此处可以看到它们。或者,通过选择编辑和使用定制映射来定制映射。
  11. “Web Service 测试”页面:如果选择了测试 Web Service,则为生成的 Web Service 选择测试工具并单击“启动”。这将在“Web Service 资源管理器”中打开 Web Service。选择想要测试的操作,输入必需的信息并单击执行。结果将显示在“状态”窗格中。 测试了 Web Service 之后,关闭浏览器窗口并单击下一步
  12. “生成 Web Service 绑定代理”面板:如果已经选择了生成代理,则选择绑定和代理选项。
  13. “Web Service 客户机测试”页面:使用此页面来选择下列选项:
    • 选择测试工具。可以在“通用测试客户机”或者“Web Service 资源管理器”中测试生成的代理,也可以生成样本 Web Service JSP。
    • 如果选择通过 JSP 来测试代理,则可以选择 JSP 所在的文件夹,并且可以选择将包括在 JSP 中的方法。
    • 选择在服务器上运行测试以自动为您启动服务器。
  14. “Web Service 发布”页面:选择是否想将此 Web Service 发布至 UDDI 注册中心。单击完成
创建 Web Service 之后,根据您选择的选项不同,可能会发生下列情况:

要点:如果方法包含不受样本支持的类型(例如,数组、索引属性和集合),则将从样本中省略这些方法,并且您将接收到警告消息。

一旦从企业 bean 创建了 Web Service,就可以使用“通用测试客户机”来测试 Web Service 的方法,然后将 Web Service 发布到“UDDI 企业注册中心”。有关测试和发布应用程序的更多信息,参阅“服务器工具”文档。

有关 EJB 的更多信息,参阅 EJB 应用程序开发文档。

使用条款 | 反馈
(C) Copyright IBM Corporation 1999, 2005. All Rights Reserved.