286N/A." Copyright 2005-2006 Sun Microsystems, Inc. All Rights Reserved.
286N/A." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
286N/A." This code is free software; you can redistribute it
and/or modify it
286N/A." under the terms of the GNU General Public License version 2 only, as
286N/A." published by the Free Software Foundation.
286N/A." This code is distributed in the hope that it will be useful, but WITHOUT
286N/A." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
286N/A." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
286N/A." version 2 for more details (a copy is included in the LICENSE file that
286N/A." accompanied this code).
286N/A." You should have received a copy of the GNU General Public License version
286N/A." 2 along with this work; if not, write to the Free Software Foundation,
286N/A." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
286N/A." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
286N/A.TH wsgen 1 "07 Aug 2006"
286N/A." Generated by html2man
286N/Awsgen \- JAX\-WS 2.0 Beta
286N/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.
286N/AThe following table lists the \f2wsgen\fP options.
286N/ATable 1\-1 wsgen Options
286N/A.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
286N/A.if \(ts\n(.z\(ts\(ts .ds #d nl
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/ASpecify where to find input class files
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/ASame as \f2\-classpath <path>\fP
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/ASpecify where to place generated output files
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/Aallow 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
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/AUsed only in conjunction with the \-wsdl option. Specify where to place generated resource files such as WSDLs
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/ASpecify where to place generated source files
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/AOutput messages about what the compiler is doing
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/APrint version information. Use of this option will ONLY print version information. Normal processing will not occur.
286N/A.if \n(.l<\n(80 .ll \n(80u
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/ABy 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.
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/AUsed 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
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/AUsed 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
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.nr 38 \w\f2\-classpath <path>\fP
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.nr 38 \w\f2\-cp <path>\fP
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.nr 38 \w\f2\-d <directory>\fP
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.nr 38 \w\f2\-extension\fP
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.nr 38 \w\f2\-r <directory>\fP
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.nr 38 \w\f2\-s <directory>\fP
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.nr 38 \w\f2\-verbose\fP
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.nr 38 \w\f2\-version\fP
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.nr 38 \w\f2\-servicename <name>\fP
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.nr 38 \w\f2\-portname <name>\fP
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.nr 38 \w\f3Description\fP
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.nr 38 \wKeep generated files
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if t .if \n(TW>\n(.li .tm Table at line 100 file Input is too wide - \n(TW units
286N/A.if \(ts\n(.z\(ts\(ts .ds #d nl
286N/A\&\h'|\n(40u'\f3Option\fP\h'|\n(41u'\f3Description\fP
286N/A.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
286N/A\&\h'|\n(40u'\f2\-classpath <path>\fP\h'|\n(41u'
286N/A.if \n(32>\n(31 .nr 31 \n(32
286N/A.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
286N/A\&\h'|\n(40u'\f2\-cp <path>\fP\h'|\n(41u'
286N/A.if \n(32>\n(31 .nr 31 \n(32
286N/A.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
286N/A\&\h'|\n(40u'\f2\-d <directory>\fP\h'|\n(41u'
286N/A.if \n(32>\n(31 .nr 31 \n(32
286N/A.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
286N/A\&\h'|\n(40u'\f2\-extension\fP\h'|\n(41u'
286N/A.if \n(32>\n(31 .nr 31 \n(32
286N/A\&\h'|\n(40u'\f2\-help\fP\h'|\n(41u'Display help
286N/A\&\h'|\n(40u'\f2\-keep\fP\h'|\n(41u'Keep generated files
286N/A.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
559N/A\&\h'|\n(40u'\f2\-r <directory>\fP\h'|\n(41u'
286N/A.if \n(32>\n(31 .nr 31 \n(32
286N/A.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
286N/A\&\h'|\n(40u'\f2\-s <directory>\fP\h'|\n(41u'
286N/A.if \n(32>\n(31 .nr 31 \n(32
286N/A.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
286N/A\&\h'|\n(40u'\f2\-verbose\fP\h'|\n(41u'
286N/A.if \n(32>\n(31 .nr 31 \n(32
286N/A.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
286N/A\&\h'|\n(40u'\f2\-version\fP\h'|\n(41u'
286N/A.if \n(32>\n(31 .nr 31 \n(32
286N/A.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
286N/A.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
286N/A\&\h'|\n(40u'\h'|\n(41u'
286N/A.if \n(32>\n(31 .nr 31 \n(32
286N/A.if \n(32>\n(31 .nr 31 \n(32
286N/A.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
286N/A\&\h'|\n(40u'\f2\-servicename <name>\fP\h'|\n(41u'
286N/A.if \n(32>\n(31 .nr 31 \n(32
286N/A.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
286N/A\&\h'|\n(40u'\f2\-portname <name>\fP\h'|\n(41u'
286N/A.if \n(32>\n(31 .nr 31 \n(32
286N/A.if \n-(b.=0 .nr c. \n(.c-\n(d.-57
286N/AAn Ant task for the \f2wsgen\fP tool is provided along with the tool. The attributes and elements supported by the Ant task are listed below:
286N/A destdir="directory for generated class files"
286N/A classpath="classpath" | cp="classpath"
286N/A resourcedestdir="directory for generated resource files such as WSDLs"
286N/A sourcedestdir="directory for generated source files"
286N/A protocol="soap1.1|Xsoap1.2"
286N/A <classpath refid="..."/>
286N/A.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
286N/A.if \(ts\n(.z\(ts\(ts .ds #d nl
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/AName of the service endpoint implementation class
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/ASpecify where to place output generated classes
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/ASpecify where to find input class files
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/AUsed only in conjunction with the \-wsdl option. Specify where to place generated resource files such as WSDLs
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/ASpecify where to place generated source files
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/AOutput messages about what the compiler is doing
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/ASpecify that a WSDL file should be generated
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/AUsed in conjunction with \f2genwsdl\fP to specify the protocol to use in the \f2wsdl:binding\fP.\ Value values are \f2"soap1.1"\fP or \f2"Xsoap1.2"\fP, default is \f2"soap1.1".\fP\f2"Xsoap1.2"\fP is not standard and can only be used in conjunction with the \-extensions option
286N/A.if \n(.l<\n(82 .ll \n(82u
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/AUsed in conjunction with the genwsdl option. Used to specify a particular \f2wsdl:service\fP name for the generated
WSDL.Example, \f2servicename="{
http://mynamespace/}MyService"\fP
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/AUsed in conjunction with the genwsdl option. Used to specify a particular \f2wsdl:portmame\fP name for the generated WSDL. Example, \f2portname="{
http://mynamespace/}MyPort"\fP
286N/A.if \n(.l<\n(81 .ll \n(81u
286N/Aallow vendor extentions (funcionality not specified by the specification). Use of extensions may result in applications that are not portable or may not interoperate with other implementations
286N/A.nr 38 \w\f3Attribute\fP
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.nr 38 \w\f2classpath\fP
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.nr 38 \w\f2resourcedestdir\fP
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.nr 38 \w\f2sourcedestdir\fP
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.nr 38 \w\f2servicename\fP
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.nr 38 \w\f2extension\fP
286N/A.if \n(80<\n(38 .nr 80 \n(38
286N/A.nr 38 \w\f3Description\fP
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.nr 38 \wSame as \f2\-classpath\fP
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.nr 38 \wKeep generated files
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.if \n(81<\n(38 .nr 81 \n(38
286N/A.nr 38 \w\f3Command line\fP
286N/A.if \n(82<\n(38 .nr 82 \n(38
286N/A.if \n(82<\n(38 .nr 82 \n(38
286N/A.if \n(82<\n(38 .nr 82 \n(38
286N/A.nr 38 \w\f2\-classpath\fP
286N/A.if \n(82<\n(38 .nr 82 \n(38
286N/A.if \n(82<\n(38 .nr 82 \n(38
286N/A.if \n(82<\n(38 .nr 82 \n(38
286N/A.if \n(82<\n(38 .nr 82 \n(38
.if \n(82<\n(38 .nr 82 \n(38
.if \n(82<\n(38 .nr 82 \n(38
.if \n(82<\n(38 .nr 82 \n(38
.nr 38 \w\f2\-servicename\fP
.if \n(82<\n(38 .nr 82 \n(38
.nr 38 \w\f2\-servicename\fP
.if \n(82<\n(38 .nr 82 \n(38
.nr 38 \w\f2\-extension\fP
.if \n(82<\n(38 .nr 82 \n(38
.if \n(82<\n(38 .nr 82 \n(38
.if t .if \n(TW>\n(.li .tm Table at line 217 file Input is too wide - \n(TW units
.if \(ts\n(.z\(ts\(ts .ds #d nl
\&\h'|\n(40u'\f3Attribute\fP\h'|\n(41u'\f3Description\fP\h'|\n(42u'\f3Command line\fP
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f2sei\fP\h'|\n(41u'\h'|\n(42u'SEI
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f2destdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-d\fP
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f2classpath\fP\h'|\n(41u'\h'|\n(42u'\f2\-classpath\fP
.if \n(32>\n(31 .nr 31 \n(32
\&\h'|\n(40u'\f2cp\fP\h'|\n(41u'Same as \f2\-classpath\fP\h'|\n(42u'\f2\-cp\fP
.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f2resourcedestdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-r\fP
.if \n(32>\n(31 .nr 31 \n(32
.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f2sourcedestdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-s\fP
.if \n(32>\n(31 .nr 31 \n(32
\&\h'|\n(40u'\f2keep\fP\h'|\n(41u'Keep generated files\h'|\n(42u'\f2\-keep\fP
.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\f2verbose\fP\h'|\n(41u'\h'|\n(42u'\f2\-verbose\fP
.if \n(32>\n(31 .nr 31 \n(32
\&\h'|\n(40u'\f2genwsdl\fP\h'|\n(41u'\h'|\n(42u'
.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-wsdl\fP
.if \n(32>\n(31 .nr 31 \n(32
\&\h'|\n(40u'\f2protocol\fP\h'|\n(41u'\h'|\n(42u'
.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
.if \n(32>\n(31 .nr 31 \n(32
.if \n(32>\n(31 .nr 31 \n(32
\&\h'|\n(40u'\f2servicename\fP\h'|\n(41u'\h'|\n(42u'
.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-servicename\fP
.if \n(32>\n(31 .nr 31 \n(32
\&\h'|\n(40u'\f2portname\fP\h'|\n(41u'\h'|\n(42u'
.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-servicename\fP
.if \n(32>\n(31 .nr 31 \n(32
\&\h'|\n(40u'\f2extension\fP\h'|\n(41u'\h'|\n(42u'
.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-extension\fP
.if \n(32>\n(31 .nr 31 \n(32
.if \n-(b.=0 .nr c. \n(.c-\n(d.-68
The \f2classpath\fP attribute is a
\f2path\-like structure\fP @
http://ant.apache.org/manual/using.html#path and can also be set via nested \f2<classpath>\fP elements. Before this task can be used, a \f2<taskdef>\fP element needs to be added to the project as given below:
\f2path\-like structure\fP @