JAX-WS 2.1.1 | Users Guide | Tools | JAXWS RI Extensions | Samples | JAXWS 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 2.1.1 RI 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 (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 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 |
|
Specify where to place generated source files |
|
Output messages about what the compiler is doing |
|
Print version information |
-wsdllocation <location>
|
@WebServiceClient.wsdlLocation value
|
target
|
Generate code as per the given JAXWS specification version. version 2.0 will generate compliant code for JAXWS 2.0 spec. |
quiet
|
Suppress wsimport output |
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.