t
Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation.

This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).

You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.

Arch: generic
Software: JDK 8
Date: 21 November 2013
SectDesc: Java Web Services Tools
Title: wsimport.1

-----------------------------------------------------------------
* Define some portability stuff
-----------------------------------------------------------------
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
http://bugs.debian.org/507673
http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-----------------------------------------------------------------
* set default formatting
-----------------------------------------------------------------
disable hyphenation
disable justification (adjust text to left margin only)
-----------------------------------------------------------------
* MAIN CONTENT STARTS HERE *
-----------------------------------------------------------------
wsimport - Generates JAX-WS portable artifacts that can be packaged in a web application archive (WAR) file and provides an Ant task.

 

wsimport [ options ] wsdl

options The command-line options. See Options.

wsdl The file that contains the machine-readable description of how the web service can be called, what parameters it expects, and what data structures it returns.

The \f3wsimport command generates the following JAX-WS portable artifacts. These artifacts can be packaged in a WAR file with the WSDL and schema documents and the endpoint implementation to be deployed. The \f3wsimport command also provides a \f3wsimport Ant task, see the Tools tab of the Wsimport Ant Task page at http://jax-ws.java.net/nonav/2.1.1/docs/wsimportant.html

0.2i Service Endpoint Interface (SEI)

0.2i Service

0.2i Exception class is mapped from \f3wsdl:fault (if any)

0.2i Async Response Bean is derived from response \f3wsdl:message (if any)

0.2i JAXB generated value types (mapped java classes from schema types)

To start the \f3wsgen command, do the following:

Oracle Solaris/Linux:

 
\f3/bin/wsimport.sh -help

 
\f3

Windows:

 
\f3\ebin\ewsimport.bat -help

 
\f3

-d directory

Specifies where to place generated output files.

-b path

Specifies external JAX-WS or JAXB binding files. Multiple JAX-WS and JAXB binding files can be specified with the \f3-b option. You can use these files to customize package names, bean names, and so on. For more information about JAX-WS and JAXB binding files, see the Users Guide tab of WSDL Customization at http://jax-ws.java.net/nonav/2.1.1/docs/wsimportant.html

-B jaxbOption

Passes the \f3jaxbOption option to the JAXB schema compiler.

-catalog

Specifies a catalog file to resolve external entity references. The \f3-catalog option supports the TR9401, XCatalog, and OASIS XML Catalog formats. See the Users Guide tab of the Catalog Support page at http://jax-ws.java.net/nonav/2.1.1/docs/catalog-support.html

-extension

Allows vendor extensions. Use of extensions can result in applications that are not portable or that do not work with other implementations.

-help

Displays a help message for the \f3wsimport command.

-httpproxy: host:port

Specifies an HTTP proxy server. The default is 8080.

-keep

Keeps generated files.

-p name

Specifies a target package name to override the WSDL and schema binding customizations, and the default algorithm defined in the specification.

-s directory

Specifies where to place generated source files.

-verbose

Displays compiler messages.

-version

Prints release information.

-wsdllocation location

Specifies the \f3@WebServiceClient.wsdlLocation value.

-target

Generates code according to the specified JAX-WS specification version. Version 2.0 generates compliant code for the JAX-WS 2.0 specification.

-quiet

Suppresses the \f3wsimport command output.

Multiple \f3JAX-WS and \f3JAXB binding files can be specified using the \f3-b option, and they can be used to customize various things such as package names and bean names. More information about \f3JAX-WS and \f3JAXB binding files can be found in the customization documentation at https://jax-ws.dev.java.net/nonav/2.1.1/docs/customizations.html

-XadditionalHeaders

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

-Xauthfile file

The WSDL URI that specifies the file that contains authorization information. This URI is in the following format: http://user-name:\f3password@host-name/web-service-name>?wsdl.

-Xdebug

Prints debugging information.

-Xno-addressing-databinding

Enables binding of W3C EndpointReferenceType to Java.

-Xnocompile

Does not compile the generated Java files.

The following example generates the Java artifacts and compiles the artifacts by importing \f3http://stockquote.example.com/quote?wsdl

 
\f3wsimport -p stockquote http://stockquote.example.com/quote?wsdl

 
\f3

0.2i wsgen(1)

0.2i The Tools tab of Wsimport Ant Task page http://jax-ws.java.net/nonav/2.1.1/docs/wsimportant.html

0.2i The Users Guide tab of Catalog Support page http://jax-ws.java.net/nonav/2.1.1/docs/catalog-support.html

0.2i The Users Guide tab of WSDL Customization page http://jax-ws.java.net/nonav/2.1.1/docs/wsimportant.html

'pl 8.5i 'bp