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

 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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 -----------------------------------------------------------------
 * set default formatting
 -----------------------------------------------------------------
 disable hyphenation
 disable justification (adjust text to left margin only)
 -----------------------------------------------------------------
 * MAIN CONTENT STARTS HERE *
 -----------------------------------------------------------------


 NAME 
wsgen - Reads a web service endpoint implementation (SEI) class and generates all of the required artifacts for web service deployment, and invocation.

 SYNOPSIS 
 

wsgen [ options ] SEI

 

 
options
The command-line options. See Options.

 
SEI
The web service endpoint implementation class (SEI) to be read.

 DESCRIPTION 
The \f3wsgen 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 Ant task, see the Tools tab of the JAX-WS (wsgen) page at http://jax-ws.java.net/nonav/2.1.1/docs/wsgenant.html


To start the \f3wsgen command, do the following:

 
\f3export JAXWS_HOME=/pathto/jaxws-ri

 

 
\f3$JAXWS_HOME/bin/wsgen.sh -help

 

 
\f3

 

 OPTIONS 

-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".

 EXAMPLES 
The following example generates the wrapper classes for \f3StockService with \f3@WebService annotations inside stock directory.

 
\f3wsgen -d stock -cp myclasspath stock.StockService

 

 
\f3

 
The 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

 

 
\f3

 
The following example generates a SOAP 1.2 WSDL.

 
\f3wsgen -wsdl:Xsoap1.2 -d stock -cp myclasspath stock.StockService 

 

 
\f3

 
Note: 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.

 SEE ALSO 
 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