Java TM API for XML Web Services


Specification Version: 2.1
Implementation Version: 2.1.5


  1. 1. Overview
    1. 2. Launching wsimport
      1. 3. Running on JDK 6
        1. 4. Syntax
          1. 5. Example

            1. Overview

            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.1.5 also provides wsimport ant task, see Wsimport ant task.

            2. Launching wsimport

            3. Running on JDK 6

            To run on JDK 6 follow these instructions.

            4. Syntax

            wsimport [options] <wsdl>

            The following table lists the wsimport options.



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


            Output messages about what the compiler is doing


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

            This will generate the Java artifacts and compile them by importing the