--- a/jdk/src/linux/doc/man/wsgen.1 Thu Apr 30 15:04:39 2009 -0700
+++ b/jdk/src/linux/doc/man/wsgen.1 Mon May 04 18:28:26 2009 -0700
@@ -1,6 +1,4 @@
-.'" t
-."
-." Copyright 2005-2006 Sun Microsystems, Inc. All Rights Reserved.
+." Copyright 2006 Sun Microsystems, Inc. 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
@@ -21,44 +19,70 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
-." `
-.TH wsgen 1 "07 Aug 2006"
-." Generated by html2man
-
-.LP
-.SH NAME
-wsgen \- JAX\-WS 2.0 Beta
-.LP
+.TH wsgen 1 "04 May 2009"
+." Generated from HTML by html2man (author: Eric Armstrong)
+.SH "Name"
+wsgen \- Java(TM) API for XML Web Services (JAX\-WS) 2.0
.RS 3
.LP
.LP
-The \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.
+\f3Specification Version:\fP 2.1
+.br
+\f3Implementation Version:\fP 2.1.1
+.LP
+.LP
+The \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
.LP
.RE
-.SH "SYNOPSIS"
+.SH "Overview"
+.LP
+The \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
+.na
+\f2Wsgen ant task\fP @
+.fi
+https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsgenant.html for details.
.LP
+.SH "Launching wsgen"
+.RS 3
+.TP 2
+o
+\f3Solaris/Linux\fP
+.RS 3
+.TP 2
+*
+\f2export JAXWS_HOME=/pathto/jaxws\-ri\fP
+.TP 2
+*
+\f2$JAXWS_HOME/bin/wsgen.sh \-help\fP
+.RE
+.TP 2
+o
+\f3Windows\fP
+.RS 3
+.TP 2
+*
+\f2set JAXWS_HOME=c:\\pathto\\jaxws\-ri\fP
+.TP 2
+*
+\f2%JAXWS_HOME%\\bin\\wsgen.bat \-help\fP
+.RE
+.RE
.LP
+.SH "Syntax"
.nf
\f3
.fl
-wsgen [options] <SEI>
+wsgen [options] <SEI>\fP
+.br
+\f3
.fl
\fP
.fi
-
-.LP
-.SH "OPTIONS"
-.LP
.LP
The following table lists the \f2wsgen\fP options.
.br
-
-.LP
-.LP
-Table 1\-1 wsgen Options
-.LP
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
@@ -208,16 +232,15 @@
..
.ec \
.eo
-.am 80
+.am 81
.br
.di i+
.35
.ft \n(.f
.ll \n(34u*1u/3u
-.if \n(.l<\n(80 .ll \n(80u
+.if \n(.l<\n(81 .ll \n(81u
.in 0
-\f2\-wsdl[:protocol]\fP
-.br
+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.
.br
.di
.nr i| \n(dn
@@ -233,8 +256,7 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-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.
-.br
+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
.br
.di
.nr j| \n(dn
@@ -250,64 +272,48 @@
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
-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
+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
+.br
.br
.di
.nr k| \n(dn
.nr k- \n(dl
..
.ec \
-.eo
-.am 81
-.br
-.di l+
-.35
-.ft \n(.f
-.ll \n(34u*1u/3u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-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
-.br
-.br
-.di
-.nr l| \n(dn
-.nr l- \n(dl
-..
-.ec \
.35
.nf
.ll \n(34u
.nr 80 0
.nr 38 \w\f3Option\fP
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2\-classpath <path>\fP
+.nr 38 \w\f4\-classpath <path>\fP
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2\-cp <path>\fP
+.nr 38 \w\f4\-cp <path>\fP
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2\-d <directory>\fP
+.nr 38 \w\f4\-d <directory>\fP
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2\-extension\fP
+.nr 38 \w\f4\-extension\fP
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2\-help\fP
+.nr 38 \w\f4\-help\fP
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2\-keep\fP
+.nr 38 \w\f4\-keep\fP
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2\-r <directory>\fP
+.nr 38 \w\f4\-r <directory>\fP
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2\-s <directory>\fP
+.nr 38 \w\f4\-s <directory>\fP
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2\-verbose\fP
+.nr 38 \w\f4\-verbose\fP
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2\-version\fP
+.nr 38 \w\f4\-version\fP
+.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\f2\-servicename <name>\fP
+.nr 38 \w\f4\-servicename <name>\fP
.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2\-portname <name>\fP
+.nr 38 \w\f4\-portname <name>\fP
.if \n(80<\n(38 .nr 80 \n(38
.80
.rm 80
-.nr 38 \n(i-
-.if \n(80<\n(38 .nr 80 \n(38
.nr 81 0
.nr 38 \w\f3Description\fP
.if \n(81<\n(38 .nr 81 \n(38
@@ -333,12 +339,12 @@
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(h-
.if \n(81<\n(38 .nr 81 \n(38
+.nr 38 \n(i-
+.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(j-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(k-
.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \n(l-
-.if \n(81<\n(38 .nr 81 \n(38
.35
.nf
.ll \n(34u
@@ -349,7 +355,7 @@
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 100 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 140 file Input is too wide - \n(TW units
.fc
.nr #T 0-1
.nr #a 0-1
@@ -372,7 +378,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f2\-classpath <path>\fP\h'|\n(41u'
+\&\h'|\n(40u'\f4\-classpath <path>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -388,7 +394,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f2\-cp <path>\fP\h'|\n(41u'
+\&\h'|\n(40u'\f4\-cp <path>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -404,7 +410,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f2\-d <directory>\fP\h'|\n(41u'
+\&\h'|\n(40u'\f4\-d <directory>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -420,7 +426,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f2\-extension\fP\h'|\n(41u'
+\&\h'|\n(40u'\f4\-extension\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -434,17 +440,17 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f2\-help\fP\h'|\n(41u'Display help
+\&\h'|\n(40u'\f4\-help\fP\h'|\n(41u'Display help
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f2\-keep\fP\h'|\n(41u'Keep generated files
+\&\h'|\n(40u'\f4\-keep\fP\h'|\n(41u'Keep generated files
.ne \n(e|u+\n(.Vu
.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f2\-r <directory>\fP\h'|\n(41u'
+\&\h'|\n(40u'\f4\-r <directory>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -460,7 +466,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f2\-s <directory>\fP\h'|\n(41u'
+\&\h'|\n(40u'\f4\-s <directory>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -476,7 +482,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f2\-verbose\fP\h'|\n(41u'
+\&\h'|\n(40u'\f4\-verbose\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -492,7 +498,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f2\-version\fP\h'|\n(41u'
+\&\h'|\n(40u'\f4\-version\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -504,22 +510,29 @@
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(i|u+\n(.Vu
-.ne \n(j|u+\n(.Vu
.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
-.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\h'|\n(41u'
+\&\h'|\n(40u'\f4\-wsdl[:protocol]\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
-.nr 37 \n(40u
+.nr 37 \n(41u
.in +\n(37u
.i+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
+.sp |\n(31u
+.ne \n(j|u+\n(.Vu
+.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
+.ta \n(80u \n(81u
+.nr 31 \n(.f
+.nr 35 1m
+\&\h'|\n(40u'\f4\-servicename <name>\fP\h'|\n(41u'
+.mk ##
+.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
@@ -533,7 +546,7 @@
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
-\&\h'|\n(40u'\f2\-servicename <name>\fP\h'|\n(41u'
+\&\h'|\n(40u'\f4\-portname <name>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
@@ -544,22 +557,6 @@
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
-.ne \n(l|u+\n(.Vu
-.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
-.ta \n(80u \n(81u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f2\-portname <name>\fP\h'|\n(41u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.l+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
.fc
.nr T. 1
.T# 1
@@ -575,688 +572,34 @@
.rm i+
.rm j+
.rm k+
-.rm l+
.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-57
+.if \n-(b.=0 .nr c. \n(.c-\n(d.-53
.LP
-.SS
-Ant task
+.SH "Example"
+.nf
+\f3
+.fl
+\fP\f3wsgen \-d stock \-cp myclasspath stock.StockService\fP
+.fl
+.fi
.LP
-.LP
-An 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:
-.LP
+This will generate the wrapper classes needed for StockService annotated with @WebService annotation inside \f3stock\fPdirectory.
.nf
\f3
.fl
-
-.fl
- <wsgen
-.fl
- sei="..."
-.fl
- destdir="directory for generated class files"
-.fl
- classpath="classpath" | cp="classpath"
-.fl
- resourcedestdir="directory for generated resource files such as WSDLs"
-.fl
- sourcedestdir="directory for generated source files"
-.fl
- keep="true|false"
-.fl
- verbose="true|false"
+\fP\f3wsgen \-wsdl \-d stock \-cp myclasspath stock.StockService\fP
.fl
- genwsdl="true|false"
-.fl
- protocol="soap1.1|Xsoap1.2"
-.fl
- servicename="..."
-.fl
- portname="...">
-.fl
- extension="true|false"
-.fl
- <classpath refid="..."/>
-.fl
- </wsgen>
-.fl
-\fP
.fi
-
-.LP
.LP
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80 81 82
-.nr 34 \n(.lu
-.eo
-.am 81
-.br
-.di a+
-.35
-.ft \n(.f
-.ll \n(34u*1u/4u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Name of the service endpoint implementation class
-.br
-.di
-.nr a| \n(dn
-.nr a- \n(dl
-..
-.ec \
-.eo
-.am 81
-.br
-.di b+
-.35
-.ft \n(.f
-.ll \n(34u*1u/4u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Specify where to place output generated classes
-.br
-.di
-.nr b| \n(dn
-.nr b- \n(dl
-..
-.ec \
-.eo
-.am 81
-.br
-.di c+
-.35
-.ft \n(.f
-.ll \n(34u*1u/4u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Specify where to find input class files
-.br
-.di
-.nr c| \n(dn
-.nr c- \n(dl
-..
-.ec \
-.eo
-.am 81
-.br
-.di d+
-.35
-.ft \n(.f
-.ll \n(34u*1u/4u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Used only in conjunction with the \-wsdl option. Specify where to place generated resource files such as WSDLs
-.br
-.di
-.nr d| \n(dn
-.nr d- \n(dl
-..
-.ec \
-.eo
-.am 81
-.br
-.di e+
-.35
-.ft \n(.f
-.ll \n(34u*1u/4u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Specify where to place generated source files
-.br
-.di
-.nr e| \n(dn
-.nr e- \n(dl
-..
-.ec \
-.eo
-.am 81
-.br
-.di f+
-.35
-.ft \n(.f
-.ll \n(34u*1u/4u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Output messages about what the compiler is doing
-.br
-.di
-.nr f| \n(dn
-.nr f- \n(dl
-..
-.ec \
-.eo
-.am 81
-.br
-.di g+
-.35
-.ft \n(.f
-.ll \n(34u*1u/4u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Specify that a WSDL file should be generated
-.br
-.di
-.nr g| \n(dn
-.nr g- \n(dl
-..
-.ec \
-.eo
-.am 81
-.br
-.di h+
-.35
-.ft \n(.f
-.ll \n(34u*1u/4u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Used 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
-.br
-.br
-.di
-.nr h| \n(dn
-.nr h- \n(dl
-..
-.ec \
-.eo
-.am 82
-.br
-.di i+
-.35
-.ft \n(.f
-.ll \n(34u*1u/4u
-.if \n(.l<\n(82 .ll \n(82u
-.in 0
-\f2\-wsdl:soap11\fP
-.br
-.br
-.di
-.nr i| \n(dn
-.nr i- \n(dl
-..
-.ec \
-.eo
-.am 81
-.br
-.di j+
-.35
-.ft \n(.f
-.ll \n(34u*1u/4u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Used 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
-.br
-.br
-.di
-.nr j| \n(dn
-.nr j- \n(dl
-..
-.ec \
-.eo
-.am 81
-.br
-.di k+
-.35
-.ft \n(.f
-.ll \n(34u*1u/4u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-Used 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
-.br
-.br
-.di
-.nr k| \n(dn
-.nr k- \n(dl
-..
-.ec \
-.eo
-.am 81
-.br
-.di l+
-.35
-.ft \n(.f
-.ll \n(34u*1u/4u
-.if \n(.l<\n(81 .ll \n(81u
-.in 0
-allow 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
-.br
-.di
-.nr l| \n(dn
-.nr l- \n(dl
-..
-.ec \
-.35
-.nf
-.ll \n(34u
-.nr 80 0
-.nr 38 \w\f3Attribute\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2sei\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2destdir\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2classpath\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2cp\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2resourcedestdir\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2sourcedestdir\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2keep\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2verbose\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2genwsdl\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2protocol\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2servicename\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2portname\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\f2extension\fP
-.if \n(80<\n(38 .nr 80 \n(38
-.80
-.rm 80
-.nr 81 0
-.nr 38 \w\f3Description\fP
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \wSame as \f2\-classpath\fP
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \wKeep generated files
-.if \n(81<\n(38 .nr 81 \n(38
-.81
-.rm 81
-.nr 38 \n(a-
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \n(b-
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \n(c-
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \n(d-
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \n(e-
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \n(f-
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \n(g-
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \n(h-
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \n(j-
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \n(k-
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \n(l-
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 82 0
-.nr 38 \w\f3Command line\fP
-.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \wSEI
-.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w\f2\-d\fP
-.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w\f2\-classpath\fP
-.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w\f2\-cp\fP
-.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w\f2\-r\fP
-.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w\f2\-s\fP
-.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w\f2\-keep\fP
-.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w\f2\-verbose\fP
-.if \n(82<\n(38 .nr 82 \n(38
-.nr 38 \w\f2\-wsdl\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\-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
-.82
-.rm 82
-.nr 38 \n(i-
-.if \n(82<\n(38 .nr 82 \n(38
-.35
-.nf
-.ll \n(34u
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(0*\n(38)
-.nr 80 +\n(40
-.nr 41 \n(80+(3*\n(38)
-.nr 81 +\n(41
-.nr 42 \n(81+(3*\n(38)
-.nr 82 +\n(42
-.nr TW \n(82
-.if t .if \n(TW>\n(.li .tm Table at line 217 file Input is too wide - \n(TW units
-.fc
-.nr #T 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.ls
-..
-.ec
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f3Attribute\fP\h'|\n(41u'\f3Description\fP\h'|\n(42u'\f3Command line\fP
-.ne \n(a|u+\n(.Vu
-.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f2sei\fP\h'|\n(41u'\h'|\n(42u'SEI
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.a+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ne \n(b|u+\n(.Vu
-.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f2destdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-d\fP
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.b+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ne \n(c|u+\n(.Vu
-.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f2classpath\fP\h'|\n(41u'\h'|\n(42u'\f2\-classpath\fP
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.c+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f2cp\fP\h'|\n(41u'Same as \f2\-classpath\fP\h'|\n(42u'\f2\-cp\fP
-.ne \n(d|u+\n(.Vu
-.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f2resourcedestdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-r\fP
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.d+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ne \n(e|u+\n(.Vu
-.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f2sourcedestdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-s\fP
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.e+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f2keep\fP\h'|\n(41u'Keep generated files\h'|\n(42u'\f2\-keep\fP
-.ne \n(f|u+\n(.Vu
-.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f2verbose\fP\h'|\n(41u'\h'|\n(42u'\f2\-verbose\fP
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.f+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f2genwsdl\fP\h'|\n(41u'\h'|\n(42u'
-.br
-.ne \n(g|u+\n(.Vu
-.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-wsdl\fP
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.g+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f2protocol\fP\h'|\n(41u'\h'|\n(42u'
-.br
-.ne \n(h|u+\n(.Vu
-.ne \n(i|u+\n(.Vu
-.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
-.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.h+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(##u-1v
-.nr 37 \n(42u
-.in +\n(37u
-.i+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f2servicename\fP\h'|\n(41u'\h'|\n(42u'
-.br
-.ne \n(j|u+\n(.Vu
-.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-servicename\fP
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.j+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f2portname\fP\h'|\n(41u'\h'|\n(42u'
-.br
-.ne \n(k|u+\n(.Vu
-.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-servicename\fP
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.k+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\f2extension\fP\h'|\n(41u'\h'|\n(42u'
-.br
-.ne \n(l|u+\n(.Vu
-.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
-.ta \n(80u \n(81u \n(82u
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-extension\fP
-.mk ##
-.nr 31 \n(##
-.sp |\n(##u-1v
-.nr 37 \n(41u
-.in +\n(37u
-.l+
-.in -\n(37u
-.mk 32
-.if \n(32>\n(31 .nr 31 \n(32
-.sp |\n(31u
-.fc
-.nr T. 1
-.T# 1
-.35
-.rm a+
-.rm b+
-.rm c+
-.rm d+
-.rm e+
-.rm f+
-.rm g+
-.rm h+
-.rm i+
-.rm j+
-.rm k+
-.rm l+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-68
-
-.LP
-.LP
-The \f2classpath\fP attribute is a
-.na
-\f2path\-like structure\fP @
-.fi
-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:
-.LP
+This will generate a SOAP 1.1 WSDL and schema for your Java class stock.StockService annotated with @WebService annotation.
.nf
\f3
.fl
- <taskdef name="wsgen" classname="com.sun.tools.ws.ant.WsGen">\fP
-.br
-\f3
-.fl
- <classpath path="jaxws.classpath"/>\fP
-.br
-\f3
-.fl
- </taskdef>
+\fP\f3wsgen \-wsdl:Xsoap1.2 \-d stock \-cp myclasspath stock.StockService\fP
.fl
-\fP
.fi
-
-.LP
-.LP
-where \f2jaxws.classpath\fP is a reference to a
-.na
-\f2path\-like structure\fP @
-.fi
-http://ant.apache.org/manual/using.html#path, defined elsewhere in the build environment, and contains the list of classes required by the JAX\-WS tools.
-.LP
-.SH "Example"
.LP
-
+Will generate a SOAP 1.2 WSDL.
.LP
-.nf
-\f3
-.fl
-<wsgen
-.fl
- resourcedestdir="${wsdl.dir}"
-.fl
- sei="fromjava.server.AddNumbersImpl">
-.fl
- <classpath refid="compile.classpath"/>
-.fl
-</wsgen>
-.fl
-\fP
-.fi
-
-.LP
-
-.LP
-
+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.