使用 IBM SOAP 运行时环境从 WSDL 文档创建 Java bean 框架

Web Service 向导帮助您从现有的 WSDL 文档创建框架 bean。框架 bean 包含与 WSDL 文档中描述的操作相对应的一组方法。创建 bean 时,每个方法都具有通过编辑该 bean 替换的基本实现。

先决条件:
  1. 如果您正在使用 WebSphere 服务器,则创建一个以适当服务器为目标的动态 Web 项目,如创建 WebSphere 服务器和 Web 项目所述。因为启动 WebSphere Application Server 可能要花费几分钟时间(这取决于计算机的速度),所以强烈建议您在运行 Web Service 向导之前启动服务器。要启动服务器,在“服务器”视图(窗口 > 显示视图 > 服务器)中选择它,单击鼠标右键,然后单击启动
  2. 发现 WSDL 文档并将它导入 Web 项目中。只能使用包含 service 元素的 WSDL 文件。

要从 WSDL 文档创建框架 Java™ bean:

  1. 切换至“资源”透视图(窗口 > 打开透视图 > 资源)。
  2. 在“导航器”视图中,选择要创建框架 bean Web Service 的 Web 项目。
  3. 单击文件 > 新建 > 其它。选择 Web Service 以显示各种 Web Service 向导。选择 Web Service 向导。单击下一步
  4. “Web Service”页面:选择框架 Java bean Web Service 作为 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. “对象选择”页面:输入将用来生成 Java bean 的 WSDL、WSIL 或 HTML 文件的 URI。也可以选择从此文件生成 WSIL 文件。 确保在 URI 开头没有空格,否则可能会生成空指针异常。
  6. “服务部署配置”页面:指定服务器和客户机部署设置。
    1. 单击编辑并选择 IBM® SOAP 运行时环境,然后选择想要运行 Web Service 和 Web Service 客户机的服务器。 如果想要使用 Apache Axis 1.0 运行时环境或 IBM WebSphere 运行时环境,请参阅相应的任务。
    2. 选择想要创建 Web Service 的 Web 项目和 EAR。 如果它们尚不存在,则向导将为您创建它们。
    3. 选择想要创建 Web Service 客户机的项目的类型和名称。如果输入现有项目的名称,则项目类型字段必须与现有项目的项目类型字段相匹配。如果输入一个尚不存在的项目的名称,则向导将为您创建该项目。注意,Axis 和 SOAP 运行时客户机支持的唯一项目类型是 Web 项目。如果想要在 Java、EJB 或应用程序客户机项目中创建客户机,则必须为客户机选择 WebSphere 运行时环境。
    4. 选择现有 EAR 或输入一个唯一名称以使 Web Service 客户机与 Web Service EAR 以外的另一 EAR 相关联。注意:对 Web Service 和 Web Service 客户机选择不同的 EAR 可以减少遇到运行时错误的机会,但是将使用较多系统资源。
  7. “Web Service 框架 Java Bean 配置”页面:
    • 选择将用来生成 Java 的绑定。
    • 选择 Web Service 的作用域。
    • 选择是否使用静态方法。如果选择了此项,则可用的类方法是静态方法,因此将不会实例化对象。
    • 选择是否使用安全 SOAP。如果选择了此项,则在安全 SOAP 运行时环境中 Web Service 被部署到 WebSphere Application Server。
    • 选择将用来存储生成的 Java 的文件夹、限定类名以及 ISD 和 WSDL 文件。
    • (可选)可以选择显示 Java 至 XML 映射。如果选择要显示的话,则可以查看缺省类型映射并对缺省值进行更改以创建和使用定制映射。
  8. “Web Service 测试”页面:如果选择了测试 Web Service,则为生成的 Web Service 选择测试工具。这将在“Web Service 资源管理器”中打开 Web Service。选择想要测试的操作,输入必需的信息并单击执行 结果将显示在“状态”窗格中。单击下一步
  9. “生成 Web Service 绑定代理”页面:如果已经选择了生成代理,则选择绑定和代理选项。
  10. “Web Service 客户机测试”页面:使用此页面来选择下列选项:
    • 选择测试工具。可以在“通用测试客户机”或者“Web Service 资源管理器”中测试生成的代理,也可以生成样本 Web Service JSP。
    • 如果选择通过 JSP 来测试代理,则可以选择 JSP 所在的文件夹,并且可以选择将包括在 JSP 中的方法。
    • 选择在服务器上运行测试以自动为您启动服务器。
  11. “Web Service 发布”页面:如果选择了将 Web Service 发布到 UDDI 注册中心,则使用此页面来启动“Web Service 资源管理器”并选择将把 Web Service 发布至的 UDDI 注册中心。单击完成
创建 Web Service 之后,根据您选择的选项不同,可能会发生下列情况:
注意:当在 wsdl types schema 元素中使用 import schemaLocation 来指定 XSD 文件时,将不会解析这些 XSD 文件,如以下样本中所示:
<wsdl:types>
  <xs:schema>
    <xs:import namespace="http:// namespace.xsd" schemaLocation=" Location.xsd"/>
  </xs:schema>
</wsdl:types>
如果将以上内容更改为:
<wsdl:import namespace="http:// namespace.xsd" location=" Location.xsd"/>
则会正常地解析 XSDType。
使用条款 | 反馈
(C) Copyright IBM Corporation 1999, 2005. All Rights Reserved.