用于 JAX-WS 应用程序的 wsgen 命令

当从 Java 代码启动时，wsgen 命令行工具将生成针对 XML Web Service 的 Java API（JAX-WS）应用程序所必需的可移植工件。仅当请求生成 WSDL 文件时，此工具才会生成 WSDL 文件。

当使用自底向上方法来开发 JAX-WS Web Service 并且是从服务端点实现开始进行开发时，使用 wsgen 工具来生成必需的 JAX-WS 可移植工件。

wsgen 工具接受正确注释的服务端点实现，该实现使用 @WebService 注释作为输入，并且将生成下列可移植工件：

• 对消息内容进行编组和数据编出所需要的任何其他 Java XML 绑定体系结构（JAXB）类。
• WSDL 文件（如果指定了可选的 -wsdl 参数）。wsgen 工具并不会自动生成 WSDL 文件。

避免故障： 当多个 XMLType 注释在不同 Java 包中定义了同一个 @XMLType 名称时，wsgen 命令无法在这些注释之间区分 XML 名称空间。如果出现了这种情况，那么将产生以下错误：

Error: Two classes have the same XML type name ....
Use @XmlType.name and @XmlType.namespace to assign different names to them...

此错误指示您具有同名的类或 @XMLType.name 值，但它们存在于不同的 Java 包中。要防止此错误，请将 @XML.Type.namespace 类添加至现有的 @XMLType 注释以区分 XML 类型。gotcha

语法

命令行语法是：

wsgen [options] service_implementation_class

参数

service_implementation_class 名称是需要的唯一参数。对于 wsgen 命令，下列参数是可选参数：

-classpath <path>

指定服务实现类所在的位置。

-cp <path>

此参数与 -classpath <path> 的功能相同。

-d <directory>

指定用于放置生成的输出文件的位置。

-extension

指定是否允许对不是由 JAX-WS 规范指定的功能进行定制扩展。使用扩展可能会产生不可移植的应用程序或者不与其他实现互操作的应用程序。

-help

显示帮助菜单。

-keep

指定是否保留已生成的源文件。

-r <directory>

此参数仅与 -wsdl 参数一起使用。它指定用于放置生成的 WSDL 文件的位置。

-s <directory>

指定用于放置生成的源文件的目录。

-verbose

指定此参数以输出一些消息来说明编译器正在执行哪些操作。

-version

打印版本信息。如果指定此选项，那么将只输出版本信息，不会进行正常的命令处理。

-wsdl [:protocol]

缺省情况下，wsgen 不会生成 WSDL 文件。此可选参数将导致 wsgen 生成 WSDL 文件，它通常只用来允许开发者在部署端点之前复查 WSDL 文件。protocol 是可选的，它指定 wsdl:binding 中所使用的协议。protocol 的有效值为 soap 1.1 和 Xsoap 1.2。缺省值为 soap 1.1。值 Xsoap 1.2 不是标准的，只能与 -extension 选项一起使用。

-servicename <name>

此参数仅与 -wsdl 选项一起使用。指定要在 WSDL 文件中生成的一个 wsdl:service 名称。例如，

-servicename "{http://mynamespace/}MyService"

-portname

此参数仅与 -wsdl 选项一起使用。指定要在 WSDL 文件中生成的一个 wsdl:port 名称。例如，

-portname "{http://mynamespace/}MyPort"