创建 DADX Web service

创建 DADX 组和 DADX 文件后,使用 Web Service 向导来创建和部署 Web service。创建并部署 Web service 后,向导将帮助您生成客户机代理或样本应用程序以测试新的 Web service。当完成测试后,可以将 Web service 发布到“UDDI 企业注册中心”。

先决条件:
要创建 Web service:
  1. 选择 DADX 文件。
  2. 单击文件 > 新建 > 其它。选择 Web Service 以显示各种 Web Service 向导。选择 Web Service 向导。单击下一步
  3. 在 Web Service 页面上,从 Web Service 类型下拉列表中选择 DADX 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 一致性。
  4. 选择对象页面:浏览至想要从它创建 Web service 的 DADX 文件。
  5. “服务部署配置”页面:指定服务器和客户机部署设置。
    1. 单击编辑并选择适当的运行时环境,然后选择想要运行 Web service 和 Web service 客户机的服务器。
    2. 接受想要创建 Web Service 的缺省 Web 项目和 EAR。确保所选择的项目包含一个 DADX 组,该 DADX 组中包含 DADX 文件。 如果它们尚不存在,则向导将为您创建它们。注意:必须接受缺省项目名称,否则向导可能不能继续。
    3. 接受想要创建 Web Service 客户机的项目的类型和名称。 注意:必须接受缺省项目名称,否则向导可能不能继续。
    4. 选择现有 EAR 或输入一个唯一名称以使 Web Service 客户机与 Web Service EAR 以外的另一 EAR 相关联。注意:对 Web Service 和 Web Service 客户机选择不同的 EAR 可以减少遇到运行时错误的机会,但是将使用较多系统资源。
  6. 在 DADX 组属性页面上输入 DADX 组的信息。 此信息应从您在创建 DADX 组配置中完成的 DADX 组配置中动态取得,但也可以在此面板上覆盖或修改该信息。
  7. “生成 Web Service 绑定代理”面板:如果已经选择了生成代理,则选择绑定和代理选项。
  8. “Web Service 客户机测试”页面:使用此页面来选择下列选项:
    • 选择测试工具。可以在“通用测试客户机”或者“Web Service 资源管理器”中测试生成的代理,也可以生成样本 Web Service JSP。
    • 如果选择通过 JSP 来测试代理,则可以选择 JSP 所在的文件夹,并且可以选择将包括在 JSP 中的方法。
    • 选择在服务器上运行测试以自动为您启动服务器。
  9. “Web Service 发布”页面:选择是否想将此 Web Service 发布至 UDDI 注册中心。单击完成
  10. 创建 Web Service 之后,根据您选择的选项不同,可能会发生下列情况:
    • 创建或复制下列文件:
      • 所选组中的文件和 DADX 文件被复制至 <Web Project>/WebContent/WEB-INF/classes/groups 目录。
      • 根据对项目设置的 DB2 Web service 提供程序的版本,plugins/com.ibm.etools.webservice.dadx_6.0.1/worfRuntime/worf_v81/runtime/*plugins/com.ibm.etools.webservice.dadx_6.0.1/worfRuntime/worf_v82/runtime/* 文件被复制至 <Web Project>/WebContent/lib 目录。
      • 创建 <Web Project>/WebContent/worf 目录并包含 .jsp、html 和 .gif 文件,用于测试页面。
      • <Web Project>/WebContent/WEB-INF 目录中创建下列文件:
        • 对于 IBM® SOAP,为每个 DADX 创建一个部署描述符 <dadx>.isd 文件,并在部署 DADX 文件时创建一个 dds.xml 文件。
        • 对于 Apache Axis,在部署 DADX 文件时为每个 DADX 文件创建一个 <dadx>.wsdd 文件。
        • 包含 DADX Web 应用程序的 servlet 定义的 web.xml 文件。注意,对于 DADX Web Service 提供程序 V8.2,在 Web 应用程序的根上下文级别定义了两个附加的 servlet,一个用于 LIST 函数,另一个用于 inspection.wsil 侦听函数。对于 Apache SOAP,未设置 <soap-engine> 参数(缺省情况)。对于 Apache Axis,将 <soap-engine> 参数设置为 apache-axis。
      注意,一些文件名位于同一位置,对于 DADX Web Service 提供程序的每个版本,它们是不相同的。一定不要手工从其它位置复制这些文件,也不要将它们复制至其它位置。
    • 如果选择了使用 Web Service JSP 来测试生成的代理,则会在 Web 浏览器中的以下 URL 处启动代理:http://localhost: port/WebProjectClient/sampleBeanName/ WebService/TestClient.jsp。通过选择一种方法,为该方法输入一个值,然后单击调用,这样就可以使用此样本应用程序来测试 Web Service。该方法的结果将显示在结果窗格中。
    • 如果选择了使用“通用测试客户机”来测试生成的代理,则将在浏览器窗口中的以下 URL 处启动该代理:http://localhost:9080/UTC/preload?object=proxy.soap. ProxyNameProxy。在“引用”窗格中的“对象引用”下面,展开该代理以显示 Web Service 的方法。单击想要测试的方法,在“参数”窗格中输入值并单击调用。将在下面生成结果。
    • 如果选择了使用“Web Service 资源管理器”来测试 Web Service,则“Web Service 资源管理器”将打开。选择想要测试的操作,输入必需的信息并单击执行。结果将显示在“状态”窗格中。
    • 如果选择了发布 Web Service,则会启动“Web Service 资源管理器”,它将显示把 Web Service 发布到“IBM UDDI 测试注册中心”所必需的页面。遵循发布 Web Service 中的指示信息来完成此任务。
要了解有关 DB2 XML Extender 和 DADX 规范的更多信息,请参阅 www.ibm.com/software/data/db2/extenders/xmlext/library.html

如果要在远程服务器上运行 DADX,则必须手工将 worf.jarplugins/com.ibm.etools.webservice.dadxtools/worfRuntim/version/runtime 文件夹复制到远程机器上的某个地方。然后,必须更新远程服务器的类路径才能引用此 worf.jar 文件。

要点

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