Java TM API for XML Web Services

Specification Version: 2.1
Implementation Version: 2.1.2


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

            The wsimport tool generates JAX-WS portable artifacts, such as:

            • Service Endpoint Interface (SEI)
            • Service
            • Exception class mapped from wsdl:fault (if any)
            • Async Reponse Bean derived from response wsdl:message (if any)
            • 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. JAX-WS RI 2.1.2 also provides wsimport ant task, see Wsimport ant task.

            2. Launching wsimport

            • Solaris/Linux
              • JAXWS_HOME/bin/ -help
            • Windows
              • JAXWS_HOME\bin\wsimport.bat -help

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

            -s <directory>

            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 JAX-WS specification version. version 2.0 will generate compliant code for JAX-WS 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

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

            Terms of Use; Privacy Policy; Copyright ©2013-2015 (revision 20151030.c1dd42a)
            Please Confirm