Apache Axis v1.1 命令行工具参考1

Axis 1.1主要提供了两个辅助开发的命令行工具，分别是WSDL2Java和Java2WSDL。下面对他们的参考文档逐一作详细说明，内容译自Axis Reference Guide和User Guide。

WSDL2Java 参考

用法：java org.apache.axis.wsdl.WSDL2Java [options] WSDL-file-URI

选项：

       -h, --help

       打印帮助信息后退出。

       -v, --verbose

       打印工具运行过程中的更多信息。

       -n, --noImports

         仅为命令行输入的WSDL文档生成代码。默认是为所有WSDL文档生成文件，包括导入(import)的WSDL文档。

        -O, --timeout

         设置超时时间，以秒为单位。默认是45秒，指定-1禁止此功能。(default is 45, specify -1 to disable)。此时间应该是设置WSDL2Java Stub的超时时间。

        -D, --Debug

打印debug 信息，当前为WSDL2Java的符号表。

-W, --noWrapped

关闭对"wrapped" document/literal风格操作的支持。

-s, --server-side

自动生成web service的server-side绑定代码：

1．  一个skeleton类，类名为 Skeleton。此类也可能不生成，具体依赖于选项-S, --skeletonDeploy的取值。

2．  一个实现模板类，类名为 Impl。注意，如果此类已经存在，将不再重新生成。此类就是web service的实现类，用户修改此模板类完成自己的实现。

3．  一个deploy.wsdd文件，用来部署该web service的配置文件。

4．  一个undeploy.wsdd文件，用来解部署该web service的文件。

-S, --skeletonDeploy

在deploy.wsdd中指定是部署骨架(ture)还是部署实现(false)。 若指定为true，deploy.wsdd中的service子句看来像下面这样：

   

    ...

若为false的话，应像下面这样：

   

      ...

默认是false。当使用此选项时，选项-s,--server-side也必须同时明确指定。

-N, --NStoPkg =

指定命名空间到包结构的映射关系。默认的包名由WSDL文档中的命名空间字符串按一定规则生成。典型地，如果命名空间是http://x.y.com或urn:x.y.com的形式，对应的包结构是com.y.x。若不想使用默认的规则，可以用—NstoPkg指定自己的映射。如果需要，此选项可以多次重复使用，每次指定一个唯一的命名空间映射。例如，若WSDL文档中命名空间是"urn:AddressFetcher2"，而想把从命名空间中对象生成的文件都放在samples.addr包中，则可以为WSDL2Java提供如下选项：

--NStoPkg urn:AddressFetcher2=samples.addr

注意，如果使用短选项标记，“-N”，必须保证在“-N”和命名空间之间没有空格。

-f, --fileNStoPkg

用来指定NstoPkg映射的属性文件，默认是NstoPkg.properties。如果WSDL文档有很多命名空间，在命令行逐一列出很是冗长。为保存命令行的简洁，WSDL2Java也可在一个属性文件中寻找映射。默认此文件名为NstoPkg.properties，且必须位于没有包的目录中，即位于输出目录的根目录中。也可以使用—fileNStoPkg选项来明确指定自定义的文件。

该属性文件中条目的格式与命令行—NstoPkg选项参数的格式一样。例如，替代上面提供的命令行选项，在NstoPkg.properties属性文件中提供同样的信息：

       urn/:AddressFetcher2=samples.addr

(注：属性文件中的冒号必须使用转义字符)

如果特定的映射条目同时出现在命令行和属性文件中，命令行条目优先。

-p, --package

 此选项映射WSDL文档中所有的命名空间到同一个Java包名。此选项将覆盖所有的命名空间到包的映射，都替换为用同一个包名。此选项有用，但有危险，使用前必须确认已理解了用后的结果。例如在不同的命名空间中可能有具有同一名字的多个类型。

-o, --output

指定存放生成文件的输出目录。 

-d, --deployScope

在deploy.wsdd文件中加入"Application", "Request", "Session"范围(scope)参数。若不指定此选项，则在deploy.wsdd中没有scope标记出现。Axsi默认的”Request”。

-t, --testCase

生成web service的客户端Junit测试类。此类可作为用户测试时用来填充的模板。

-a, --all

为所有的元素生成代码，即使元素未被引用。WSDL2Java默认只为在WSDL文件中被引用的元素生成代码。生成代码的锚点(anchor)是按types、portTypes、bindings、services的顺序中在WSDL文档中最底的元素。举例来说，若WSDL文件只包含types，则所有列出的types将被生成代码。但如果WSDL文件包含types和portType，则该portType和所有被该portType引用的types将被生成代码。其他情况依此类推。

注意，只有在命令行出现的WSDL文档中的锚点才被搜索，而不是被导入的WSDL文档中的锚点。

-T, --typeMappingVersion

指定类型映射的版本，1.1或1.2。默认是1.1版本。？

-F, --factory

指定自定义的实现GeneratorFactory 接口的类名，以扩展Java代码生成器的功能。

-H, --helperGen

为元数据生成单独的Helper类。

-U, --user

存取提供的WSDL-URI的用户名。此用户名在解析作为WSDL2Java输入的WSDL-URL时使用。如果此URI包含一个用户名，这将覆盖命令行的设置。一个带有用户名和口令的URL的例子是：http://user:password@hostname:port/path/to/service?WSDL

-P, --password

存取提供的WSDL-URI的口令。若该URI已包含口令，将覆盖命令行的设置。