325N/A." Copyright (c) 2005, 2011, Oracle
and/or its affiliates. All rights reserved.
325N/A." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
325N/A." This code is free software; you can redistribute it
and/or modify it
325N/A." under the terms of the GNU General Public License version 2 only, as
325N/A." published by the Free Software Foundation.
325N/A." This code is distributed in the hope that it will be useful, but WITHOUT
325N/A." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
325N/A." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
325N/A." version 2 for more details (a copy is included in the LICENSE file that
325N/A." accompanied this code).
325N/A." You should have received a copy of the GNU General Public License version
325N/A." 2 along with this work; if not, write to the Free Software Foundation,
325N/A." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
325N/A." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
325N/A.TH wsgen 1 "16 Mar 2012"
325N/Awsgen \- Java(TM) API for XML Web Services (JAX\-WS) 2.0
325N/A\f3Specification Version:\fP 2.1
325N/A\f3Implementation Version:\fP 2.1.1
325N/AThe \f2wsgen\fP tool generates JAX\-WS portable artifacts used in JAX\-WS web services. The tool reads a web service endpoint implementation class (SEI) and generates all the required artifacts for web service deployment, and invocation
325N/AThe \f2wsgen\fP tool 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 wsgen ant task, see
325N/A\f2set JAXWS_HOME=c:\\pathto\\jaxws\-ri\fP
The following table lists the \f2wsgen\fP 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
Specify where to find input class files
.if \n(.l<\n(81 .ll \n(81u
Same as \f2\-classpath <path>\fP
.if \n(.l<\n(81 .ll \n(81u
Specify where to place generated output files
.if \n(.l<\n(81 .ll \n(81u
allow 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
.if \n(.l<\n(81 .ll \n(81u
Used only in conjunction with the \-wsdl option. Specify where to place generated resource files such as WSDLs
.if \n(.l<\n(81 .ll \n(81u
Specify where to place generated source files
.if \n(.l<\n(81 .ll \n(81u
Output messages about what the compiler is doing
.if \n(.l<\n(81 .ll \n(81u
Print version information. Use of this option will ONLY print version information. Normal processing will not occur.
.if \n(.l<\n(81 .ll \n(81u
By default \f2wsgen\fP does not generate a WSDL file. This flag is optional and will cause \f2wsgen\fP to generate a WSDL file and is usually only used so that the developer can look at the WSDL before the endpoint is deploy. The \f2protocol\fP is optional and is used to specify what protocol should be used in the \f2wsdl:binding\fP. Valid protocols include: \f2soap1.1\fP and \f2Xsoap1.2\fP. The default is \f2soap1.1\fP. \f2Xsoap1.2\fP is not standard and can only be used in conjunction with the \f2\-extension\fP option.
.if \n(.l<\n(81 .ll \n(81u
Used only in conjunction with the \f2\-wsdl\fP option. Used to specify a particular \f2wsdl:service\fP name to be generated in the WSDL. Example, \f2\-servicename "{
http://mynamespace/}MyService"\fP
.if \n(.l<\n(81 .ll \n(81u
Used only in conjunction with the \f2\-wsdl\fP option. Used to specify a particular \f2wsdl:port\fP name to be generated in the WSDL. Example, \f2\-portname "{
http://mynamespace/}MyPort"\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-classpath <path>\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-cp <path>\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-d <directory>\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-extension\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
.nr 38 \w\f4\-r <directory>\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-s <directory>\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
.nr 38 \w\f4\-wsdl[:protocol]\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-servicename <name>\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-portname <name>\fP
.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
.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 133 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'\f4\-classpath <path>\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'\f4\-cp <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'\f4\-d <directory>\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'\f4\-extension\fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
\&\h'|\n(40u'\f4\-help\fP\h'|\n(41u'Display help
\&\h'|\n(40u'\f4\-keep\fP\h'|\n(41u'Keep generated files
.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f4\-r <directory>\fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f4\-s <directory>\fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f4\-verbose\fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f4\-version\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'\f4\-wsdl[:protocol]\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'\f4\-servicename <name>\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'\f4\-portname <name>\fP\h'|\n(41u'
.if \n(32>\n(31 .nr 31 \n(32
.if \n-(b.=0 .nr c. \n(.c-\n(d.-53
This will generate the wrapper classes needed for StockService annotated with @WebService annotation inside \f3stock\fPdirectory.
This will generate a SOAP 1.1 WSDL and schema for your Java class
stock.StockService annotated with @WebService annotation.
Will generate a SOAP 1.2 WSDL.
Note that you do not have to generate WSDL at the development time as JAXWS runtime will automatically generate a WSDL for you when you deploy your service.