Java TM API for XML Web Services
(JAX-WS)

wsimport

Specification Version: 2.1
Implementation Version: 2.1.2 M1

Contents

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

            Option

            Description

            -d <directory>

            Specify where to place generated output files

            -b <path>

            Specify external JAX-WS or JAXB binding 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 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

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