Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / libcore / 319a3b994703aac84df7bcde272adfcb3cdbbbf0 / . / jdk / src / solaris / doc / sun / man / man1 / wsgen.1
blob: 3a7b65f0cebf4cd516a7f1b30a2fbcec8a228637 [file] [log] [blame]
J. Duke319a3b92007-12-01 00:00:00 +0000[diff] [blame^]1.'" t
2." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
3." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4."
5." This code is free software; you can redistribute it and/or modify it
6." under the terms of the GNU General Public License version 2 only, as
7." published by the Free Software Foundation.
8."
9." This code is distributed in the hope that it will be useful, but WITHOUT
10." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
12." version 2 for more details (a copy is included in the LICENSE file that
13." accompanied this code).
14."
15." You should have received a copy of the GNU General Public License version
16." 2 along with this work; if not, write to the Free Software Foundation,
17." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18."
19." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
20." CA 95054 USA or visit www.sun.com if you need additional information or
21." have any questions.
22." `
23.TH wsgen 1 "07 Aug 2006"
24." Generated by html2man
25
26.LP
27.SH NAME
28wsgen \- JAX\-WS 2.0 Beta
29.LP
30.RS 3
31
32.LP
33.LP
34The \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.
35.LP
36.RE
37.SH "SYNOPSIS"
38.LP
39
40.LP
41.nf
42\f3
43.fl
44wsgen [options] <SEI>
45.fl
46\fP
47.fi
48
49.LP
50.SH "OPTIONS"
51.LP
52.LP
53The following table lists the \f2wsgen\fP options.
54.br
55
56.LP
57.LP
58Table 1\-1 wsgen Options
59.LP
60.LP
61.TS
62.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
63.de 35
64.ps \n(.s
65.vs \n(.vu
66.in \n(.iu
67.if \n(.u .fi
68.if \n(.j .ad
69.if \n(.j=0 .na
70..
71.nf
72.nr #~ 0
73.if n .nr #~ 0.6n
74.ds #d .d
75.if \(ts\n(.z\(ts\(ts .ds #d nl
76.fc
77.nr 33 \n(.s
78.rm 80 81
79.nr 34 \n(.lu
80.eo
81.am 81
82.br
83.di a+
84.35
85.ft \n(.f
86.ll \n(34u*1u/3u
87.if \n(.l<\n(81 .ll \n(81u
88.in 0
89Specify where to find input class files
90.br
91.di
92.nr a| \n(dn
93.nr a- \n(dl
94..
95.ec \
96.eo
97.am 81
98.br
99.di b+
100.35
101.ft \n(.f
102.ll \n(34u*1u/3u
103.if \n(.l<\n(81 .ll \n(81u
104.in 0
105Same as \f2\-classpath <path>\fP
106.br
107.di
108.nr b| \n(dn
109.nr b- \n(dl
110..
111.ec \
112.eo
113.am 81
114.br
115.di c+
116.35
117.ft \n(.f
118.ll \n(34u*1u/3u
119.if \n(.l<\n(81 .ll \n(81u
120.in 0
121Specify where to place generated output files
122.br
123.di
124.nr c| \n(dn
125.nr c- \n(dl
126..
127.ec \
128.eo
129.am 81
130.br
131.di d+
132.35
133.ft \n(.f
134.ll \n(34u*1u/3u
135.if \n(.l<\n(81 .ll \n(81u
136.in 0
137allow 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
138.br
139.di
140.nr d| \n(dn
141.nr d- \n(dl
142..
143.ec \
144.eo
145.am 81
146.br
147.di e+
148.35
149.ft \n(.f
150.ll \n(34u*1u/3u
151.if \n(.l<\n(81 .ll \n(81u
152.in 0
153Used only in conjunction with the \-wsdl option. Specify where to place generated resource files such as WSDLs
154.br
155.di
156.nr e| \n(dn
157.nr e- \n(dl
158..
159.ec \
160.eo
161.am 81
162.br
163.di f+
164.35
165.ft \n(.f
166.ll \n(34u*1u/3u
167.if \n(.l<\n(81 .ll \n(81u
168.in 0
169Specify where to place generated source files
170.br
171.di
172.nr f| \n(dn
173.nr f- \n(dl
174..
175.ec \
176.eo
177.am 81
178.br
179.di g+
180.35
181.ft \n(.f
182.ll \n(34u*1u/3u
183.if \n(.l<\n(81 .ll \n(81u
184.in 0
185Output messages about what the compiler is doing
186.br
187.di
188.nr g| \n(dn
189.nr g- \n(dl
190..
191.ec \
192.eo
193.am 81
194.br
195.di h+
196.35
197.ft \n(.f
198.ll \n(34u*1u/3u
199.if \n(.l<\n(81 .ll \n(81u
200.in 0
201Print version information. Use of this option will ONLY print version information. Normal processing will not occur.
202.br
203.di
204.nr h| \n(dn
205.nr h- \n(dl
206..
207.ec \
208.eo
209.am 80
210.br
211.di i+
212.35
213.ft \n(.f
214.ll \n(34u*1u/3u
215.if \n(.l<\n(80 .ll \n(80u
216.in 0
217\f2\-wsdl[:protocol]\fP
218.br
219.br
220.di
221.nr i| \n(dn
222.nr i- \n(dl
223..
224.ec \
225.eo
226.am 81
227.br
228.di j+
229.35
230.ft \n(.f
231.ll \n(34u*1u/3u
232.if \n(.l<\n(81 .ll \n(81u
233.in 0
234By 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.
235.br
236.br
237.di
238.nr j| \n(dn
239.nr j- \n(dl
240..
241.ec \
242.eo
243.am 81
244.br
245.di k+
246.35
247.ft \n(.f
248.ll \n(34u*1u/3u
249.if \n(.l<\n(81 .ll \n(81u
250.in 0
251Used 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 k| \n(dn
255.nr k- \n(dl
256..
257.ec \
258.eo
259.am 81
260.br
261.di l+
262.35
263.ft \n(.f
264.ll \n(34u*1u/3u
265.if \n(.l<\n(81 .ll \n(81u
266.in 0
267Used 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 l| \n(dn
272.nr l- \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\f2\-classpath <path>\fP
282.if \n(80<\n(38 .nr 80 \n(38
283.nr 38 \w\f2\-cp <path>\fP
284.if \n(80<\n(38 .nr 80 \n(38
285.nr 38 \w\f2\-d <directory>\fP
286.if \n(80<\n(38 .nr 80 \n(38
287.nr 38 \w\f2\-extension\fP
288.if \n(80<\n(38 .nr 80 \n(38
289.nr 38 \w\f2\-help\fP
290.if \n(80<\n(38 .nr 80 \n(38
291.nr 38 \w\f2\-keep\fP
292.if \n(80<\n(38 .nr 80 \n(38
293.nr 38 \w\f2\-r <directory>\fP
294.if \n(80<\n(38 .nr 80 \n(38
295.nr 38 \w\f2\-s <directory>\fP
296.if \n(80<\n(38 .nr 80 \n(38
297.nr 38 \w\f2\-verbose\fP
298.if \n(80<\n(38 .nr 80 \n(38
299.nr 38 \w\f2\-version\fP
300.if \n(80<\n(38 .nr 80 \n(38
301.nr 38 \w\f2\-servicename <name>\fP
302.if \n(80<\n(38 .nr 80 \n(38
303.nr 38 \w\f2\-portname <name>\fP
304.if \n(80<\n(38 .nr 80 \n(38
305.80
306.rm 80
307.nr 38 \n(i-
308.if \n(80<\n(38 .nr 80 \n(38
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(j-
335.if \n(81<\n(38 .nr 81 \n(38
336.nr 38 \n(k-
337.if \n(81<\n(38 .nr 81 \n(38
338.nr 38 \n(l-
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 100 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'\f2\-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'\f2\-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'\f2\-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'\f2\-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'\f2\-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'\f2\-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'\f2\-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'\f2\-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'\f2\-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'\f2\-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.ne \n(j|u+\n(.Vu
506.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
507.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
508.ta \n(80u \n(81u
509.nr 31 \n(.f
510.nr 35 1m
511\&\h'|\n(40u'\h'|\n(41u'
512.mk ##
513.nr 31 \n(##
514.sp |\n(##u-1v
515.nr 37 \n(40u
516.in +\n(37u
517.i+
518.in -\n(37u
519.mk 32
520.if \n(32>\n(31 .nr 31 \n(32
521.sp |\n(##u-1v
522.nr 37 \n(41u
523.in +\n(37u
524.j+
525.in -\n(37u
526.mk 32
527.if \n(32>\n(31 .nr 31 \n(32
528.sp |\n(31u
529.ne \n(k|u+\n(.Vu
530.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
531.ta \n(80u \n(81u
532.nr 31 \n(.f
533.nr 35 1m
534\&\h'|\n(40u'\f2\-servicename <name>\fP\h'|\n(41u'
535.mk ##
536.nr 31 \n(##
537.sp |\n(##u-1v
538.nr 37 \n(41u
539.in +\n(37u
540.k+
541.in -\n(37u
542.mk 32
543.if \n(32>\n(31 .nr 31 \n(32
544.sp |\n(31u
545.ne \n(l|u+\n(.Vu
546.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
547.ta \n(80u \n(81u
548.nr 31 \n(.f
549.nr 35 1m
550\&\h'|\n(40u'\f2\-portname <name>\fP\h'|\n(41u'
551.mk ##
552.nr 31 \n(##
553.sp |\n(##u-1v
554.nr 37 \n(41u
555.in +\n(37u
556.l+
557.in -\n(37u
558.mk 32
559.if \n(32>\n(31 .nr 31 \n(32
560.sp |\n(31u
561.fc
562.nr T. 1
563.T# 1
564.35
565.rm a+
566.rm b+
567.rm c+
568.rm d+
569.rm e+
570.rm f+
571.rm g+
572.rm h+
573.rm i+
574.rm j+
575.rm k+
576.rm l+
577.TE
578.if \n-(b.=0 .nr c. \n(.c-\n(d.-57
579
580.LP
581.SS
582Ant task
583.LP
584.LP
585An 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:
586.LP
587.nf
588\f3
589.fl
590
591.fl
592 <wsgen
593.fl
594 sei="..."
595.fl
596 destdir="directory for generated class files"
597.fl
598 classpath="classpath" | cp="classpath"
599.fl
600 resourcedestdir="directory for generated resource files such as WSDLs"
601.fl
602 sourcedestdir="directory for generated source files"
603.fl
604 keep="true|false"
605.fl
606 verbose="true|false"
607.fl
608 genwsdl="true|false"
609.fl
610 protocol="soap1.1|Xsoap1.2"
611.fl
612 servicename="..."
613.fl
614 portname="...">
615.fl
616 extension="true|false"
617.fl
618 <classpath refid="..."/>
619.fl
620 </wsgen>
621.fl
622\fP
623.fi
624
625.LP
626.LP
627.TS
628.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
629.de 35
630.ps \n(.s
631.vs \n(.vu
632.in \n(.iu
633.if \n(.u .fi
634.if \n(.j .ad
635.if \n(.j=0 .na
636..
637.nf
638.nr #~ 0
639.if n .nr #~ 0.6n
640.ds #d .d
641.if \(ts\n(.z\(ts\(ts .ds #d nl
642.fc
643.nr 33 \n(.s
644.rm 80 81 82
645.nr 34 \n(.lu
646.eo
647.am 81
648.br
649.di a+
650.35
651.ft \n(.f
652.ll \n(34u*1u/4u
653.if \n(.l<\n(81 .ll \n(81u
654.in 0
655Name of the service endpoint implementation class
656.br
657.di
658.nr a| \n(dn
659.nr a- \n(dl
660..
661.ec \
662.eo
663.am 81
664.br
665.di b+
666.35
667.ft \n(.f
668.ll \n(34u*1u/4u
669.if \n(.l<\n(81 .ll \n(81u
670.in 0
671Specify where to place output generated classes
672.br
673.di
674.nr b| \n(dn
675.nr b- \n(dl
676..
677.ec \
678.eo
679.am 81
680.br
681.di c+
682.35
683.ft \n(.f
684.ll \n(34u*1u/4u
685.if \n(.l<\n(81 .ll \n(81u
686.in 0
687Specify where to find input class files
688.br
689.di
690.nr c| \n(dn
691.nr c- \n(dl
692..
693.ec \
694.eo
695.am 81
696.br
697.di d+
698.35
699.ft \n(.f
700.ll \n(34u*1u/4u
701.if \n(.l<\n(81 .ll \n(81u
702.in 0
703Used only in conjunction with the \-wsdl option. Specify where to place generated resource files such as WSDLs
704.br
705.di
706.nr d| \n(dn
707.nr d- \n(dl
708..
709.ec \
710.eo
711.am 81
712.br
713.di e+
714.35
715.ft \n(.f
716.ll \n(34u*1u/4u
717.if \n(.l<\n(81 .ll \n(81u
718.in 0
719Specify where to place generated source files
720.br
721.di
722.nr e| \n(dn
723.nr e- \n(dl
724..
725.ec \
726.eo
727.am 81
728.br
729.di f+
730.35
731.ft \n(.f
732.ll \n(34u*1u/4u
733.if \n(.l<\n(81 .ll \n(81u
734.in 0
735Output messages about what the compiler is doing
736.br
737.di
738.nr f| \n(dn
739.nr f- \n(dl
740..
741.ec \
742.eo
743.am 81
744.br
745.di g+
746.35
747.ft \n(.f
748.ll \n(34u*1u/4u
749.if \n(.l<\n(81 .ll \n(81u
750.in 0
751Specify that a WSDL file should be generated
752.br
753.di
754.nr g| \n(dn
755.nr g- \n(dl
756..
757.ec \
758.eo
759.am 81
760.br
761.di h+
762.35
763.ft \n(.f
764.ll \n(34u*1u/4u
765.if \n(.l<\n(81 .ll \n(81u
766.in 0
767Used 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
768.br
769.br
770.di
771.nr h| \n(dn
772.nr h- \n(dl
773..
774.ec \
775.eo
776.am 82
777.br
778.di i+
779.35
780.ft \n(.f
781.ll \n(34u*1u/4u
782.if \n(.l<\n(82 .ll \n(82u
783.in 0
784\f2\-wsdl:soap11\fP
785.br
786.br
787.di
788.nr i| \n(dn
789.nr i- \n(dl
790..
791.ec \
792.eo
793.am 81
794.br
795.di j+
796.35
797.ft \n(.f
798.ll \n(34u*1u/4u
799.if \n(.l<\n(81 .ll \n(81u
800.in 0
801Used 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
802.br
803.br
804.di
805.nr j| \n(dn
806.nr j- \n(dl
807..
808.ec \
809.eo
810.am 81
811.br
812.di k+
813.35
814.ft \n(.f
815.ll \n(34u*1u/4u
816.if \n(.l<\n(81 .ll \n(81u
817.in 0
818Used 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
819.br
820.br
821.di
822.nr k| \n(dn
823.nr k- \n(dl
824..
825.ec \
826.eo
827.am 81
828.br
829.di l+
830.35
831.ft \n(.f
832.ll \n(34u*1u/4u
833.if \n(.l<\n(81 .ll \n(81u
834.in 0
835allow 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
836.br
837.di
838.nr l| \n(dn
839.nr l- \n(dl
840..
841.ec \
842.35
843.nf
844.ll \n(34u
845.nr 80 0
846.nr 38 \w\f3Attribute\fP
847.if \n(80<\n(38 .nr 80 \n(38
848.nr 38 \w\f2sei\fP
849.if \n(80<\n(38 .nr 80 \n(38
850.nr 38 \w\f2destdir\fP
851.if \n(80<\n(38 .nr 80 \n(38
852.nr 38 \w\f2classpath\fP
853.if \n(80<\n(38 .nr 80 \n(38
854.nr 38 \w\f2cp\fP
855.if \n(80<\n(38 .nr 80 \n(38
856.nr 38 \w\f2resourcedestdir\fP
857.if \n(80<\n(38 .nr 80 \n(38
858.nr 38 \w\f2sourcedestdir\fP
859.if \n(80<\n(38 .nr 80 \n(38
860.nr 38 \w\f2keep\fP
861.if \n(80<\n(38 .nr 80 \n(38
862.nr 38 \w\f2verbose\fP
863.if \n(80<\n(38 .nr 80 \n(38
864.nr 38 \w\f2genwsdl\fP
865.if \n(80<\n(38 .nr 80 \n(38
866.nr 38 \w\f2protocol\fP
867.if \n(80<\n(38 .nr 80 \n(38
868.nr 38 \w\f2servicename\fP
869.if \n(80<\n(38 .nr 80 \n(38
870.nr 38 \w\f2portname\fP
871.if \n(80<\n(38 .nr 80 \n(38
872.nr 38 \w\f2extension\fP
873.if \n(80<\n(38 .nr 80 \n(38
874.80
875.rm 80
876.nr 81 0
877.nr 38 \w\f3Description\fP
878.if \n(81<\n(38 .nr 81 \n(38
879.nr 38 \wSame as \f2\-classpath\fP
880.if \n(81<\n(38 .nr 81 \n(38
881.nr 38 \wKeep generated files
882.if \n(81<\n(38 .nr 81 \n(38
883.81
884.rm 81
885.nr 38 \n(a-
886.if \n(81<\n(38 .nr 81 \n(38
887.nr 38 \n(b-
888.if \n(81<\n(38 .nr 81 \n(38
889.nr 38 \n(c-
890.if \n(81<\n(38 .nr 81 \n(38
891.nr 38 \n(d-
892.if \n(81<\n(38 .nr 81 \n(38
893.nr 38 \n(e-
894.if \n(81<\n(38 .nr 81 \n(38
895.nr 38 \n(f-
896.if \n(81<\n(38 .nr 81 \n(38
897.nr 38 \n(g-
898.if \n(81<\n(38 .nr 81 \n(38
899.nr 38 \n(h-
900.if \n(81<\n(38 .nr 81 \n(38
901.nr 38 \n(j-
902.if \n(81<\n(38 .nr 81 \n(38
903.nr 38 \n(k-
904.if \n(81<\n(38 .nr 81 \n(38
905.nr 38 \n(l-
906.if \n(81<\n(38 .nr 81 \n(38
907.nr 82 0
908.nr 38 \w\f3Command line\fP
909.if \n(82<\n(38 .nr 82 \n(38
910.nr 38 \wSEI
911.if \n(82<\n(38 .nr 82 \n(38
912.nr 38 \w\f2\-d\fP
913.if \n(82<\n(38 .nr 82 \n(38
914.nr 38 \w\f2\-classpath\fP
915.if \n(82<\n(38 .nr 82 \n(38
916.nr 38 \w\f2\-cp\fP
917.if \n(82<\n(38 .nr 82 \n(38
918.nr 38 \w\f2\-r\fP
919.if \n(82<\n(38 .nr 82 \n(38
920.nr 38 \w\f2\-s\fP
921.if \n(82<\n(38 .nr 82 \n(38
922.nr 38 \w\f2\-keep\fP
923.if \n(82<\n(38 .nr 82 \n(38
924.nr 38 \w\f2\-verbose\fP
925.if \n(82<\n(38 .nr 82 \n(38
926.nr 38 \w\f2\-wsdl\fP
927.if \n(82<\n(38 .nr 82 \n(38
928.nr 38 \w\f2\-servicename\fP
929.if \n(82<\n(38 .nr 82 \n(38
930.nr 38 \w\f2\-servicename\fP
931.if \n(82<\n(38 .nr 82 \n(38
932.nr 38 \w\f2\-extension\fP
933.if \n(82<\n(38 .nr 82 \n(38
934.82
935.rm 82
936.nr 38 \n(i-
937.if \n(82<\n(38 .nr 82 \n(38
938.35
939.nf
940.ll \n(34u
941.nr 38 1n
942.nr 79 0
943.nr 40 \n(79+(0*\n(38)
944.nr 80 +\n(40
945.nr 41 \n(80+(3*\n(38)
946.nr 81 +\n(41
947.nr 42 \n(81+(3*\n(38)
948.nr 82 +\n(42
949.nr TW \n(82
950.if t .if \n(TW>\n(.li .tm Table at line 217 file Input is too wide - \n(TW units
951.fc  
952.nr #T 0-1
953.nr #a 0-1
954.eo
955.de T#
956.ds #d .d
957.if \(ts\n(.z\(ts\(ts .ds #d nl
958.mk ##
959.nr ## -1v
960.ls 1
961.ls
962..
963.ec
964.ta \n(80u \n(81u \n(82u
965.nr 31 \n(.f
966.nr 35 1m
967\&\h'|\n(40u'\f3Attribute\fP\h'|\n(41u'\f3Description\fP\h'|\n(42u'\f3Command line\fP
968.ne \n(a|u+\n(.Vu
969.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
970.ta \n(80u \n(81u \n(82u
971.nr 31 \n(.f
972.nr 35 1m
973\&\h'|\n(40u'\f2sei\fP\h'|\n(41u'\h'|\n(42u'SEI
974.mk ##
975.nr 31 \n(##
976.sp |\n(##u-1v
977.nr 37 \n(41u
978.in +\n(37u
979.a+
980.in -\n(37u
981.mk 32
982.if \n(32>\n(31 .nr 31 \n(32
983.sp |\n(31u
984.ne \n(b|u+\n(.Vu
985.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
986.ta \n(80u \n(81u \n(82u
987.nr 31 \n(.f
988.nr 35 1m
989\&\h'|\n(40u'\f2destdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-d\fP
990.mk ##
991.nr 31 \n(##
992.sp |\n(##u-1v
993.nr 37 \n(41u
994.in +\n(37u
995.b+
996.in -\n(37u
997.mk 32
998.if \n(32>\n(31 .nr 31 \n(32
999.sp |\n(31u
1000.ne \n(c|u+\n(.Vu
1001.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
1002.ta \n(80u \n(81u \n(82u
1003.nr 31 \n(.f
1004.nr 35 1m
1005\&\h'|\n(40u'\f2classpath\fP\h'|\n(41u'\h'|\n(42u'\f2\-classpath\fP
1006.mk ##
1007.nr 31 \n(##
1008.sp |\n(##u-1v
1009.nr 37 \n(41u
1010.in +\n(37u
1011.c+
1012.in -\n(37u
1013.mk 32
1014.if \n(32>\n(31 .nr 31 \n(32
1015.sp |\n(31u
1016.ta \n(80u \n(81u \n(82u
1017.nr 31 \n(.f
1018.nr 35 1m
1019\&\h'|\n(40u'\f2cp\fP\h'|\n(41u'Same as \f2\-classpath\fP\h'|\n(42u'\f2\-cp\fP
1020.ne \n(d|u+\n(.Vu
1021.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
1022.ta \n(80u \n(81u \n(82u
1023.nr 31 \n(.f
1024.nr 35 1m
1025\&\h'|\n(40u'\f2resourcedestdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-r\fP
1026.mk ##
1027.nr 31 \n(##
1028.sp |\n(##u-1v
1029.nr 37 \n(41u
1030.in +\n(37u
1031.d+
1032.in -\n(37u
1033.mk 32
1034.if \n(32>\n(31 .nr 31 \n(32
1035.sp |\n(31u
1036.ne \n(e|u+\n(.Vu
1037.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
1038.ta \n(80u \n(81u \n(82u
1039.nr 31 \n(.f
1040.nr 35 1m
1041\&\h'|\n(40u'\f2sourcedestdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-s\fP
1042.mk ##
1043.nr 31 \n(##
1044.sp |\n(##u-1v
1045.nr 37 \n(41u
1046.in +\n(37u
1047.e+
1048.in -\n(37u
1049.mk 32
1050.if \n(32>\n(31 .nr 31 \n(32
1051.sp |\n(31u
1052.ta \n(80u \n(81u \n(82u
1053.nr 31 \n(.f
1054.nr 35 1m
1055\&\h'|\n(40u'\f2keep\fP\h'|\n(41u'Keep generated files\h'|\n(42u'\f2\-keep\fP
1056.ne \n(f|u+\n(.Vu
1057.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
1058.ta \n(80u \n(81u \n(82u
1059.nr 31 \n(.f
1060.nr 35 1m
1061\&\h'|\n(40u'\f2verbose\fP\h'|\n(41u'\h'|\n(42u'\f2\-verbose\fP
1062.mk ##
1063.nr 31 \n(##
1064.sp |\n(##u-1v
1065.nr 37 \n(41u
1066.in +\n(37u
1067.f+
1068.in -\n(37u
1069.mk 32
1070.if \n(32>\n(31 .nr 31 \n(32
1071.sp |\n(31u
1072.ta \n(80u \n(81u \n(82u
1073.nr 31 \n(.f
1074.nr 35 1m
1075\&\h'|\n(40u'\f2genwsdl\fP\h'|\n(41u'\h'|\n(42u'
1076.br
1077.ne \n(g|u+\n(.Vu
1078.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
1079.ta \n(80u \n(81u \n(82u
1080.nr 31 \n(.f
1081.nr 35 1m
1082\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-wsdl\fP
1083.mk ##
1084.nr 31 \n(##
1085.sp |\n(##u-1v
1086.nr 37 \n(41u
1087.in +\n(37u
1088.g+
1089.in -\n(37u
1090.mk 32
1091.if \n(32>\n(31 .nr 31 \n(32
1092.sp |\n(31u
1093.ta \n(80u \n(81u \n(82u
1094.nr 31 \n(.f
1095.nr 35 1m
1096\&\h'|\n(40u'\f2protocol\fP\h'|\n(41u'\h'|\n(42u'
1097.br
1098.ne \n(h|u+\n(.Vu
1099.ne \n(i|u+\n(.Vu
1100.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
1101.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
1102.ta \n(80u \n(81u \n(82u
1103.nr 31 \n(.f
1104.nr 35 1m
1105\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
1106.mk ##
1107.nr 31 \n(##
1108.sp |\n(##u-1v
1109.nr 37 \n(41u
1110.in +\n(37u
1111.h+
1112.in -\n(37u
1113.mk 32
1114.if \n(32>\n(31 .nr 31 \n(32
1115.sp |\n(##u-1v
1116.nr 37 \n(42u
1117.in +\n(37u
1118.i+
1119.in -\n(37u
1120.mk 32
1121.if \n(32>\n(31 .nr 31 \n(32
1122.sp |\n(31u
1123.ta \n(80u \n(81u \n(82u
1124.nr 31 \n(.f
1125.nr 35 1m
1126\&\h'|\n(40u'\f2servicename\fP\h'|\n(41u'\h'|\n(42u'
1127.br
1128.ne \n(j|u+\n(.Vu
1129.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
1130.ta \n(80u \n(81u \n(82u
1131.nr 31 \n(.f
1132.nr 35 1m
1133\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-servicename\fP
1134.mk ##
1135.nr 31 \n(##
1136.sp |\n(##u-1v
1137.nr 37 \n(41u
1138.in +\n(37u
1139.j+
1140.in -\n(37u
1141.mk 32
1142.if \n(32>\n(31 .nr 31 \n(32
1143.sp |\n(31u
1144.ta \n(80u \n(81u \n(82u
1145.nr 31 \n(.f
1146.nr 35 1m
1147\&\h'|\n(40u'\f2portname\fP\h'|\n(41u'\h'|\n(42u'
1148.br
1149.ne \n(k|u+\n(.Vu
1150.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
1151.ta \n(80u \n(81u \n(82u
1152.nr 31 \n(.f
1153.nr 35 1m
1154\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-servicename\fP
1155.mk ##
1156.nr 31 \n(##
1157.sp |\n(##u-1v
1158.nr 37 \n(41u
1159.in +\n(37u
1160.k+
1161.in -\n(37u
1162.mk 32
1163.if \n(32>\n(31 .nr 31 \n(32
1164.sp |\n(31u
1165.ta \n(80u \n(81u \n(82u
1166.nr 31 \n(.f
1167.nr 35 1m
1168\&\h'|\n(40u'\f2extension\fP\h'|\n(41u'\h'|\n(42u'
1169.br
1170.ne \n(l|u+\n(.Vu
1171.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
1172.ta \n(80u \n(81u \n(82u
1173.nr 31 \n(.f
1174.nr 35 1m
1175\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-extension\fP
1176.mk ##
1177.nr 31 \n(##
1178.sp |\n(##u-1v
1179.nr 37 \n(41u
1180.in +\n(37u
1181.l+
1182.in -\n(37u
1183.mk 32
1184.if \n(32>\n(31 .nr 31 \n(32
1185.sp |\n(31u
1186.fc
1187.nr T. 1
1188.T# 1
1189.35
1190.rm a+
1191.rm b+
1192.rm c+
1193.rm d+
1194.rm e+
1195.rm f+
1196.rm g+
1197.rm h+
1198.rm i+
1199.rm j+
1200.rm k+
1201.rm l+
1202.TE
1203.if \n-(b.=0 .nr c. \n(.c-\n(d.-68
1204
1205.LP
1206.LP
1207The \f2classpath\fP attribute is a
1208.na
1209\f2path\-like structure\fP @
1210.fi
1211http://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:
1212.LP
1213.nf
1214\f3
1215.fl
1216 <taskdef name="wsgen" classname="com.sun.tools.ws.ant.WsGen">\fP
1217.br
1218\f3
1219.fl
1220 <classpath path="jaxws.classpath"/>\fP
1221.br
1222\f3
1223.fl
1224 </taskdef>
1225.fl
1226\fP
1227.fi
1228
1229.LP
1230.LP
1231where \f2jaxws.classpath\fP is a reference to a
1232.na
1233\f2path\-like structure\fP @
1234.fi
1235http://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.
1236.LP
1237.SH "Example"
1238.LP
1239
1240.LP
1241.nf
1242\f3
1243.fl
1244<wsgen
1245.fl
1246 resourcedestdir="${wsdl.dir}"
1247.fl
1248 sei="fromjava.server.AddNumbersImpl">
1249.fl
1250 <classpath refid="compile.classpath"/>
1251.fl
1252</wsgen>
1253.fl
1254\fP
1255.fi
1256
1257.LP
1258
1259.LP
1260