关于 wscompile 工具

另请参见

对于 JAX-RPC Web 服务(J2EE 1.4 规范),IDE 使用与 Sun Java System Application Server 捆绑在一起的 wscompile 工具来创建 Web 服务交互所需的文件。在 IDE 中注册 Sun Java System Application Server 后,便可以从 IDE 中配置和运行 wscompile 工具。

在生成 Web 服务、Web 服务客户端或者包含它们的项目或企业应用程序时,IDE 会调用 wscompile 工具。

wscompile 工具读取 IDE 生成的配置文件以及您可根据需要配置的选项和功能,如下所述。

配置文件

wscompile 工具读取您在创建 Web 服务或 Web 服务客户端时 IDE 生成的配置文件。根据是通过 Java 创建 Web 服务,通过现有 WSDL 文件创建 Web 服务,还是创建 Web 服务客户端,IDE 生成的配置文件会有所不同:

wscompile 工具处理这些配置文件中的信息以及您配置的选项和功能,如以下各节所述。

选项

在创建 Web 服务或 Web 服务客户端时,IDE 会在 build.xml 文件中生成编译目标。在生成 Web 服务、Web 服务客户端或包含它们的 J2EE 应用程序时,该目标将调用 wscompile 工具。对于 Web 服务,该目标命名为 webservicename_wscompile。对于 Web 服务客户端,该目标命名为 webclientname_client_wscompile

wscompile 工具的选项是在调用该工具的目标中配置的。IDE 会设置适用于其上下文的选项。例如,为 JSR-101 Web 服务客户端提供的目标包含用于生成桩模块的选项 (client="true");而 JSR-109 Web 服务客户端的目标则不包含该选项。但是 JSR-109 Web 服务客户端的目标包含允许 wscompile 工具读取 WSDL 文件并通过它来生成客户端文件的选项 (import="true")。(有关 JSR-101 和 JSR-109 之间的差异信息,请单击此处。)

下表列出了 wscompile 工具支持的所有选项,并且说明了这些选项是否在 IDE 提供的缺省目标中受到支持以及受到支持的方式。

wscompile
选项
从头开始创建的服务/来自源的服务 来自 WSDL 的
服务
JSR-109
客户端
JSR-101
客户端
描述
-cp <path> classpath
=a
classpath
=a
classpath
=a
classpath
=a
指定输入类文件的查找位置。
-d <dir> base
=b
base
=b
- - 指定生成的输出文件的放置位置。
-define - - - - 读取服务端点接口,定义服务。
-features featues
=c
featues
=c
featues
=c
featues
=c
启用指定的功能。可以使用 IDE 选择以下功能:生成文档式 Web 服务生成 RPC 式 Web 服务通过 WSDL 文件生成 Web 服务生成客户端的功能。
-g - - - - 生成调试信息。
-gen:
both
- - - - 生成客户端和服务器工件。
-gen:
client
- - client=
"false"
client=
"true"
如果为 "true",则生成客户端工件(桩模块等)。
-gen:
server
server=
"true"
- - - 如果为 "true",则生成 Web 服务工件(绑定等)和 WSDL 文件。
-httpproxy
:<host>
:<port>
- - - - 指定 HTTP 代理服务器。缺省值为 8080。
-import - import=
"true"
import=
"true"
import=
"false"
如果为 "true",则读取 WSDL 文件,生成服务端点接口以及实现接口的类的模板。
-keep keep=
"true"
keep=
"true"
keep=
"true"
keep=
"true"
如果为 "true",则保存生成的文件。
-mapping <file> mapping=d mapping=d mapping=d mapping=d 生成 J2EE mapping.xml 文件。
-model <file> - - - - 将内部模型写入指定的文件中。
-nd <dir> nonClassDir
=e
nonClassDir
=e
- - 指定 WSDL 文件的放置位置。
-O - - - - 优化生成的代码。
-s <dir> - - sourceBase
=f
sourceBase
=f
指定生成的源文件的放置位置。
-source <version> - - - - 为指定的 JAX-RPC SI 版本生成代码。
-verbose verbose=
"true"
verbose=
"true"
verbose=
"false"
verbose=
"false"
如果为 "true",则输出有关编译器正在执行的操作的消息。
-version - - - - 打印版本信息。

密钥

a = ${wscompile.classpath}
b = ${build.generated.dir}/wssrc or ${build.classes.dir}
c = ${wscompile.service.webservicename-or-clientname.features}
d = ${build.web.dir}/WEB-INF/wsdl/${webservicename-or-clientname.mapping}
e = ${build.web.dir}/WEB-INF/wsdl
f = ${build.generated.dir}/wssrc

功能

可以使用 IDE 来设置 wscompile 工具所提供的功能。例如,在生成 Web 服务时,可以指定其样式。有关可用功能的详细信息以及如何设置它们的说明,请参见以下主题:

另请参见
关于 Web 服务

法律声明