创建 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。(可选)可以选择执行下列操作:
    1. 选择您想使用滑块来完成的 Web Service 开发阶段:
      • 开发:这将开发 Web Service 的 WSDL 定义和实现。此阶段包括诸如以下任务:创建一些模块,这些模块将包含适当的生成的代码、WSDL 文件、部署描述符和 Java™ 文件。
      • 装配:在目标应用程序服务器需要的情况下,此阶段确保将主管 Web Service 或客户机的项目与 EAR 相关联。
      • 部署:此阶段将为 Web Service 创建部署代码。
      • 安装:此阶段将在目标服务器上安装和配置 Web 模块和 EAR。如果需要对 WSDL 文件的端点进行任何更改,则将在此阶段中进行这些更改。
      • 启动:一旦在服务器上安装了 Web Service,此阶段就会启动服务器。
      • 测试:此阶段将提供各种选项来测试服务,例如,使用“Web Service 资源管理器”或样本 JSP 来测试服务。
    2. 选择服务器:将显示缺省服务器。如果您想将服务部署到另一服务器上,则单击链接以指定另一服务器。
    3. 选择运行时:将显示缺省 DADX 运行时。如果您想将服务部署到另一 DADX 运行时,则单击链接以指定另一运行时。 在 WORF V8.2 中,DADX 工具仅支持 Apache Axis 1.1 运行时。在 WORF V9.1 中,支持 Apache Axis 1.1 和 IBM WebSphere JAX-RPC 运行时。
    4. 选择服务项目:将显示在工作空间中所选择的项目。要选择另一个项目和 EAR,单击项目链接。 确保选择作为“客户机 Web 项目”的项目与“服务 Web 项目”不同,否则,服务将被客户机生成的工件覆盖。
    5. 如果想要创建客户机,则选择要生成的代理类型,然后对该客户机重复执行上述步骤。
    6. 发布 Web Service:这将启动“Web Service 资源管理器”以将 Web Service 发布至 UDDI 注册中心。
    7. 监视 Web Service:这将通过“TCP/IP 监视器”来发送 Web Service 流量,“TCP/IP 监视器”可以监测由 Web Service 生成的 SOAP 流量,还可以测试此流量以保持 WS-I 一致性。还可以手工设置 TCP/IP 监视器,如使用 TCP/IP 监视器来测试 Web Service 中所述。
  4. 在“Web Service DADX 组属性”页面上输入 DADX 组的信息。 此信息应从您在创建 DADX 组配置中完成的 DADX 组配置中动态取得,但也可以在此面板上覆盖或修改该信息。
  5. “启动服务器”页面:如果尚未启动服务器,则需要启动它之后才能执行任何后续操作。
  6. “生成 Web Service 绑定代理”页面:如果已经选择了生成代理,则选择绑定和代理选项。
  7. “Web Service 客户机测试”页面:使用此页面来选择下列选项:
    • 选择测试工具。可以在“通用测试客户机”或者“Web Service 资源管理器”中测试生成的代理,也可以生成样本 Web Service JSP。
    • 如果选择通过 JSP 来测试代理,则可以选择 JSP 所在的文件夹,并且可以选择将包括在 JSP 中的方法。
    • 选择在服务器上运行测试以自动为您启动服务器。
  8. “Web Service 发布”页面:选择是否想将此 Web Service 发布至 UDDI 注册中心。单击完成
  9. 创建 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 中的指示信息来完成此任务。
创建 Web Service 时,根据您选择的选项不同,可能会创建、复制或移动下列文件和文件夹:
  • 根据将项目设置为的 WORF 版本,plugins/com.ibm.etools.webservice.dadxtools_7.0.0/worfRuntime/worf_v82/runtime/worf/*plugins/com.ibm.etools.webservice.dadxtools_7.0.0/worfRuntime/worf_v91/runtime/worf/* 文件将被复制到 Web_Project/WebContent/worf 目录中。
  • Web_Project/WebContent/WEB-INF 目录下创建了 lib 目录。适当版本的 worf.jarworf-servlets.jar 文件被复制到此目录中。对于 Apache Axis,还会将必需的 JAR 文件复制到此目录中。
  • Web_Project/WebContent/worf 目录中创建了测试页面的 .jsp.html.gif 文件。
  • Web_Project/WebContent/WEB-INF 目录中,使用 DADX Web 应用程序的 servlet 定义更新了 web.xml 文件。注意,在将组添加至 Web 项目时,在 Web 应用程序的根上下文级别定义了两个附加的 servlet,一个用于 LIST 函数,另一个用于 inspection.wsil 列示函数。
  • 如果使用了 Apache Axis 运行时环境,则会在 Web_Project/WebContent/WEB-INF 目录中创建 server-config.wsdd 文件。
  • 如果使用了 IBM WebSphere 运行时环境,则创建或更新了下列文件:
    • webservices.xml
    • group___dadx.dadx.wsdl
    • group___dadx.dadx.xml
    • ___filename.xsd
  • Web_Project/WebContent 目录中,在 wsdl 目录中创建了 DADX 文件 dadx.wsdl 的 WSDL 文件。
  • Web_Project/WebContent 目录中还创建了 db2WebRowSet.xsd 文件。
注意,一些文件名位于同一位置,对于 DADX Web Service 提供程序的每个版本,它们是不相同的。一定不要手工从其他位置复制这些文件,也不要将它们复制至其他位置。另外,生成的文件已从发布区域复制到工作空间中。如果文件是通过在 Web Service 向导外部执行操作来生成的,例如,从浏览器中生成的,则不会将它们复制到工作空间中,如果后来又创建了另一个 DADX 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 文件。

要点


反馈