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. ${PRODUCT_NAME} also provides wsimport ant task, see Wsimport ant task.

To run on JDK 6 follow these instructions.

wsimport [options] <wsdl>

The following table lists the wsimport options.

Option

Description

-d <directory>

Specify where to place generated output files

-b <path>

Specify external JAX-WS or JAXB binding files or additional schema files (Each <file> must have its own -b)

-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.

-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 source code files. It is enabled when -s option.

-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 code files. keep is turned on with this option

-verbose

Output messages about what the compiler is doing

-version

Print version information

-wsdllocation <location>
@WebServiceClient.wsdlLocation value
-target Generate code as per the given JAX-WS specification version. version 2.0 will generate compliant code for JAX-WS 2.0 spec.
-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.

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.