--- old/src/linux/doc/man/wsgen.1 2018-02-07 17:18:10.000000000 -0500 +++ /dev/null 2018-02-07 17:18:10.000000000 -0500 @@ -1,175 +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: wsgen.1 -.\" -.if n .pl 99999 -.TH wsgen 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 -wsgen \- Reads a web service endpoint implementation (SEI) class and generates all of the required artifacts for web service deployment, and invocation\&. -.SH SYNOPSIS -.sp -.nf - -\fBwsgen\fR [ \fIoptions\fR ] \fISEI\fR -.fi -.sp -.TP -\fIoptions\fR -The command-line options\&. See Options\&. -.TP -\fISEI\fR -The web service endpoint implementation class (SEI) to be read\&. -.SH DESCRIPTION -The \f3wsgen\fR command generates JAX-WS portable artifacts used in JAX-WS web services\&. The tool reads a web service endpoint class and generates all the required artifacts for web service deployment and invocation\&. JAXWS 2\&.1\&.1 RI also provides a \f3wsgen\fR Ant task, see the \fITools\fR tab of the JAX-WS (wsgen) page at http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsgenant\&.html -.PP -To start the \f3wsgen\fR command, do the following: -.sp -.nf -\f3export JAXWS_HOME=/pathto/jaxws\-ri\fP -.fi -.nf -\f3$JAXWS_HOME/bin/wsgen\&.sh \-help\fP -.fi -.nf -\f3\fP -.fi -.sp -.SH OPTIONS -.TP --classpath \fIpath\fR -.br -The location of the input class files\&. -.TP --cp \fIpath\fR -.br -The location of the input class files\&. -.TP --d \fIdirectory\fR -.br -The location for where to place generated output files\&. -.TP --extension -.br -Allow 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 about the \f3wsgen\fR command\&. -.TP --keep -.br -Keeps the generated files\&. -.TP --r \fIdirectory\fR -.br -Uses this option with the \f3-wsdl\fR option to specify where to place generated resource files such as WSDLs\&. -.TP --s \fIdirectory\fR -.br -The location for where to place generated source files\&. -.TP --verbose -.br -Displays compiler messages\&. -.TP --version -.br -Prints release information\&. -.TP --wsdl [ :protocol ] \fI\fR -.br -An optional command that generates a WSDL file to review before endpoint deployment\&. The WSDL files contains a machine-readable description of how the service can be called, what parameters it expects, and what data structures it returns\&. - -By default the \f3wsgen\fR command does not generate a WSDL file\&. The \f3protocol\fR value is optional and is used to specify what protocol should be used for the WSDL binding (\f3wsdl:binding\fR)\&. Valid protocols are \f3soap1\&.1\fR and \f3Xsoap1\&.2\fR\&. The default is \f3soap1\&.1\fR\&. The \f3Xsoap1\&.2\fR protocol is not standard and can only be used with the \f3-extension\fR option\&. -.TP --servicename \fIname\fR -.br -Used only with the \f3-wsdl\fR option to specify a particular WSDL service (\f3wsdl:service\fR) name to be generated in the WSDL, for example: \f3-servicename "{http://mynamespace/}MyService"\fR\&. -.TP --portname \fIname\fR -.br -Used only with the \f3-wsdl\fR option to specify a particular WSDL port (\f3wsdl:port\fR) name to be generated in the WSDL, for example: \f3-portname "{http://mynamespace/}MyPort"\fR\&. -.SH EXAMPLES -The following example generates the wrapper classes for \f3StockService\fR with \f3@WebService\fR annotations inside stock directory\&. -.sp -.nf -\f3wsgen \-d stock \-cp myclasspath stock\&.StockService\fP -.fi -.nf -\f3\fP -.fi -.sp -The following example generates a SOAP 1\&.1 WSDL and schema for the \f3stock\&.StockService\fR class with \f3@WebService\fR annotations\&. -.sp -.nf -\f3wsgen \-wsdl \-d stock \-cp myclasspath stock\&.StockService\fP -.fi -.nf -\f3\fP -.fi -.sp -The following example generates a SOAP 1\&.2 WSDL\&. -.sp -.nf -\f3wsgen \-wsdl:Xsoap1\&.2 \-d stock \-cp myclasspath stock\&.StockService \fP -.fi -.nf -\f3\fP -.fi -.sp -\fINote:\fR You do not have to generate WSDL at development time because the JAXWS run time environment generates a WSDL for you when you deploy your service\&. -.SH SEE\ ALSO -.TP 0.2i -\(bu -wsimport(1) -.TP 0.2i -\(bu -\fIThe Tools\fR tab of the JAX-WS (wsgen) page http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsgenant\&.html -.RE -.br -'pl 8.5i -'bp