--- old/src/solaris/doc/sun/man/man1/wsimport.1 2018-02-07 17:18:21.000000000 -0500 +++ /dev/null 2018-02-07 17:18:21.000000000 -0500 @@ -1,216 +0,0 @@ -'\" 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