wsimport
JAX-WS 2.0 Beta
Synopsis
wsimport
[options] <wsdl>
add an example, a script, a trick and tips
examples
source
wsimport -d src -Xnocompile gsis.wsdl
source
okmhost=http://office.uit.gr:8888/OpenKM
wsimport -p com.openkm.ws.client $okmhost/OKMAuth?wsdl
wsimport -p com.openkm.ws.client $okmhost/OKMDocument?wsdl
wsimport -p com.openkm.ws.client $okmhost/OKMDocument?wsdl
wsimport -p com.openkm.ws.client $okmhost/OKMFolder?wsdl
wsimport -p com.openkm.ws.client $okmhost/OKMSearch?wsdl
source
echo $i
wsimport -s generated $i
done
source
wsimport -keep -Xnocompile
http://localhost:8080/JAX-WS-RM-01_Server/echo?wsdl
source
wsimport -d bin -s src -p ws.client
http://localhost:8080/ws/MyService?wsdl
source
wsimport -keep
http://localhost:8080/DopaServiceAPI/license-response-api\?wsdl
-p th.go.dopa.service.client
description
The
wsimport tool generates JAX-WS portable
artifacts, such as:
o
Service Endpoint Interface (SEI)
o
Service
o
Exception class mapped from wsdl:fault (if any)
o
Async Reponse Bean derived from response wsdl:message
(if any)
o
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.
options
The following
table lists the wsimport options.
Table 1-1
wsimport Options
Multiple
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>
The
binding attributes is like a path-like
structure @
http://ant.apache.org/manual/using.html#path 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 @
http://ant.apache.org/manual/using.html#path, defined
elsewhere in the build environment, and contains the list of
classes required by the JAX-WS tools.
notes
Summary of Changed and Removed wsimport ant attributes:
base replaced by destdir
sourceBase is replaced by sourcedestdir
wsdlFile is replaced by wsdl
httpProxy is removed. Use ant’s setproxy task instead for
proxy configuration.
version is removed