wsimport
来源:互联网 发布:最新手机看电视软件 编辑:程序博客网 时间:2024/05/16 15:52
Last Modified: 12/14/05
wsimport
The wsimport
tool generates JAX-WS portable artifacts, such as:
- Service Endpoint Interface (SEI)
- Service
- Exception class mapped from wsdl:fault (if any)
- Async Reponse Bean derived from response wsdl:message (if any)
- JAXB generated value types (mapped java classes from schema types)
These artifacts can be packaged in a WAR file with the WSDL and schema documents along with the endpoint implementation to be deployed.
wsimport tool can be launched using the command line script wsimport.sh (Unix) or wsimport.bat(windows). There is also and ant task to import and compile the wsdl, see the details below.
Command-line
Syntax
wsimport [options] <wsdl>
The following table lists the wsimport
options.
Table 1-1 wsimport Options
Option
Description
-d <directory>
Specify where to place generated output files
-b <path>
Specify external JAX-WS or JAXB binding files (Each <file>
must have its own -b
)
Specify catalog file to resolve external entity references, it supports TR9401, XCatalog, and OASIS XML Catalog format. Please read the XML Entity and URI Resolvers document or see wsimport_catalog sample.
-extension
allow vendor extensions (functionality not specified by the specification). Use of extensions may result in applications that are not portable or may not interoperate with other implementations
-help
Display help
-httpproxy:<host>:<port>
Specify an HTTP proxy server (port defaults to 8080)
-keep
Keep generated files
-p
Specifying a target package via this command-line option, overrides any wsdl and schema binding customization for package name and the default package name algorithm defined in the specification-s <directory>
Specify where to place generated source files
-verbose
Output messages about what the compiler is doing
-version
Print version information
-wsdllocation <location>
@WebService.wsdlLocation
and @WebServiceClient.wsdlLocation
valueMultiple JAX-WS and JAXB binding files can be specified using -b
option and they can be used to customize various things like package names, bean names, etc. More information on JAX-WS and JAXB binding files can be found in the customization documentation.
Ant task
An Ant task for the wsimport
tool is provided along with the tool. The attributes and elements supported by the Ant task are listed below:
<wsimport
wsdl="..."
destdir="directory for generated class files"
sourcedestdir="directory for generated source files"
keep="true|false"
extension="true|false"
verbose="true|false"
version="true|false"
wsdlLocation="..."
catalog="catalog file"
package="package name"
<binding dir="..." includes="..." />
</wsimport>
Attribute
Description
Command line
wsdl
WSDL file
WSDL
destdir
Specify where to place output generated classes
-d
sourcedestdir
Specify where to place generated source files, keep is turned on with this option
-s
keep
Keep generated files, tunred on with sourcedestdir option
-keep
verbose
Output messages about what the compiler is doing
-verbose
binding
Specify external JAX-WS or JAXB binding files
-b
extension
allow vendor extentions (funcionality not specified by the specification). Use of extensions may result in applications that are not portable or may not interoperate with other implementations
-extension
wsdllocation
The wsdl URI passed thru this option will be used to set the value of
@WebService.wsdlLocation
and @WebServiceClient.wsdlLocation
annotation elements on the generated SEI and Service interface-wsdllocation
catalog
Specify catalog file to resolve external entity references, it supports TR9401, XCatalog, and OASIS XML Catalog format. Additionally, ant xmlcatalog type can be used to resolve entities, see wsimport_catalog sample.
-catalog
package
Specifies the target package
-p
The binding
attributes is like a path-like structure and can also be set via nested <binding>
elements, respectively. Before this task can be used, a <taskdef>
element needs to be added to the project as given below:
<taskdef name="wsimport" classname="com.sun.tools.ws.ant.WsImport">
<classpath path="jaxws.classpath"/>
</taskdef>
where jaxws.classpath
is a reference to a path-like structure, defined elsewhere in the build environment, and contains the list of classes required by the JAX-WS tools.
Examples
<wsimport
destdir
="${build.classes.home}"
debug="true"
wsdl="AddNumbers.wsdl"
binding="custom.xml"/>
The above example generates client-side artifacts for AddNumbers.wsdl
, stores .class
files in the ${build.classes.home}
directory using the custom.xml
customization file. The classpath used is xyz.jar
and compiles with debug information on.
<wsimport
keep="true"
sourcedestdir="${source.dir}"
destdir
="${build.classes.home}"
wsdl="AddNumbers.wsdl">
<binding dir="${basedir}/etc" includes="custom.xml"/>
</wsimport>
The above example generates portable artifacts for AddNumbers.wsdl
, stores .java
files in the ${source.dir}
directory, stores .class
files in the ${build.classes.home}
directory.
Summary of Changed and Removed wsimport ant attributes
httpProxy is removed. Use ant's setproxy task instead for proxy configuration.
version is removed
- wsimport
- wsimport
- wsimport tool
- wsimport命令
- wsimport 批处理文件
- WebService-wsimport
- wsgen and wsimport说明
- wsimport的使用
- wsgen wsimport命令
- wsimport命令详细使用
- wsimport,xjc,javah使用
- 天气预报webservice wsimport注意事项
- wsimport的使用
- wsimport 用法详解
- wsimport命令的使用
- wsimport命令讲解
- java wsgen和wsimport
- wsimport的使用
- 用 Windows XP 的两个强有力的工具在您的代码中检测并堵塞 GDI 泄漏
- django的HTTPREQUEST对象
- 加载地址、运行地址
- 他竟用程序求婚成功...
- 基于visual Studio2013解决C语言竞赛题之1071打印工资
- wsimport
- vba 删除、移动、合并数据
- 摄像头设备驱动框架
- 关于Myeclipse启动速度太慢的问题
- MyEclipse6.5的反编译插件的安装
- 用管理员登陆ubuntu
- 浏览器被Ask Toolbar劫持解决办法
- setsockopt()用法(参数详细说明)
- Debugging USER object leak