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
* 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 *
-----------------------------------------------------------------
wsgen [ options ] SEI
options The command-line options. See Options.
SEI The web service endpoint implementation class (SEI) to be read.
To start the \f3wsgen command, do the following:
\f3export JAXWS_HOME=/pathto/jaxws-ri
\f3$JAXWS_HOME/bin/wsgen.sh -help
\f3
-classpath path
The location of the input class files.
-cp path
The location of the input class files.
-d directory
The location for where to place generated output files.
-extension
Allow 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 about the \f3wsgen command.
-keep
Keeps the generated files.
-r directory
Uses this option with the \f3-wsdl option to specify where to place generated resource files such as WSDLs.
-s directory
The location for where to place generated source files.
-verbose
Displays compiler messages.
-version
Prints release information.
-wsdl [ :protocol ]
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 command does not generate a WSDL file. The \f3protocol value is optional and is used to specify what protocol should be used for the WSDL binding (\f3wsdl:binding). Valid protocols are \f3soap1.1 and \f3Xsoap1.2. The default is \f3soap1.1. The \f3Xsoap1.2 protocol is not standard and can only be used with the \f3-extension option.
-servicename name
Used only with the \f3-wsdl option to specify a particular WSDL service (\f3wsdl:service) name to be generated in the WSDL, for example: \f3-servicename "{http://mynamespace/}MyService".
-portname name
Used only with the \f3-wsdl option to specify a particular WSDL port (\f3wsdl:port) name to be generated in the WSDL, for example: \f3-portname "{http://mynamespace/}MyPort".
\f3wsgen -d stock -cp myclasspath stock.StockService
\f3The following example generates a SOAP 1.1 WSDL and schema for the \f3stock.StockService class with \f3@WebService annotations.
\f3wsgen -wsdl -d stock -cp myclasspath stock.StockService
\f3The following example generates a SOAP 1.2 WSDL.
\f3wsgen -wsdl:Xsoap1.2 -d stock -cp myclasspath stock.StockService
\f3Note: 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.
0.2i wsimport(1)
0.2i The Tools tab of the JAX-WS (wsgen) page http://jax-ws.java.net/nonav/2.1.1/docs/wsgenant.html
'pl 8.5i 'bp