JAX-WS RI 2.2.3 | Users Guide | Tools | JAX-WS RI Extensions | Samples | JAX-WS Community |
The
wsimport
tool
generates JAX-WS portable artifacts, such as:
These artifacts can be packaged in a WAR file with the WSDL and
schema documents along with the endpoint implementation to be deployed. JAX-WS RI 2.2.5 also provides wsimport
ant task, see
Wsimport ant
task.
2. Launching wsimport
To run on JDK 6 follow these
instructions.
4. Syntax
wsimport [options] <wsdl>
The following table lists the
wsimport
options.
Option |
Description |
---|---|
|
Specify where to place generated output files |
|
Specify external JAX-WS or JAXB binding files or additional schema files (Each
|
-B <jaxbOption> | Pass this option to JAXB schema compiler |
-catalog
|
Specify catalog file to resolve external entity references, it supports TR9401, XCatalog, and OASIS XML Catalog format. Please read the documentation of catalog and see catalog sample. |
|
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 |
|
Display help |
|
Specify an HTTP proxy server (port defaults to 8080) |
|
Keep generated source code files. It is enabled when -s option. |
-p <pkg>
|
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 |
|
Specify where to place generated source code files. keep is turned on with this option |
|
Output messages about what the compiler is doing |
|
Print version information |
|
Creates the jar file of the generated artifacts along with the WSDL metadata required for invoking the web service. |
-wsdllocation
<location>
|
@WebServiceClient.wsdlLocation value
|
-target <version>
|
Generate code as per the given JAX-WS specification version. For example, "-target 2.0" generates compliant code for JAX-WS 2.0 spec. Default value is 2.2 |
-quiet
|
Suppress wsimport output |
-XadditionalHeaders
|
Map the headers not bound to request or response message to Java method parameters |
-Xauthfile
|
file to carry authorization information in the format http://username:password@example.org/stock?wsdl. Default value is $HOME/.metro/auth |
-Xdebug
|
Print debug information |
-Xno-addressing-databinding
|
Enable binding of W3C EndpointReferenceType to Java |
-Xnocompile
|
Do not compile generated Java files |
-XdisableSSLHostnameVerification
|
Disbales the SSL Hostname verification while fetching the wsdls. |
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.
5. Example
wsimport -p stockquote http://stockquote.xyz/quote?wsdl
This will generate the Java artifacts and compile them by importing the
http://stockquote.xyz/quote?wsdl.