'\" 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+
−
.\"+
−
.if n .pl 99999+
−
.TH wsimport 1 "21 November 2013" "JDK 8" "Java Web Services Tools"+
−
.\" -----------------------------------------------------------------+
−
.\" * Define some portability stuff+
−
.\" -----------------------------------------------------------------+
−
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+
−
.\" http://bugs.debian.org/507673+
−
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html+
−
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+
−
.ie \n(.g .ds Aq \(aq+
−
.el       .ds Aq '+
−
.\" -----------------------------------------------------------------+
−
.\" * set default formatting+
−
.\" -----------------------------------------------------------------+
−
.\" disable hyphenation+
−
.nh+
−
.\" disable justification (adjust text to left margin only)+
−
.ad l+
−
.\" -----------------------------------------------------------------+
−
.\" * MAIN CONTENT STARTS HERE *+
−
.\" -----------------------------------------------------------------+
−
+
−
.SH NAME    +
−
wsimport \- Generates JAX-WS portable artifacts that can be packaged in a web application archive (WAR) file and provides an Ant task\&.+
−
.SH SYNOPSIS    +
−
.sp     +
−
.nf     +
−
+
−
\fBwsimport\fR [ \fIoptions\fR ] \fIwsdl\fR+
−
.fi     +
−
.sp     +
−
.TP     +
−
\fIoptions\fR+
−
The command-line options\&. See Options\&.+
−
.TP     +
−
\fIwsdl\fR+
−
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\&.+
−
.SH DESCRIPTION    +
−
The \f3wsimport\fR 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\fR command also provides a \f3wsimport\fR 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+
−
.TP 0.2i    +
−
\(bu+
−
Service Endpoint Interface (SEI)+
−
.TP 0.2i    +
−
\(bu+
−
Service+
−
.TP 0.2i    +
−
\(bu+
−
Exception class is mapped from \f3wsdl:fault\fR (if any)+
−
.TP 0.2i    +
−
\(bu+
−
Async Response Bean is derived from response \f3wsdl:message\fR (if any)+
−
.TP 0.2i    +
−
\(bu+
−
JAXB generated value types (mapped java classes from schema types)+
−
.PP+
−
To start the \f3wsgen\fR command, do the following:+
−
.PP+
−
\fIOracle Solaris/Linux\fR:+
−
.sp     +
−
.nf     +
−
\f3/bin/wsimport\&.sh \-help\fP+
−
.fi     +
−
.nf     +
−
\f3\fP+
−
.fi     +
−
.sp     +
−
\fIWindows\fR:+
−
.sp     +
−
.nf     +
−
\f3\ebin\ewsimport\&.bat \-help\fP+
−
.fi     +
−
.nf     +
−
\f3\fP+
−
.fi     +
−
.sp     +
−
.SH OPTIONS    +
−
.TP+
−
-d \fIdirectory\fR+
−
.br+
−
Specifies where to place generated output files\&.+
−
.TP+
−
-b \fIpath\fR+
−
.br+
−
Specifies external JAX-WS or JAXB binding files\&. Multiple JAX-WS and JAXB binding files can be specified with the \f3-b\fR 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 \fIUsers Guide\fR tab of WSDL Customization at http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsimportant\&.html+
−
.TP+
−
-B \fIjaxbOption\fR+
−
.br+
−
Passes the \f3jaxbOption\fR option to the JAXB schema compiler\&.+
−
.TP+
−
-catalog+
−
.br+
−
Specifies a catalog file to resolve external entity references\&. The \f3-catalog\fR option supports the TR9401, XCatalog, and OASIS XML Catalog formats\&. See the \fIUsers Guide\fR tab of the Catalog Support page at http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/catalog-support\&.html+
−
.TP+
−
-extension+
−
.br+
−
Allows vendor extensions\&. Use of extensions can result in applications that are not portable or that do not work with other implementations\&.+
−
.TP+
−
-help+
−
.br+
−
Displays a help message for the \f3wsimport\fR command\&.+
−
.TP+
−
-httpproxy: \fIhost\fR:\fIport\fR+
−
.br+
−
Specifies an HTTP proxy server\&. The default is 8080\&.+
−
.TP+
−
-keep+
−
.br+
−
Keeps generated files\&.+
−
.TP+
−
-p \fIname\fR+
−
.br+
−
Specifies a target package \fIname\fR to override the WSDL and schema binding customizations, and the default algorithm defined in the specification\&.+
−
.TP+
−
-s \fIdirectory\fR+
−
.br+
−
Specifies where to place generated source files\&.+
−
.TP+
−
-verbose+
−
.br+
−
Displays compiler messages\&.+
−
.TP+
−
-version+
−
.br+
−
Prints release information\&.+
−
.TP+
−
-wsdllocation \fIlocation\fR+
−
.br+
−
Specifies the \f3@WebServiceClient\&.wsdlLocation\fR value\&.+
−
.TP+
−
-target+
−
.br+
−
Generates code according to the specified JAX-WS specification version\&. Version 2\&.0 generates compliant code for the JAX-WS 2\&.0 specification\&.+
−
.TP+
−
-quiet+
−
.br+
−
Suppresses the \f3wsimport\fR command output\&.+
−
.PP+
−
Multiple \f3JAX-WS\fR and \f3JAXB\fR binding files can be specified using the \f3-b\fR option, and they can be used to customize various things such as package names and bean names\&. More information about \f3JAX-WS\fR and \f3JAXB\fR binding files can be found in the customization documentation at https://jax-ws\&.dev\&.java\&.net/nonav/2\&.1\&.1/docs/customizations\&.html+
−
.SH NONSTANDARD\ OPTIONS    +
−
.TP+
−
-XadditionalHeaders+
−
.br+
−
Maps headers not bound to a request or response message to Java method parameters\&.+
−
.TP+
−
-Xauthfile \fIfile\fR+
−
.br+
−
The WSDL URI that specifies the file that contains authorization information\&. This URI is in the following format:+
−
+
−
http://\fIuser-name\fR:\f3password\fR@\fIhost-name\fR/\fIweb-service-name\fR>?wsdl\&.+
−
.TP+
−
-Xdebug+
−
.br+
−
Prints debugging information\&.+
−
.TP+
−
-Xno-addressing-databinding+
−
.br+
−
Enables binding of W3C EndpointReferenceType to Java\&.+
−
.TP+
−
-Xnocompile+
−
.br+
−
Does not compile the generated Java files\&.+
−
.SH EXAMPLE    +
−
The following example generates the Java artifacts and compiles the artifacts by importing \f3http://stockquote\&.example\&.com/quote?wsdl\fR+
−
.sp     +
−
.nf     +
−
\f3wsimport \-p stockquote http://stockquote\&.example\&.com/quote?wsdl\fP+
−
.fi     +
−
.nf     +
−
\f3\fP+
−
.fi     +
−
.sp     +
−
.SH SEE\ ALSO    +
−
.TP 0.2i    +
−
\(bu+
−
wsgen(1)+
−
.TP 0.2i    +
−
\(bu+
−
The Tools tab of Wsimport Ant Task page http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsimportant\&.html+
−
.TP 0.2i    +
−
\(bu+
−
The \fIUsers Guide\fR tab of Catalog Support page http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/catalog-support\&.html+
−
.TP 0.2i    +
−
\(bu+
−
The \fIUsers Guide\fR tab of WSDL Customization page http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsimportant\&.html+
−
.RE+
−
.br+
−
'pl 8.5i+
−
'bp+
−