1 ." Copyright (c) 2005, 2011, Oracle and/or its affiliates. All rights reserved.

     1 '\" t

     2 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

     2 .\"  Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved.

     3 ."

     3 .\"

     4 ." This code is free software; you can redistribute it and/or modify it

     4 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

     5 ." under the terms of the GNU General Public License version 2 only, as

     5 .\"

     6 ." published by the Free Software Foundation.

     6 .\" This code is free software; you can redistribute it and/or modify it

     7 ."

     7 .\" under the terms of the GNU General Public License version 2 only, as

     8 ." This code is distributed in the hope that it will be useful, but WITHOUT

     8 .\" published by the Free Software Foundation.

     9 ." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

     9 .\"

    10 ." FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

    10 .\" This code is distributed in the hope that it will be useful, but WITHOUT

    11 ." version 2 for more details (a copy is included in the LICENSE file that

    11 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

    12 ." accompanied this code).

    12 .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License

    13 ."

    13 .\" version 2 for more details (a copy is included in the LICENSE file that

    14 ." You should have received a copy of the GNU General Public License version

    14 .\" accompanied this code).

    15 ." 2 along with this work; if not, write to the Free Software Foundation,

    15 .\"

    16 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

    16 .\" You should have received a copy of the GNU General Public License version

    17 ."

    17 .\" 2 along with this work; if not, write to the Free Software Foundation,

    18 ." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

    18 .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

    19 ." or visit www.oracle.com if you need additional information or have any

    19 .\"

    20 ." questions.

    20 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

    21 ."

    21 .\" or visit www.oracle.com if you need additional information or have any

    22 .TH wsgen 1 "10 May 2011"

    22 .\" questions.

    23 .SH "Name"

    23 .\"

    24 wsgen \- Java(TM) API for XML Web Services (JAX\-WS) 2.0

    24 .\"     Arch: generic

    25 .LP

    25 .\"     Software: JDK 8

    26 \f3Specification Version:\fP 2.1

    26 .\"     Date: 21 November 2013

    27 .\"     SectDesc: Java Web Services Tools

    28 .\"     Title: wsgen.1

    29 .\"

    30 .if n .pl 99999

    31 .TH wsgen 1 "21 November 2013" "JDK 8" "Java Web Services Tools"

    32 .\" -----------------------------------------------------------------

    33 .\" * Define some portability stuff

    34 .\" -----------------------------------------------------------------

    35 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

    36 .\" http://bugs.debian.org/507673

    37 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html

    38 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

    39 .ie \n(.g .ds Aq \(aq

    40 .el       .ds Aq '

    41 .\" -----------------------------------------------------------------

    42 .\" * set default formatting

    43 .\" -----------------------------------------------------------------

    44 .\" disable hyphenation

    45 .nh

    46 .\" disable justification (adjust text to left margin only)

    47 .ad l

    48 .\" -----------------------------------------------------------------

    49 .\" * MAIN CONTENT STARTS HERE *

    50 .\" -----------------------------------------------------------------

    51 

    52 .SH NAME    

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

    54 .SH SYNOPSIS    

    55 .sp     

    56 .nf     

    57 

    58 \fBwsgen\fR [ \fIoptions\fR ] \fISEI\fR

    59 .fi     

    60 .sp     

    61 .TP     

    62 \fIoptions\fR

    63 The command-line options\&. See Options\&.

    64 .TP     

    65 \fISEI\fR

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

    67 .SH DESCRIPTION    

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

    69 .PP

    70 To start the \f3wsgen\fR command, do the following:

    71 .sp     

    72 .nf     

    73 \f3export JAXWS_HOME=/pathto/jaxws\-ri\fP

    74 .fi     

    75 .nf     

    76 \f3$JAXWS_HOME/bin/wsgen\&.sh \-help\fP

    77 .fi     

    78 .nf     

    79 \f3\fP

    80 .fi     

    81 .sp     

    82 .SH OPTIONS    

    83 .TP

    84 -classpath \fIpath\fR

    28 \f3Implementation Version:\fP 2.1.1

    86 The location of the input class files\&.

    29 .LP

    87 .TP

    30 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

    88 -cp \fIpath\fR

    31 .SH "Overview"

    89 .br

    32 .LP

    90 The location of the input class files\&.

    33 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

    91 .TP

    34 .na

    92 -d \fIdirectory\fR

    35 \f2Wsgen ant task\fP @

    93 .br

    36 .fi

    94 The location for where to place generated output files\&.

    37 https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsgenant.html for details.

    95 .TP

    38 .LP

    96 -extension

    39 .SH "Launching wsgen"

    97 .br

    40 .RS 3

    98 Allow vendor extensions\&. Use of extensions can result in applications that are not portable or that do not work with other implementations\&.

    41 .TP 2

    99 .TP

    42 o

   100 -help

    43 \f3Solaris/Bsd\fP

   101 .br

    44 .RS 3

   102 Displays a help message about the \f3wsgen\fR command\&.

    45 .TP 2

   103 .TP

    46 *

   104 -keep

    47 \f2export JAXWS_HOME=/pathto/jaxws\-ri\fP

   105 .br

    48 .TP 2

   106 Keeps the generated files\&.

    49 *

   107 .TP

    50 \f2$JAXWS_HOME/bin/wsgen.sh \-help\fP

   108 -r \fIdirectory\fR

   109 .br

   110 Uses this option with the \f3-wsdl\fR option to specify where to place generated resource files such as WSDLs\&.

   111 .TP

   112 -s \fIdirectory\fR

   113 .br

   114 The location for where to place generated source files\&.

   115 .TP

   116 -verbose

   117 .br

   118 Displays compiler messages\&.

   119 .TP

   120 -version

   121 .br

   122 Prints release information\&.

   123 .TP

   124 -wsdl [ :protocol ] \fI\fR

   125 .br

   126 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\&.

   127 

   128 By default the \f3wsgen\fR command does not generate a WSDL file\&. The \f3protocol\fR value is optional and is used to specify what protocol should be used for the WSDL binding (\f3wsdl:binding\fR)\&. Valid protocols are \f3soap1\&.1\fR and \f3Xsoap1\&.2\fR\&. The default is \f3soap1\&.1\fR\&. The \f3Xsoap1\&.2\fR protocol is not standard and can only be used with the \f3-extension\fR option\&.

   129 .TP

   130 -servicename \fIname\fR

   131 .br

   132 Used only with the \f3-wsdl\fR option to specify a particular WSDL service (\f3wsdl:service\fR) name to be generated in the WSDL, for example: \f3-servicename "{http://mynamespace/}MyService"\fR\&.

   133 .TP

   134 -portname \fIname\fR

   135 .br

   136 Used only with the \f3-wsdl\fR option to specify a particular WSDL port (\f3wsdl:port\fR) name to be generated in the WSDL, for example: \f3-portname "{http://mynamespace/}MyPort"\fR\&.

   137 .SH EXAMPLES    

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

   139 .sp     

   140 .nf     

   141 \f3wsgen \-d stock \-cp myclasspath stock\&.StockService\fP

   142 .fi     

   143 .nf     

   144 \f3\fP

   145 .fi     

   146 .sp     

   147 The following example generates a SOAP 1\&.1 WSDL and schema for the \f3stock\&.StockService\fR class with \f3@WebService\fR annotations\&.

   148 .sp     

   149 .nf     

   150 \f3wsgen \-wsdl \-d stock \-cp myclasspath stock\&.StockService\fP

   151 .fi     

   152 .nf     

   153 \f3\fP

   154 .fi     

   155 .sp     

   156 The following example generates a SOAP 1\&.2 WSDL\&.

   157 .sp     

   158 .nf     

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

   160 .fi     

   161 .nf     

   162 \f3\fP

   163 .fi     

   164 .sp     

   165 \fINote:\fR 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\&.

   166 .SH SEE\ ALSO    

   167 .TP 0.2i    

   168 \(bu

   169 wsimport(1)

   170 .TP 0.2i    

   171 \(bu

   172 \fIThe Tools\fR tab of the JAX-WS (wsgen) page http://jax-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsgenant\&.html

    72 \f3

   175 'pl 8.5i

    73 .fl

   176 'bp

    74 \fP

    75 .fi

    76 .LP

    77 The following table lists the \f2wsgen\fP options.

    78 .br

    79 .LP

    80 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1

    81 .de 35

    82 .ps \n(.s

    83 .vs \n(.vu

    84 .in \n(.iu

    85 .if \n(.u .fi

    86 .if \n(.j .ad

    87 .if \n(.j=0 .na

    88 ..

    89 .nf

    90 .nr #~ 0

    91 .if n .nr #~ 0.6n

    92 .ds #d .d

    93 .if \(ts\n(.z\(ts\(ts .ds #d nl

    94 .fc

    95 .nr 33 \n(.s

    96 .rm 80 81

    97 .nr 34 \n(.lu

    98 .eo

    99 .am 81

   100 .br

   101 .di a+

   102 .35

   103 .ft \n(.f

   104 .ll \n(34u*1u/3u

   105 .if \n(.l<\n(81 .ll \n(81u

   106 .in 0

   107 Specify where to find input class files

   108 .br

   109 .di

   110 .nr a| \n(dn

   111 .nr a- \n(dl

   112 ..

   113 .ec \

   114 .eo

   115 .am 81

   116 .br

   117 .di b+

   118 .35

   119 .ft \n(.f

   120 .ll \n(34u*1u/3u

   121 .if \n(.l<\n(81 .ll \n(81u

   122 .in 0

   123 Same as \f2\-classpath <path>\fP

   124 .br

   125 .di

   126 .nr b| \n(dn

   127 .nr b- \n(dl

   128 ..

   129 .ec \

   130 .eo

   131 .am 81

   132 .br

   133 .di c+

   134 .35

   135 .ft \n(.f

   136 .ll \n(34u*1u/3u

   137 .if \n(.l<\n(81 .ll \n(81u

   138 .in 0

   139 Specify where to place generated output files

   140 .br

   141 .di

   142 .nr c| \n(dn

   143 .nr c- \n(dl

   144 ..

   145 .ec \

   146 .eo

   147 .am 81

   148 .br

   149 .di d+

   150 .35

   151 .ft \n(.f

   152 .ll \n(34u*1u/3u

   153 .if \n(.l<\n(81 .ll \n(81u

   154 .in 0

   155 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

   156 .br

   157 .di

   158 .nr d| \n(dn

   159 .nr d- \n(dl

   160 ..

   161 .ec \

   162 .eo

   163 .am 81

   164 .br

   165 .di e+

   166 .35

   167 .ft \n(.f

   168 .ll \n(34u*1u/3u

   169 .if \n(.l<\n(81 .ll \n(81u

   170 .in 0

   171 Used only in conjunction with the \-wsdl option. Specify where to place generated resource files such as WSDLs

   172 .br

   173 .di

   174 .nr e| \n(dn

   175 .nr e- \n(dl

   176 ..

   177 .ec \

   178 .eo

   179 .am 81

   180 .br

   181 .di f+

   182 .35

   183 .ft \n(.f

   184 .ll \n(34u*1u/3u

   185 .if \n(.l<\n(81 .ll \n(81u

   186 .in 0

   187 Specify where to place generated source files

   188 .br

   189 .di

   190 .nr f| \n(dn

   191 .nr f- \n(dl

   192 ..

   193 .ec \

   194 .eo

   195 .am 81

   196 .br

   197 .di g+

   198 .35

   199 .ft \n(.f

   200 .ll \n(34u*1u/3u

   201 .if \n(.l<\n(81 .ll \n(81u

   202 .in 0

   203 Output messages about what the compiler is doing

   204 .br

   205 .di

   206 .nr g| \n(dn

   207 .nr g- \n(dl

   208 ..

   209 .ec \

   210 .eo

   211 .am 81

   212 .br

   213 .di h+

   214 .35

   215 .ft \n(.f

   216 .ll \n(34u*1u/3u

   217 .if \n(.l<\n(81 .ll \n(81u

   218 .in 0

   219 Print version information. Use of this option will ONLY print version information. Normal processing will not occur.

   220 .br

   221 .di

   222 .nr h| \n(dn

   223 .nr h- \n(dl

   224 ..

   225 .ec \

   226 .eo

   227 .am 81

   228 .br

   229 .di i+

   230 .35

   231 .ft \n(.f

   232 .ll \n(34u*1u/3u

   233 .if \n(.l<\n(81 .ll \n(81u

   234 .in 0

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

   236 .br

   237 .di

   238 .nr i| \n(dn

   239 .nr i- \n(dl

   240 ..

   241 .ec \

   242 .eo

   243 .am 81

   244 .br

   245 .di j+

   246 .35

   247 .ft \n(.f

   248 .ll \n(34u*1u/3u

   249 .if \n(.l<\n(81 .ll \n(81u

   250 .in 0

   251 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

   252 .br

   253 .di

   254 .nr j| \n(dn

   255 .nr j- \n(dl

   256 ..

   257 .ec \

   258 .eo

   259 .am 81

   260 .br

   261 .di k+

   262 .35

   263 .ft \n(.f

   264 .ll \n(34u*1u/3u

   265 .if \n(.l<\n(81 .ll \n(81u

   266 .in 0

   267 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

   268 .br

   269 .br

   270 .di

   271 .nr k| \n(dn

   272 .nr k- \n(dl

   273 ..

   274 .ec \

   275 .35

   276 .nf

   277 .ll \n(34u

   278 .nr 80 0

   279 .nr 38 \w\f3Option\fP

   280 .if \n(80<\n(38 .nr 80 \n(38

   281 .nr 38 \w\f4\-classpath <path>\fP

   282 .if \n(80<\n(38 .nr 80 \n(38

   283 .nr 38 \w\f4\-cp <path>\fP

   284 .if \n(80<\n(38 .nr 80 \n(38

   285 .nr 38 \w\f4\-d <directory>\fP

   286 .if \n(80<\n(38 .nr 80 \n(38

   287 .nr 38 \w\f4\-extension\fP

   288 .if \n(80<\n(38 .nr 80 \n(38

   289 .nr 38 \w\f4\-help\fP

   290 .if \n(80<\n(38 .nr 80 \n(38

   291 .nr 38 \w\f4\-keep\fP

   292 .if \n(80<\n(38 .nr 80 \n(38

   293 .nr 38 \w\f4\-r <directory>\fP

   294 .if \n(80<\n(38 .nr 80 \n(38

   295 .nr 38 \w\f4\-s <directory>\fP

   296 .if \n(80<\n(38 .nr 80 \n(38

   297 .nr 38 \w\f4\-verbose\fP

   298 .if \n(80<\n(38 .nr 80 \n(38

   299 .nr 38 \w\f4\-version\fP

   300 .if \n(80<\n(38 .nr 80 \n(38

   301 .nr 38 \w\f4\-wsdl[:protocol]\fP

   302 .if \n(80<\n(38 .nr 80 \n(38

   303 .nr 38 \w\f4\-servicename <name>\fP

   304 .if \n(80<\n(38 .nr 80 \n(38

   305 .nr 38 \w\f4\-portname <name>\fP

   306 .if \n(80<\n(38 .nr 80 \n(38

   307 .80

   308 .rm 80

   309 .nr 81 0

   310 .nr 38 \w\f3Description\fP

   311 .if \n(81<\n(38 .nr 81 \n(38

   312 .nr 38 \wDisplay help

   313 .if \n(81<\n(38 .nr 81 \n(38

   314 .nr 38 \wKeep generated files

   315 .if \n(81<\n(38 .nr 81 \n(38

   316 .81

   317 .rm 81

   318 .nr 38 \n(a-

   319 .if \n(81<\n(38 .nr 81 \n(38

   320 .nr 38 \n(b-

   321 .if \n(81<\n(38 .nr 81 \n(38

   322 .nr 38 \n(c-

   323 .if \n(81<\n(38 .nr 81 \n(38

   324 .nr 38 \n(d-

   325 .if \n(81<\n(38 .nr 81 \n(38

   326 .nr 38 \n(e-

   327 .if \n(81<\n(38 .nr 81 \n(38

   328 .nr 38 \n(f-

   329 .if \n(81<\n(38 .nr 81 \n(38

   330 .nr 38 \n(g-

   331 .if \n(81<\n(38 .nr 81 \n(38

   332 .nr 38 \n(h-

   333 .if \n(81<\n(38 .nr 81 \n(38

   334 .nr 38 \n(i-

   335 .if \n(81<\n(38 .nr 81 \n(38

   336 .nr 38 \n(j-

   337 .if \n(81<\n(38 .nr 81 \n(38

   338 .nr 38 \n(k-

   339 .if \n(81<\n(38 .nr 81 \n(38

   340 .35

   341 .nf

   342 .ll \n(34u

   343 .nr 38 1n

   344 .nr 79 0

   345 .nr 40 \n(79+(0*\n(38)

   346 .nr 80 +\n(40

   347 .nr 41 \n(80+(3*\n(38)

   348 .nr 81 +\n(41

   349 .nr TW \n(81

   350 .if t .if \n(TW>\n(.li .tm Table at line 133 file Input is too wide - \n(TW units

   351 .fc  

   352 .nr #T 0-1

   353 .nr #a 0-1

   354 .eo

   355 .de T#

   356 .ds #d .d

   357 .if \(ts\n(.z\(ts\(ts .ds #d nl

   358 .mk ##

   359 .nr ## -1v

   360 .ls 1

   361 .ls

   362 ..

   363 .ec

   364 .ta \n(80u \n(81u

   365 .nr 31 \n(.f

   366 .nr 35 1m

   367 \&\h'|\n(40u'\f3Option\fP\h'|\n(41u'\f3Description\fP

   368 .ne \n(a|u+\n(.Vu

   369 .if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)

   370 .ta \n(80u \n(81u

   371 .nr 31 \n(.f

   372 .nr 35 1m

   373 \&\h'|\n(40u'\f4\-classpath <path>\fP\h'|\n(41u'

   374 .mk ##

   375 .nr 31 \n(##

   376 .sp |\n(##u-1v

   377 .nr 37 \n(41u

   378 .in +\n(37u

   379 .a+

   380 .in -\n(37u

   381 .mk 32

   382 .if \n(32>\n(31 .nr 31 \n(32

   383 .sp |\n(31u

   384 .ne \n(b|u+\n(.Vu

   385 .if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)

   386 .ta \n(80u \n(81u

   387 .nr 31 \n(.f

   388 .nr 35 1m

   389 \&\h'|\n(40u'\f4\-cp <path>\fP\h'|\n(41u'

   390 .mk ##

   391 .nr 31 \n(##

   392 .sp |\n(##u-1v

   393 .nr 37 \n(41u

   394 .in +\n(37u

   395 .b+

   396 .in -\n(37u

   397 .mk 32

   398 .if \n(32>\n(31 .nr 31 \n(32

   399 .sp |\n(31u

   400 .ne \n(c|u+\n(.Vu

   401 .if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)

   402 .ta \n(80u \n(81u

   403 .nr 31 \n(.f

   404 .nr 35 1m

   405 \&\h'|\n(40u'\f4\-d <directory>\fP\h'|\n(41u'

   406 .mk ##

   407 .nr 31 \n(##

   408 .sp |\n(##u-1v

   409 .nr 37 \n(41u

   410 .in +\n(37u

   411 .c+

   412 .in -\n(37u

   413 .mk 32

   414 .if \n(32>\n(31 .nr 31 \n(32

   415 .sp |\n(31u

   416 .ne \n(d|u+\n(.Vu

   417 .if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)

   418 .ta \n(80u \n(81u

   419 .nr 31 \n(.f

   420 .nr 35 1m

   421 \&\h'|\n(40u'\f4\-extension\fP\h'|\n(41u'

   422 .mk ##

   423 .nr 31 \n(##

   424 .sp |\n(##u-1v

   425 .nr 37 \n(41u

   426 .in +\n(37u

   427 .d+

   428 .in -\n(37u

   429 .mk 32

   430 .if \n(32>\n(31 .nr 31 \n(32

   431 .sp |\n(31u

   432 .ta \n(80u \n(81u

   433 .nr 31 \n(.f

   434 .nr 35 1m

   435 \&\h'|\n(40u'\f4\-help\fP\h'|\n(41u'Display help

   436 .ta \n(80u \n(81u

   437 .nr 31 \n(.f

   438 .nr 35 1m

   439 \&\h'|\n(40u'\f4\-keep\fP\h'|\n(41u'Keep generated files

   440 .ne \n(e|u+\n(.Vu

   441 .if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)

   442 .ta \n(80u \n(81u

   443 .nr 31 \n(.f

   444 .nr 35 1m

   445 \&\h'|\n(40u'\f4\-r <directory>\fP\h'|\n(41u'

   446 .mk ##

   447 .nr 31 \n(##

   448 .sp |\n(##u-1v

   449 .nr 37 \n(41u

   450 .in +\n(37u

   451 .e+

   452 .in -\n(37u

   453 .mk 32

   454 .if \n(32>\n(31 .nr 31 \n(32

   455 .sp |\n(31u

   456 .ne \n(f|u+\n(.Vu

   457 .if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)

   458 .ta \n(80u \n(81u

   459 .nr 31 \n(.f

   460 .nr 35 1m

   461 \&\h'|\n(40u'\f4\-s <directory>\fP\h'|\n(41u'

   462 .mk ##

   463 .nr 31 \n(##

   464 .sp |\n(##u-1v

   465 .nr 37 \n(41u

   466 .in +\n(37u

   467 .f+

   468 .in -\n(37u

   469 .mk 32

   470 .if \n(32>\n(31 .nr 31 \n(32

   471 .sp |\n(31u

   472 .ne \n(g|u+\n(.Vu

   473 .if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)

   474 .ta \n(80u \n(81u

   475 .nr 31 \n(.f

   476 .nr 35 1m

   477 \&\h'|\n(40u'\f4\-verbose\fP\h'|\n(41u'

   478 .mk ##

   479 .nr 31 \n(##

   480 .sp |\n(##u-1v

   481 .nr 37 \n(41u

   482 .in +\n(37u

   483 .g+

   484 .in -\n(37u

   485 .mk 32

   486 .if \n(32>\n(31 .nr 31 \n(32

   487 .sp |\n(31u

   488 .ne \n(h|u+\n(.Vu

   489 .if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)

   490 .ta \n(80u \n(81u

   491 .nr 31 \n(.f

   492 .nr 35 1m

   493 \&\h'|\n(40u'\f4\-version\fP\h'|\n(41u'

   494 .mk ##

   495 .nr 31 \n(##

   496 .sp |\n(##u-1v

   497 .nr 37 \n(41u

   498 .in +\n(37u

   499 .h+

   500 .in -\n(37u

   501 .mk 32

   502 .if \n(32>\n(31 .nr 31 \n(32

   503 .sp |\n(31u

   504 .ne \n(i|u+\n(.Vu

   505 .if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)

   506 .ta \n(80u \n(81u

   507 .nr 31 \n(.f

   508 .nr 35 1m

   509 \&\h'|\n(40u'\f4\-wsdl[:protocol]\fP\h'|\n(41u'

   510 .mk ##

   511 .nr 31 \n(##

   512 .sp |\n(##u-1v

   513 .nr 37 \n(41u

   514 .in +\n(37u

   515 .i+

   516 .in -\n(37u

   517 .mk 32

   518 .if \n(32>\n(31 .nr 31 \n(32

   519 .sp |\n(31u

   520 .ne \n(j|u+\n(.Vu

   521 .if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)

   522 .ta \n(80u \n(81u

   523 .nr 31 \n(.f

   524 .nr 35 1m

   525 \&\h'|\n(40u'\f4\-servicename <name>\fP\h'|\n(41u'

   526 .mk ##

   527 .nr 31 \n(##

   528 .sp |\n(##u-1v

   529 .nr 37 \n(41u

   530 .in +\n(37u

   531 .j+

   532 .in -\n(37u

   533 .mk 32

   534 .if \n(32>\n(31 .nr 31 \n(32

   535 .sp |\n(31u

   536 .ne \n(k|u+\n(.Vu

   537 .if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)

   538 .ta \n(80u \n(81u

   539 .nr 31 \n(.f

   540 .nr 35 1m

   541 \&\h'|\n(40u'\f4\-portname <name>\fP\h'|\n(41u'

   542 .mk ##

   543 .nr 31 \n(##

   544 .sp |\n(##u-1v

   545 .nr 37 \n(41u

   546 .in +\n(37u

   547 .k+

   548 .in -\n(37u

   549 .mk 32

   550 .if \n(32>\n(31 .nr 31 \n(32

   551 .sp |\n(31u

   552 .fc

   553 .nr T. 1

   554 .T# 1

   555 .35

   556 .rm a+

   557 .rm b+

   558 .rm c+

   559 .rm d+

   560 .rm e+

   561 .rm f+

   562 .rm g+

   563 .rm h+

   564 .rm i+

   565 .rm j+

   566 .rm k+

   567 .if \n-(b.=0 .nr c. \n(.c-\n(d.-53

   568 

   569 .LP

   570 .SH "Example"

   571 .nf

   572 \f3

   573 .fl

   574 \fP\f3wsgen \-d stock \-cp myclasspath stock.StockService\fP

   575 .fl

   576 .fi

   577 .LP

   578 This will generate the wrapper classes needed for StockService annotated with @WebService annotation inside \f3stock\fPdirectory.

   579 .nf

   580 \f3

   581 .fl

   582 \fP\f3wsgen \-wsdl \-d stock \-cp myclasspath stock.StockService\fP

   583 .fl

   584 .fi

   585 .LP

   586 This will generate a SOAP 1.1 WSDL and schema for your Java class stock.StockService annotated with @WebService annotation.

   587 .nf

   588 \f3

   589 .fl

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

   591 .fl

   592 .fi

   593 .LP

   594 Will generate a SOAP 1.2 WSDL.

   595 .LP

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