4169N/A." Copyright (c) 2005, 2011, Oracle
and/or its affiliates. All rights reserved.
1178N/A." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
1178N/A." This code is free software; you can redistribute it
and/or modify it
1178N/A." under the terms of the GNU General Public License version 2 only, as
1178N/A." published by the Free Software Foundation.
1178N/A." This code is distributed in the hope that it will be useful, but WITHOUT
1178N/A." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
1178N/A." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
1178N/A." version 2 for more details (a copy is included in the LICENSE file that
1178N/A." You should have received a copy of the GNU General Public License version
1178N/A." 2 along with this work; if not, write to the Free Software Foundation,
1178N/A." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
2362N/A." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
4935N/A.TH wsimport 1 "16 Mar 2012"
1178N/Awsimport \- Java(TM) API for XML Web Services (JAX\-WS) 2.0
4935N/A\f3Specification Version:\fP 2.1
0N/A\f3Implementation Version:\fP 2.1.1
1178N/AThe \f2wsimport\fP tool generates JAX\-WS portable artifacts, such as:
1178N/AService Endpoint Interface (SEI)
1178N/AException class mapped from wsdl:fault (if any)
1178N/AAsync Reponse Bean derived from response wsdl:message (if any)
0N/AJAXB generated value types (mapped java classes from schema types)
0N/AThese 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
1178N/AThe following table lists the \f2wsimport\fP options.
0N/A.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
0N/A.if \(ts\n(.z\(ts\(ts .ds #d nl
0N/A.if \n(.l<\n(81 .ll \n(81u
4033N/ASpecify where to place generated output files
4935N/ASpecify external JAX\-WS or JAXB binding files (Each \f2<file>\fP must have its own \f2\-b\fP)
0N/APass this option to JAXB schema compiler
1178N/ASpecify catalog file to resolve external entity references, it supports TR9401, XCatalog, and OASIS XML Catalog format. Please read the documentation of
0N/AAllow 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
0N/A.if \n(.l<\n(80 .ll \n(80u
4935N/A\f3\-httpproxy:<host>:<port> \fP
0N/A.if \n(.l<\n(81 .ll \n(81u
0N/ASpecify an HTTP proxy server (port defaults to 8080)
4033N/ASpecifying 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
0N/A.if \n(.l<\n(81 .ll \n(81u
0N/ASpecify where to place generated source files
0N/A.if \n(.l<\n(81 .ll \n(81u
0N/AOutput messages about what the compiler is doing
0N/APrint version information
0N/A.if \n(.l<\n(80 .ll \n(80u
4033N/A\f3\-wsdllocation <location>\fP
0N/A\f2@WebServiceClient.wsdlLocation\fP value
1178N/AGenerate code as per the given JAX\-WS specification version. version 2.0 will generate compliant code for JAX\-WS 2.0 spec.
0N/A.nr 38 \w\f3Option\fP
1178N/A.if \n(80<\n(38 .nr 80 \n(38
4935N/A.nr 38 \w\f3\-d <directory> \fP
0N/A.if \n(80<\n(38 .nr 80 \n(38
4935N/A.if \n(80<\n(38 .nr 80 \n(38
1178N/A.nr 38 \w\f3\-B <jaxbOption>\fP
1178N/A.if \n(80<\n(38 .nr 80 \n(38
0N/A.if \n(80<\n(38 .nr 80 \n(38
0N/A.nr 38 \w\f3\-extension \fP
0N/A.if \n(80<\n(38 .nr 80 \n(38
0N/A.if \n(80<\n(38 .nr 80 \n(38
0N/A.nr 38 \w\f3\-keep \fP
4935N/A.if \n(80<\n(38 .nr 80 \n(38
0N/A.if \n(80<\n(38 .nr 80 \n(38
4935N/A.nr 38 \w\f3\-s <directory> \fP
0N/A.if \n(80<\n(38 .nr 80 \n(38
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f3\-version \fP
.if \n(80<\n(38 .nr 80 \n(38
.if \n(80<\n(38 .nr 80 \n(38
.if \n(80<\n(38 .nr 80 \n(38
.if \n(80<\n(38 .nr 80 \n(38
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f3Description\fP
.if \n(81<\n(38 .nr 81 \n(38
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \wKeep generated files
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \wSuppress wsimport output
.if \n(81<\n(38 .nr 81 \n(38
.if \n(81<\n(38 .nr 81 \n(38
.if \n(81<\n(38 .nr 81 \n(38
.if \n(81<\n(38 .nr 81 \n(38
.if \n(81<\n(38 .nr 81 \n(38
.if \n(81<\n(38 .nr 81 \n(38
.if \n(81<\n(38 .nr 81 \n(38
.if \n(81<\n(38 .nr 81 \n(38
.if \n(81<\n(38 .nr 81 \n(38
.if \n(81<\n(38 .nr 81 \n(38
.if \n(81<\n(38 .nr 81 \n(38
.if \n(81<\n(38 .nr 81 \n(38
.if \n(81<\n(38 .nr 81 \n(38
.if t .if \n(TW>\n(.li .tm Table at line 157 file Input is too wide - \n(TW units
.if \(ts\n(.z\(ts\(ts .ds #d nl
\&\h'|\n(40u'\f3Option\fP\h'|\n(41u'\f3Description\fP
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f3\-d <directory> \fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f3\-b <path> \fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f3\-B <jaxbOption>\fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f3\-catalog\fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f3\-extension \fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
\&\h'|\n(40u'\f3\-help \fP\h'|\n(41u'Display help
.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
.if \n(32>\n(31 .nr 31 \n(32
.if \n(32>\n(31 .nr 31 \n(32
\&\h'|\n(40u'\f3\-keep \fP\h'|\n(41u'Keep generated files
.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f3\-p \fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f3\-s <directory> \fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f3\-verbose \fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f3\-version \fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
.if \n(32>\n(31 .nr 31 \n(32
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(n|+\n(#^-1v)>\n(#- .nr #- +(\n(n|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f3\-target \fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
\&\h'|\n(40u'\f3\-quiet \fP\h'|\n(41u'Suppress wsimport output
.if \n-(b.=0 .nr c. \n(.c-\n(d.-66
Multiple JAX\-WS and JAXB binding files can be specified using \f2\-b\fP 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
\f2customization documentation\fP @
The following table lists \f2wsimport\fP non\-standard options:
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
.if \(ts\n(.z\(ts\(ts .ds #d nl
.if \n(.l<\n(81 .ll \n(81u
Map headers not bound to request or response message to Java method parameters.
.if \n(.l<\n(81 .ll \n(81u
WSDL URI that specifies the file that contains authorization information; this URI is in the following format:
http://\f2<user name>\fP:\f2<password>\fP@\f2<host name>\fP/\f2<Web service name>\fP?wsdl
.if \n(.l<\n(81 .ll \n(81u
Print debugging information.
.if \n(.l<\n(80 .ll \n(80u
\f3\-Xno\-addressing\-databinding\fP
.if \n(.l<\n(81 .ll \n(81u
Enable binding of W3C \f2EndpointReferenceType\fP to Java.
.if \n(.l<\n(81 .ll \n(81u
Do not compile generated Java files.
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f3\-XadditionalHeaders\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f3\-Xauthfile <file>\fP
.if \n(80<\n(38 .nr 80 \n(38
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f3\-Xnocompile\fP
.if \n(80<\n(38 .nr 80 \n(38
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f3Description\fP
.if \n(81<\n(38 .nr 81 \n(38
.if \n(81<\n(38 .nr 81 \n(38
.if \n(81<\n(38 .nr 81 \n(38
.if \n(81<\n(38 .nr 81 \n(38
.if \n(81<\n(38 .nr 81 \n(38
.if \n(81<\n(38 .nr 81 \n(38
.if t .if \n(TW>\n(.li .tm Table at line 193 file Input is too wide - \n(TW units
.if \(ts\n(.z\(ts\(ts .ds #d nl
\&\h'|\n(40u'\f3Option\fP\h'|\n(41u'\f3Description\fP
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f3\-XadditionalHeaders\fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f3\-Xauthfile <file>\fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f3\-Xdebug\fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
.if \n(32>\n(31 .nr 31 \n(32
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f3\-Xnocompile\fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
.if \n-(b.=0 .nr c. \n(.c-\n(d.-26