wsimport - Java™ API for XML Web Services (JAX-WS) 2.0

Specification Version: 2.1
Implementation Version: 2.1.1



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

Launching wsimport


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

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
Generate code as per the given JAX-WS specification version. version 2.0 will generate compliant code for JAX-WS 2.0 spec.
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.

The following table lists wsimport non-standard options:




Map headers not bound to request or response message to Java method parameters.

-Xauthfile <file>

WSDL URI that specifies the file that contains authorization information; this URI is in the following format:

http://<user name>:<password>@<host name>/<Web service name>?wsdl

Print debugging information.


Enable binding of W3C EndpointReferenceType to Java.


Do not compile generated Java files.


wsimport -p stockquote

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

Copyright © 1993, 2020, Oracle and/or its affiliates. All rights reserved.