WSDL2Client 工具参考

WSDL2Client 工具从 Web Service 的 WSDL 文档生成客户机。 

语法

一旦设置了命令行,就可以使用以下语法和自变量来运行此工具:

要创建框架客户机实现:
  • <WSDL URI> 必须是最后一个自变量。
  • 要成功运行 -createEar 自变量,在创建框架 Web Service 客户机实现时必须指定 -clientType 自变量。
要创建客户机归档:

自变量

要创建框架客户机实现:

必需自变量:

-project <ProjectName>
为输出指定目标项目目录的标准路径名。如果此目录不存在,则 WSDL2Client 会创建它。缺省值是当前目录。
<WSDL-URI>
指定 WSDL 文档的位置作为 URI。此 URI 可以在远程文件系统上,也可以在本地文件系统上。如果 WSDL 分割为多个 WSDL 文档上,则必须指定导入链顶部的文档(通常是实现 WSDL)。

可选自变量:

-NSToPkg <mappings>
指定“名称空间 = 包”映射的列表。
-fileNSToPkg <mappings file>
指定包含“名称空间 = 包”映射的属性文件的路径。注意,在此文件中,必须用反斜杠对名称空间中的冒号(“:”)进行转义。例如,http\://my.namespace。WSDL2Client 会忽略不包含转义冒号的任何名称空间引用。
-all
为 WSDL 文档中定义的所有复杂类型生成 Java™ 类。缺省情况是只生成既在 WSDL 文档中定义又在 WSDL 文档中引用的类。
-genResolver
生成导入解析器,它包含导入的 xsd(XML 模式)文件的所有信息。有关此参数的更多信息,请参阅注释 1
-wsSecDir <directory>
指定包含模板的目录的完整路径,这些模板用于通过 WS-Security 信息来配置 EJB2WebService 生成的部署描述符。该目录必须包含 ibm-webservices-bnd.xmi 和 ibm-webservices-ext.xmi 文件。如果要生成客户机端绑定,则该目录还必须包含 ibm-webservicesclient-bnd.xmi 和 ibm-webservicesclient-ext.xmi 文件。
-clientType <J2SE | Application | Servlet | EJB>
为指定的客户机类型生成框架实现类。此自变量只能与 -genMain 自变量配合使用。
-genMain <name of main class>
指定要生成的 main 类的名称。此自变量只能与 -clientType 自变量配合使用。
-user
指定要用于访问 WSDL URI 的用户名。
-password
指定要用于访问 WSDL URI 的密码。
-verbose
在工具运行时显示额外的信息。
-help
显示帮助信息。
-clientName <client name>
在 <ProjectDirectory> 中名为 <client name> 的目录下生成客户机。
-overwrite
覆盖任何现有的客户机目录。

要创建客户机归档:

必需自变量:
-createEar<name of target ear file>
指定要创建的 EAR 文件的标准路径名。如果该路径名已经存在,则在新路径名覆盖它之前将会用 .ear~ 扩展名对它进行备份。
-clientType <application | servlet | EJB>
指定要实现的客户机类型。
-ri
指定客户机远程接口的名称。这必须是标准包名。如果指定了 -clientType EJB,则此自变量是必需的。对于所有其它类型,该自变量无效。
-main
指定客户机 main 类的名称。这必须是标准包名。如果指定了 -clientType <Application | Servlet>,则此自变量是必需的。对于所有其它类型,该自变量无效。
<ProjectDir>
由 WSDL2Client 的第 1 阶段或其它工具中的一个(例如,Bean2WebService)创建的项目目录的路径名。此目录必须包含客户机的已编译实现的 Client-side 目录。
可选自变量:
-verbose
在工具运行时显示额外的信息。
-help
显示帮助信息。
-rootModule <root module base name>
将具有同一客户机类型的各个 Web service 客户机合并和聚集到单个模块中。仅当用 -clientName 选项生成客户机时有效。Web 模块将被命名为 <root module base name>_WEB.war,EJB 客户机模块将被命名为 <root module base name>_EJB.jar,而应用程序客户机模块将被命名为 <root module base name>_APP.jar。
注释 1:只选择 -genResolver 自变量以显示远程的绝对引用局部变量,使得当 Web Service 运行时,不必连接至因特网。该自变量不应用于本地或相对导入。另外,-genResolver 选项不应在包含导入 XSD 文件的 WSDL 导入的 WSDL 文件上使用。例如,不是使用 schema 元素外面的 WSDL 导入:
  <import location="a.xsd" namespace="http://namespaceA"/>
  <types>
    <schema xmlns="http://www.w3.org/2001/XMLSchema" 
      targetNamespace="http://namespaceA" 
      xmlns:xsd="http://www.w3.org/2001/XMLSchema">
而是使用 schema 元素中的 schema import 替换它:
  <types>
    <schema xmlns="http://www.w3.org/2001/XMLSchema" 
      targetNamespace="http://namespaceA" 
      xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <import schemaLocation="a.xsd" namespace="http://namespaceA"/>
使用条款 | 反馈
(C) Copyright IBM Corporation 1999, 2005. All Rights Reserved.