Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / libcore / 319a3b994703aac84df7bcde272adfcb3cdbbbf0 / . / jdk / src / linux / doc / man / wsgen.1
blob: e6181440718af491bd7aa558c9883179ea5b331d [file] [log] [blame]
J. Duke319a3b92007-12-01 00:00:00 +0000[diff] [blame^]1.'" t
2."
3." Copyright 2005-2006 Sun Microsystems, Inc. All Rights Reserved.
4." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5."
6." This code is free software; you can redistribute it and/or modify it
7." under the terms of the GNU General Public License version 2 only, as
8." published by the Free Software Foundation.
9."
10." This code is distributed in the hope that it will be useful, but WITHOUT
11." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
13." version 2 for more details (a copy is included in the LICENSE file that
14." accompanied this code).
15."
16." You should have received a copy of the GNU General Public License version
17." 2 along with this work; if not, write to the Free Software Foundation,
18." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
19."
20." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
21." CA 95054 USA or visit www.sun.com if you need additional information or
22." have any questions.
23."
24." `
25.TH wsgen 1 "07 Aug 2006"
26." Generated by html2man
27
28.LP
29.SH NAME
30wsgen \- JAX\-WS 2.0 Beta
31.LP
32.RS 3
33
34.LP
35.LP
36The \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.
37.LP
38.RE
39.SH "SYNOPSIS"
40.LP
41
42.LP
43.nf
44\f3
45.fl
46wsgen [options] <SEI>
47.fl
48\fP
49.fi
50
51.LP
52.SH "OPTIONS"
53.LP
54.LP
55The following table lists the \f2wsgen\fP options.
56.br
57
58.LP
59.LP
60Table 1\-1 wsgen Options
61.LP
62.LP
63.TS
64.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
65.de 35
66.ps \n(.s
67.vs \n(.vu
68.in \n(.iu
69.if \n(.u .fi
70.if \n(.j .ad
71.if \n(.j=0 .na
72..
73.nf
74.nr #~ 0
75.if n .nr #~ 0.6n
76.ds #d .d
77.if \(ts\n(.z\(ts\(ts .ds #d nl
78.fc
79.nr 33 \n(.s
80.rm 80 81
81.nr 34 \n(.lu
82.eo
83.am 81
84.br
85.di a+
86.35
87.ft \n(.f
88.ll \n(34u*1u/3u
89.if \n(.l<\n(81 .ll \n(81u
90.in 0
91Specify where to find input class files
92.br
93.di
94.nr a| \n(dn
95.nr a- \n(dl
96..
97.ec \
98.eo
99.am 81
100.br
101.di b+
102.35
103.ft \n(.f
104.ll \n(34u*1u/3u
105.if \n(.l<\n(81 .ll \n(81u
106.in 0
107Same as \f2\-classpath <path>\fP
108.br
109.di
110.nr b| \n(dn
111.nr b- \n(dl
112..
113.ec \
114.eo
115.am 81
116.br
117.di c+
118.35
119.ft \n(.f
120.ll \n(34u*1u/3u
121.if \n(.l<\n(81 .ll \n(81u
122.in 0
123Specify where to place generated output files
124.br
125.di
126.nr c| \n(dn
127.nr c- \n(dl
128..
129.ec \
130.eo
131.am 81
132.br
133.di d+
134.35
135.ft \n(.f
136.ll \n(34u*1u/3u
137.if \n(.l<\n(81 .ll \n(81u
138.in 0
139allow 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
140.br
141.di
142.nr d| \n(dn
143.nr d- \n(dl
144..
145.ec \
146.eo
147.am 81
148.br
149.di e+
150.35
151.ft \n(.f
152.ll \n(34u*1u/3u
153.if \n(.l<\n(81 .ll \n(81u
154.in 0
155Used only in conjunction with the \-wsdl option. Specify where to place generated resource files such as WSDLs
156.br
157.di
158.nr e| \n(dn
159.nr e- \n(dl
160..
161.ec \
162.eo
163.am 81
164.br
165.di f+
166.35
167.ft \n(.f
168.ll \n(34u*1u/3u
169.if \n(.l<\n(81 .ll \n(81u
170.in 0
171Specify where to place generated source files
172.br
173.di
174.nr f| \n(dn
175.nr f- \n(dl
176..
177.ec \
178.eo
179.am 81
180.br
181.di g+
182.35
183.ft \n(.f
184.ll \n(34u*1u/3u
185.if \n(.l<\n(81 .ll \n(81u
186.in 0
187Output messages about what the compiler is doing
188.br
189.di
190.nr g| \n(dn
191.nr g- \n(dl
192..
193.ec \
194.eo
195.am 81
196.br
197.di h+
198.35
199.ft \n(.f
200.ll \n(34u*1u/3u
201.if \n(.l<\n(81 .ll \n(81u
202.in 0
203Print version information. Use of this option will ONLY print version information. Normal processing will not occur.
204.br
205.di
206.nr h| \n(dn
207.nr h- \n(dl
208..
209.ec \
210.eo
211.am 80
212.br
213.di i+
214.35
215.ft \n(.f
216.ll \n(34u*1u/3u
217.if \n(.l<\n(80 .ll \n(80u
218.in 0
219\f2\-wsdl[:protocol]\fP
220.br
221.br
222.di
223.nr i| \n(dn
224.nr i- \n(dl
225..
226.ec \
227.eo
228.am 81
229.br
230.di j+
231.35
232.ft \n(.f
233.ll \n(34u*1u/3u
234.if \n(.l<\n(81 .ll \n(81u
235.in 0
236By 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.
237.br
238.br
239.di
240.nr j| \n(dn
241.nr j- \n(dl
242..
243.ec \
244.eo
245.am 81
246.br
247.di k+
248.35
249.ft \n(.f
250.ll \n(34u*1u/3u
251.if \n(.l<\n(81 .ll \n(81u
252.in 0
253Used 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
254.br
255.di
256.nr k| \n(dn
257.nr k- \n(dl
258..
259.ec \
260.eo
261.am 81
262.br
263.di l+
264.35
265.ft \n(.f
266.ll \n(34u*1u/3u
267.if \n(.l<\n(81 .ll \n(81u
268.in 0
269Used 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
270.br
271.br
272.di
273.nr l| \n(dn
274.nr l- \n(dl
275..
276.ec \
277.35
278.nf
279.ll \n(34u
280.nr 80 0
281.nr 38 \w\f3Option\fP
282.if \n(80<\n(38 .nr 80 \n(38
283.nr 38 \w\f2\-classpath <path>\fP
284.if \n(80<\n(38 .nr 80 \n(38
285.nr 38 \w\f2\-cp <path>\fP
286.if \n(80<\n(38 .nr 80 \n(38
287.nr 38 \w\f2\-d <directory>\fP
288.if \n(80<\n(38 .nr 80 \n(38
289.nr 38 \w\f2\-extension\fP
290.if \n(80<\n(38 .nr 80 \n(38
291.nr 38 \w\f2\-help\fP
292.if \n(80<\n(38 .nr 80 \n(38
293.nr 38 \w\f2\-keep\fP
294.if \n(80<\n(38 .nr 80 \n(38
295.nr 38 \w\f2\-r <directory>\fP
296.if \n(80<\n(38 .nr 80 \n(38
297.nr 38 \w\f2\-s <directory>\fP
298.if \n(80<\n(38 .nr 80 \n(38
299.nr 38 \w\f2\-verbose\fP
300.if \n(80<\n(38 .nr 80 \n(38
301.nr 38 \w\f2\-version\fP
302.if \n(80<\n(38 .nr 80 \n(38
303.nr 38 \w\f2\-servicename <name>\fP
304.if \n(80<\n(38 .nr 80 \n(38
305.nr 38 \w\f2\-portname <name>\fP
306.if \n(80<\n(38 .nr 80 \n(38
307.80
308.rm 80
309.nr 38 \n(i-
310.if \n(80<\n(38 .nr 80 \n(38
311.nr 81 0
312.nr 38 \w\f3Description\fP
313.if \n(81<\n(38 .nr 81 \n(38
314.nr 38 \wDisplay help
315.if \n(81<\n(38 .nr 81 \n(38
316.nr 38 \wKeep generated files
317.if \n(81<\n(38 .nr 81 \n(38
318.81
319.rm 81
320.nr 38 \n(a-
321.if \n(81<\n(38 .nr 81 \n(38
322.nr 38 \n(b-
323.if \n(81<\n(38 .nr 81 \n(38
324.nr 38 \n(c-
325.if \n(81<\n(38 .nr 81 \n(38
326.nr 38 \n(d-
327.if \n(81<\n(38 .nr 81 \n(38
328.nr 38 \n(e-
329.if \n(81<\n(38 .nr 81 \n(38
330.nr 38 \n(f-
331.if \n(81<\n(38 .nr 81 \n(38
332.nr 38 \n(g-
333.if \n(81<\n(38 .nr 81 \n(38
334.nr 38 \n(h-
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.nr 38 \n(l-
341.if \n(81<\n(38 .nr 81 \n(38
342.35
343.nf
344.ll \n(34u
345.nr 38 1n
346.nr 79 0
347.nr 40 \n(79+(0*\n(38)
348.nr 80 +\n(40
349.nr 41 \n(80+(3*\n(38)
350.nr 81 +\n(41
351.nr TW \n(81
352.if t .if \n(TW>\n(.li .tm Table at line 100 file Input is too wide - \n(TW units
353.fc  
354.nr #T 0-1
355.nr #a 0-1
356.eo
357.de T#
358.ds #d .d
359.if \(ts\n(.z\(ts\(ts .ds #d nl
360.mk ##
361.nr ## -1v
362.ls 1
363.ls
364..
365.ec
366.ta \n(80u \n(81u
367.nr 31 \n(.f
368.nr 35 1m
369\&\h'|\n(40u'\f3Option\fP\h'|\n(41u'\f3Description\fP
370.ne \n(a|u+\n(.Vu
371.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
372.ta \n(80u \n(81u
373.nr 31 \n(.f
374.nr 35 1m
375\&\h'|\n(40u'\f2\-classpath <path>\fP\h'|\n(41u'
376.mk ##
377.nr 31 \n(##
378.sp |\n(##u-1v
379.nr 37 \n(41u
380.in +\n(37u
381.a+
382.in -\n(37u
383.mk 32
384.if \n(32>\n(31 .nr 31 \n(32
385.sp |\n(31u
386.ne \n(b|u+\n(.Vu
387.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
388.ta \n(80u \n(81u
389.nr 31 \n(.f
390.nr 35 1m
391\&\h'|\n(40u'\f2\-cp <path>\fP\h'|\n(41u'
392.mk ##
393.nr 31 \n(##
394.sp |\n(##u-1v
395.nr 37 \n(41u
396.in +\n(37u
397.b+
398.in -\n(37u
399.mk 32
400.if \n(32>\n(31 .nr 31 \n(32
401.sp |\n(31u
402.ne \n(c|u+\n(.Vu
403.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
404.ta \n(80u \n(81u
405.nr 31 \n(.f
406.nr 35 1m
407\&\h'|\n(40u'\f2\-d <directory>\fP\h'|\n(41u'
408.mk ##
409.nr 31 \n(##
410.sp |\n(##u-1v
411.nr 37 \n(41u
412.in +\n(37u
413.c+
414.in -\n(37u
415.mk 32
416.if \n(32>\n(31 .nr 31 \n(32
417.sp |\n(31u
418.ne \n(d|u+\n(.Vu
419.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
420.ta \n(80u \n(81u
421.nr 31 \n(.f
422.nr 35 1m
423\&\h'|\n(40u'\f2\-extension\fP\h'|\n(41u'
424.mk ##
425.nr 31 \n(##
426.sp |\n(##u-1v
427.nr 37 \n(41u
428.in +\n(37u
429.d+
430.in -\n(37u
431.mk 32
432.if \n(32>\n(31 .nr 31 \n(32
433.sp |\n(31u
434.ta \n(80u \n(81u
435.nr 31 \n(.f
436.nr 35 1m
437\&\h'|\n(40u'\f2\-help\fP\h'|\n(41u'Display help
438.ta \n(80u \n(81u
439.nr 31 \n(.f
440.nr 35 1m
441\&\h'|\n(40u'\f2\-keep\fP\h'|\n(41u'Keep generated files
442.ne \n(e|u+\n(.Vu
443.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
444.ta \n(80u \n(81u
445.nr 31 \n(.f
446.nr 35 1m
447\&\h'|\n(40u'\f2\-r <directory>\fP\h'|\n(41u'
448.mk ##
449.nr 31 \n(##
450.sp |\n(##u-1v
451.nr 37 \n(41u
452.in +\n(37u
453.e+
454.in -\n(37u
455.mk 32
456.if \n(32>\n(31 .nr 31 \n(32
457.sp |\n(31u
458.ne \n(f|u+\n(.Vu
459.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
460.ta \n(80u \n(81u
461.nr 31 \n(.f
462.nr 35 1m
463\&\h'|\n(40u'\f2\-s <directory>\fP\h'|\n(41u'
464.mk ##
465.nr 31 \n(##
466.sp |\n(##u-1v
467.nr 37 \n(41u
468.in +\n(37u
469.f+
470.in -\n(37u
471.mk 32
472.if \n(32>\n(31 .nr 31 \n(32
473.sp |\n(31u
474.ne \n(g|u+\n(.Vu
475.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
476.ta \n(80u \n(81u
477.nr 31 \n(.f
478.nr 35 1m
479\&\h'|\n(40u'\f2\-verbose\fP\h'|\n(41u'
480.mk ##
481.nr 31 \n(##
482.sp |\n(##u-1v
483.nr 37 \n(41u
484.in +\n(37u
485.g+
486.in -\n(37u
487.mk 32
488.if \n(32>\n(31 .nr 31 \n(32
489.sp |\n(31u
490.ne \n(h|u+\n(.Vu
491.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
492.ta \n(80u \n(81u
493.nr 31 \n(.f
494.nr 35 1m
495\&\h'|\n(40u'\f2\-version\fP\h'|\n(41u'
496.mk ##
497.nr 31 \n(##
498.sp |\n(##u-1v
499.nr 37 \n(41u
500.in +\n(37u
501.h+
502.in -\n(37u
503.mk 32
504.if \n(32>\n(31 .nr 31 \n(32
505.sp |\n(31u
506.ne \n(i|u+\n(.Vu
507.ne \n(j|u+\n(.Vu
508.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
509.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
510.ta \n(80u \n(81u
511.nr 31 \n(.f
512.nr 35 1m
513\&\h'|\n(40u'\h'|\n(41u'
514.mk ##
515.nr 31 \n(##
516.sp |\n(##u-1v
517.nr 37 \n(40u
518.in +\n(37u
519.i+
520.in -\n(37u
521.mk 32
522.if \n(32>\n(31 .nr 31 \n(32
523.sp |\n(##u-1v
524.nr 37 \n(41u
525.in +\n(37u
526.j+
527.in -\n(37u
528.mk 32
529.if \n(32>\n(31 .nr 31 \n(32
530.sp |\n(31u
531.ne \n(k|u+\n(.Vu
532.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
533.ta \n(80u \n(81u
534.nr 31 \n(.f
535.nr 35 1m
536\&\h'|\n(40u'\f2\-servicename <name>\fP\h'|\n(41u'
537.mk ##
538.nr 31 \n(##
539.sp |\n(##u-1v
540.nr 37 \n(41u
541.in +\n(37u
542.k+
543.in -\n(37u
544.mk 32
545.if \n(32>\n(31 .nr 31 \n(32
546.sp |\n(31u
547.ne \n(l|u+\n(.Vu
548.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
549.ta \n(80u \n(81u
550.nr 31 \n(.f
551.nr 35 1m
552\&\h'|\n(40u'\f2\-portname <name>\fP\h'|\n(41u'
553.mk ##
554.nr 31 \n(##
555.sp |\n(##u-1v
556.nr 37 \n(41u
557.in +\n(37u
558.l+
559.in -\n(37u
560.mk 32
561.if \n(32>\n(31 .nr 31 \n(32
562.sp |\n(31u
563.fc
564.nr T. 1
565.T# 1
566.35
567.rm a+
568.rm b+
569.rm c+
570.rm d+
571.rm e+
572.rm f+
573.rm g+
574.rm h+
575.rm i+
576.rm j+
577.rm k+
578.rm l+
579.TE
580.if \n-(b.=0 .nr c. \n(.c-\n(d.-57
581
582.LP
583.SS
584Ant task
585.LP
586.LP
587An 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:
588.LP
589.nf
590\f3
591.fl
592
593.fl
594 <wsgen
595.fl
596 sei="..."
597.fl
598 destdir="directory for generated class files"
599.fl
600 classpath="classpath" | cp="classpath"
601.fl
602 resourcedestdir="directory for generated resource files such as WSDLs"
603.fl
604 sourcedestdir="directory for generated source files"
605.fl
606 keep="true|false"
607.fl
608 verbose="true|false"
609.fl
610 genwsdl="true|false"
611.fl
612 protocol="soap1.1|Xsoap1.2"
613.fl
614 servicename="..."
615.fl
616 portname="...">
617.fl
618 extension="true|false"
619.fl
620 <classpath refid="..."/>
621.fl
622 </wsgen>
623.fl
624\fP
625.fi
626
627.LP
628.LP
629.TS
630.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
631.de 35
632.ps \n(.s
633.vs \n(.vu
634.in \n(.iu
635.if \n(.u .fi
636.if \n(.j .ad
637.if \n(.j=0 .na
638..
639.nf
640.nr #~ 0
641.if n .nr #~ 0.6n
642.ds #d .d
643.if \(ts\n(.z\(ts\(ts .ds #d nl
644.fc
645.nr 33 \n(.s
646.rm 80 81 82
647.nr 34 \n(.lu
648.eo
649.am 81
650.br
651.di a+
652.35
653.ft \n(.f
654.ll \n(34u*1u/4u
655.if \n(.l<\n(81 .ll \n(81u
656.in 0
657Name of the service endpoint implementation class
658.br
659.di
660.nr a| \n(dn
661.nr a- \n(dl
662..
663.ec \
664.eo
665.am 81
666.br
667.di b+
668.35
669.ft \n(.f
670.ll \n(34u*1u/4u
671.if \n(.l<\n(81 .ll \n(81u
672.in 0
673Specify where to place output generated classes
674.br
675.di
676.nr b| \n(dn
677.nr b- \n(dl
678..
679.ec \
680.eo
681.am 81
682.br
683.di c+
684.35
685.ft \n(.f
686.ll \n(34u*1u/4u
687.if \n(.l<\n(81 .ll \n(81u
688.in 0
689Specify where to find input class files
690.br
691.di
692.nr c| \n(dn
693.nr c- \n(dl
694..
695.ec \
696.eo
697.am 81
698.br
699.di d+
700.35
701.ft \n(.f
702.ll \n(34u*1u/4u
703.if \n(.l<\n(81 .ll \n(81u
704.in 0
705Used only in conjunction with the \-wsdl option. Specify where to place generated resource files such as WSDLs
706.br
707.di
708.nr d| \n(dn
709.nr d- \n(dl
710..
711.ec \
712.eo
713.am 81
714.br
715.di e+
716.35
717.ft \n(.f
718.ll \n(34u*1u/4u
719.if \n(.l<\n(81 .ll \n(81u
720.in 0
721Specify where to place generated source files
722.br
723.di
724.nr e| \n(dn
725.nr e- \n(dl
726..
727.ec \
728.eo
729.am 81
730.br
731.di f+
732.35
733.ft \n(.f
734.ll \n(34u*1u/4u
735.if \n(.l<\n(81 .ll \n(81u
736.in 0
737Output messages about what the compiler is doing
738.br
739.di
740.nr f| \n(dn
741.nr f- \n(dl
742..
743.ec \
744.eo
745.am 81
746.br
747.di g+
748.35
749.ft \n(.f
750.ll \n(34u*1u/4u
751.if \n(.l<\n(81 .ll \n(81u
752.in 0
753Specify that a WSDL file should be generated
754.br
755.di
756.nr g| \n(dn
757.nr g- \n(dl
758..
759.ec \
760.eo
761.am 81
762.br
763.di h+
764.35
765.ft \n(.f
766.ll \n(34u*1u/4u
767.if \n(.l<\n(81 .ll \n(81u
768.in 0
769Used 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
770.br
771.br
772.di
773.nr h| \n(dn
774.nr h- \n(dl
775..
776.ec \
777.eo
778.am 82
779.br
780.di i+
781.35
782.ft \n(.f
783.ll \n(34u*1u/4u
784.if \n(.l<\n(82 .ll \n(82u
785.in 0
786\f2\-wsdl:soap11\fP
787.br
788.br
789.di
790.nr i| \n(dn
791.nr i- \n(dl
792..
793.ec \
794.eo
795.am 81
796.br
797.di j+
798.35
799.ft \n(.f
800.ll \n(34u*1u/4u
801.if \n(.l<\n(81 .ll \n(81u
802.in 0
803Used 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
804.br
805.br
806.di
807.nr j| \n(dn
808.nr j- \n(dl
809..
810.ec \
811.eo
812.am 81
813.br
814.di k+
815.35
816.ft \n(.f
817.ll \n(34u*1u/4u
818.if \n(.l<\n(81 .ll \n(81u
819.in 0
820Used 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
821.br
822.br
823.di
824.nr k| \n(dn
825.nr k- \n(dl
826..
827.ec \
828.eo
829.am 81
830.br
831.di l+
832.35
833.ft \n(.f
834.ll \n(34u*1u/4u
835.if \n(.l<\n(81 .ll \n(81u
836.in 0
837allow 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
838.br
839.di
840.nr l| \n(dn
841.nr l- \n(dl
842..
843.ec \
844.35
845.nf
846.ll \n(34u
847.nr 80 0
848.nr 38 \w\f3Attribute\fP
849.if \n(80<\n(38 .nr 80 \n(38
850.nr 38 \w\f2sei\fP
851.if \n(80<\n(38 .nr 80 \n(38
852.nr 38 \w\f2destdir\fP
853.if \n(80<\n(38 .nr 80 \n(38
854.nr 38 \w\f2classpath\fP
855.if \n(80<\n(38 .nr 80 \n(38
856.nr 38 \w\f2cp\fP
857.if \n(80<\n(38 .nr 80 \n(38
858.nr 38 \w\f2resourcedestdir\fP
859.if \n(80<\n(38 .nr 80 \n(38
860.nr 38 \w\f2sourcedestdir\fP
861.if \n(80<\n(38 .nr 80 \n(38
862.nr 38 \w\f2keep\fP
863.if \n(80<\n(38 .nr 80 \n(38
864.nr 38 \w\f2verbose\fP
865.if \n(80<\n(38 .nr 80 \n(38
866.nr 38 \w\f2genwsdl\fP
867.if \n(80<\n(38 .nr 80 \n(38
868.nr 38 \w\f2protocol\fP
869.if \n(80<\n(38 .nr 80 \n(38
870.nr 38 \w\f2servicename\fP
871.if \n(80<\n(38 .nr 80 \n(38
872.nr 38 \w\f2portname\fP
873.if \n(80<\n(38 .nr 80 \n(38
874.nr 38 \w\f2extension\fP
875.if \n(80<\n(38 .nr 80 \n(38
876.80
877.rm 80
878.nr 81 0
879.nr 38 \w\f3Description\fP
880.if \n(81<\n(38 .nr 81 \n(38
881.nr 38 \wSame as \f2\-classpath\fP
882.if \n(81<\n(38 .nr 81 \n(38
883.nr 38 \wKeep generated files
884.if \n(81<\n(38 .nr 81 \n(38
885.81
886.rm 81
887.nr 38 \n(a-
888.if \n(81<\n(38 .nr 81 \n(38
889.nr 38 \n(b-
890.if \n(81<\n(38 .nr 81 \n(38
891.nr 38 \n(c-
892.if \n(81<\n(38 .nr 81 \n(38
893.nr 38 \n(d-
894.if \n(81<\n(38 .nr 81 \n(38
895.nr 38 \n(e-
896.if \n(81<\n(38 .nr 81 \n(38
897.nr 38 \n(f-
898.if \n(81<\n(38 .nr 81 \n(38
899.nr 38 \n(g-
900.if \n(81<\n(38 .nr 81 \n(38
901.nr 38 \n(h-
902.if \n(81<\n(38 .nr 81 \n(38
903.nr 38 \n(j-
904.if \n(81<\n(38 .nr 81 \n(38
905.nr 38 \n(k-
906.if \n(81<\n(38 .nr 81 \n(38
907.nr 38 \n(l-
908.if \n(81<\n(38 .nr 81 \n(38
909.nr 82 0
910.nr 38 \w\f3Command line\fP
911.if \n(82<\n(38 .nr 82 \n(38
912.nr 38 \wSEI
913.if \n(82<\n(38 .nr 82 \n(38
914.nr 38 \w\f2\-d\fP
915.if \n(82<\n(38 .nr 82 \n(38
916.nr 38 \w\f2\-classpath\fP
917.if \n(82<\n(38 .nr 82 \n(38
918.nr 38 \w\f2\-cp\fP
919.if \n(82<\n(38 .nr 82 \n(38
920.nr 38 \w\f2\-r\fP
921.if \n(82<\n(38 .nr 82 \n(38
922.nr 38 \w\f2\-s\fP
923.if \n(82<\n(38 .nr 82 \n(38
924.nr 38 \w\f2\-keep\fP
925.if \n(82<\n(38 .nr 82 \n(38
926.nr 38 \w\f2\-verbose\fP
927.if \n(82<\n(38 .nr 82 \n(38
928.nr 38 \w\f2\-wsdl\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\-servicename\fP
933.if \n(82<\n(38 .nr 82 \n(38
934.nr 38 \w\f2\-extension\fP
935.if \n(82<\n(38 .nr 82 \n(38
936.82
937.rm 82
938.nr 38 \n(i-
939.if \n(82<\n(38 .nr 82 \n(38
940.35
941.nf
942.ll \n(34u
943.nr 38 1n
944.nr 79 0
945.nr 40 \n(79+(0*\n(38)
946.nr 80 +\n(40
947.nr 41 \n(80+(3*\n(38)
948.nr 81 +\n(41
949.nr 42 \n(81+(3*\n(38)
950.nr 82 +\n(42
951.nr TW \n(82
952.if t .if \n(TW>\n(.li .tm Table at line 217 file Input is too wide - \n(TW units
953.fc  
954.nr #T 0-1
955.nr #a 0-1
956.eo
957.de T#
958.ds #d .d
959.if \(ts\n(.z\(ts\(ts .ds #d nl
960.mk ##
961.nr ## -1v
962.ls 1
963.ls
964..
965.ec
966.ta \n(80u \n(81u \n(82u
967.nr 31 \n(.f
968.nr 35 1m
969\&\h'|\n(40u'\f3Attribute\fP\h'|\n(41u'\f3Description\fP\h'|\n(42u'\f3Command line\fP
970.ne \n(a|u+\n(.Vu
971.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
972.ta \n(80u \n(81u \n(82u
973.nr 31 \n(.f
974.nr 35 1m
975\&\h'|\n(40u'\f2sei\fP\h'|\n(41u'\h'|\n(42u'SEI
976.mk ##
977.nr 31 \n(##
978.sp |\n(##u-1v
979.nr 37 \n(41u
980.in +\n(37u
981.a+
982.in -\n(37u
983.mk 32
984.if \n(32>\n(31 .nr 31 \n(32
985.sp |\n(31u
986.ne \n(b|u+\n(.Vu
987.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
988.ta \n(80u \n(81u \n(82u
989.nr 31 \n(.f
990.nr 35 1m
991\&\h'|\n(40u'\f2destdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-d\fP
992.mk ##
993.nr 31 \n(##
994.sp |\n(##u-1v
995.nr 37 \n(41u
996.in +\n(37u
997.b+
998.in -\n(37u
999.mk 32
1000.if \n(32>\n(31 .nr 31 \n(32
1001.sp |\n(31u
1002.ne \n(c|u+\n(.Vu
1003.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
1004.ta \n(80u \n(81u \n(82u
1005.nr 31 \n(.f
1006.nr 35 1m
1007\&\h'|\n(40u'\f2classpath\fP\h'|\n(41u'\h'|\n(42u'\f2\-classpath\fP
1008.mk ##
1009.nr 31 \n(##
1010.sp |\n(##u-1v
1011.nr 37 \n(41u
1012.in +\n(37u
1013.c+
1014.in -\n(37u
1015.mk 32
1016.if \n(32>\n(31 .nr 31 \n(32
1017.sp |\n(31u
1018.ta \n(80u \n(81u \n(82u
1019.nr 31 \n(.f
1020.nr 35 1m
1021\&\h'|\n(40u'\f2cp\fP\h'|\n(41u'Same as \f2\-classpath\fP\h'|\n(42u'\f2\-cp\fP
1022.ne \n(d|u+\n(.Vu
1023.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
1024.ta \n(80u \n(81u \n(82u
1025.nr 31 \n(.f
1026.nr 35 1m
1027\&\h'|\n(40u'\f2resourcedestdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-r\fP
1028.mk ##
1029.nr 31 \n(##
1030.sp |\n(##u-1v
1031.nr 37 \n(41u
1032.in +\n(37u
1033.d+
1034.in -\n(37u
1035.mk 32
1036.if \n(32>\n(31 .nr 31 \n(32
1037.sp |\n(31u
1038.ne \n(e|u+\n(.Vu
1039.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
1040.ta \n(80u \n(81u \n(82u
1041.nr 31 \n(.f
1042.nr 35 1m
1043\&\h'|\n(40u'\f2sourcedestdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-s\fP
1044.mk ##
1045.nr 31 \n(##
1046.sp |\n(##u-1v
1047.nr 37 \n(41u
1048.in +\n(37u
1049.e+
1050.in -\n(37u
1051.mk 32
1052.if \n(32>\n(31 .nr 31 \n(32
1053.sp |\n(31u
1054.ta \n(80u \n(81u \n(82u
1055.nr 31 \n(.f
1056.nr 35 1m
1057\&\h'|\n(40u'\f2keep\fP\h'|\n(41u'Keep generated files\h'|\n(42u'\f2\-keep\fP
1058.ne \n(f|u+\n(.Vu
1059.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
1060.ta \n(80u \n(81u \n(82u
1061.nr 31 \n(.f
1062.nr 35 1m
1063\&\h'|\n(40u'\f2verbose\fP\h'|\n(41u'\h'|\n(42u'\f2\-verbose\fP
1064.mk ##
1065.nr 31 \n(##
1066.sp |\n(##u-1v
1067.nr 37 \n(41u
1068.in +\n(37u
1069.f+
1070.in -\n(37u
1071.mk 32
1072.if \n(32>\n(31 .nr 31 \n(32
1073.sp |\n(31u
1074.ta \n(80u \n(81u \n(82u
1075.nr 31 \n(.f
1076.nr 35 1m
1077\&\h'|\n(40u'\f2genwsdl\fP\h'|\n(41u'\h'|\n(42u'
1078.br
1079.ne \n(g|u+\n(.Vu
1080.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
1081.ta \n(80u \n(81u \n(82u
1082.nr 31 \n(.f
1083.nr 35 1m
1084\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-wsdl\fP
1085.mk ##
1086.nr 31 \n(##
1087.sp |\n(##u-1v
1088.nr 37 \n(41u
1089.in +\n(37u
1090.g+
1091.in -\n(37u
1092.mk 32
1093.if \n(32>\n(31 .nr 31 \n(32
1094.sp |\n(31u
1095.ta \n(80u \n(81u \n(82u
1096.nr 31 \n(.f
1097.nr 35 1m
1098\&\h'|\n(40u'\f2protocol\fP\h'|\n(41u'\h'|\n(42u'
1099.br
1100.ne \n(h|u+\n(.Vu
1101.ne \n(i|u+\n(.Vu
1102.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
1103.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
1104.ta \n(80u \n(81u \n(82u
1105.nr 31 \n(.f
1106.nr 35 1m
1107\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
1108.mk ##
1109.nr 31 \n(##
1110.sp |\n(##u-1v
1111.nr 37 \n(41u
1112.in +\n(37u
1113.h+
1114.in -\n(37u
1115.mk 32
1116.if \n(32>\n(31 .nr 31 \n(32
1117.sp |\n(##u-1v
1118.nr 37 \n(42u
1119.in +\n(37u
1120.i+
1121.in -\n(37u
1122.mk 32
1123.if \n(32>\n(31 .nr 31 \n(32
1124.sp |\n(31u
1125.ta \n(80u \n(81u \n(82u
1126.nr 31 \n(.f
1127.nr 35 1m
1128\&\h'|\n(40u'\f2servicename\fP\h'|\n(41u'\h'|\n(42u'
1129.br
1130.ne \n(j|u+\n(.Vu
1131.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
1132.ta \n(80u \n(81u \n(82u
1133.nr 31 \n(.f
1134.nr 35 1m
1135\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-servicename\fP
1136.mk ##
1137.nr 31 \n(##
1138.sp |\n(##u-1v
1139.nr 37 \n(41u
1140.in +\n(37u
1141.j+
1142.in -\n(37u
1143.mk 32
1144.if \n(32>\n(31 .nr 31 \n(32
1145.sp |\n(31u
1146.ta \n(80u \n(81u \n(82u
1147.nr 31 \n(.f
1148.nr 35 1m
1149\&\h'|\n(40u'\f2portname\fP\h'|\n(41u'\h'|\n(42u'
1150.br
1151.ne \n(k|u+\n(.Vu
1152.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
1153.ta \n(80u \n(81u \n(82u
1154.nr 31 \n(.f
1155.nr 35 1m
1156\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-servicename\fP
1157.mk ##
1158.nr 31 \n(##
1159.sp |\n(##u-1v
1160.nr 37 \n(41u
1161.in +\n(37u
1162.k+
1163.in -\n(37u
1164.mk 32
1165.if \n(32>\n(31 .nr 31 \n(32
1166.sp |\n(31u
1167.ta \n(80u \n(81u \n(82u
1168.nr 31 \n(.f
1169.nr 35 1m
1170\&\h'|\n(40u'\f2extension\fP\h'|\n(41u'\h'|\n(42u'
1171.br
1172.ne \n(l|u+\n(.Vu
1173.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
1174.ta \n(80u \n(81u \n(82u
1175.nr 31 \n(.f
1176.nr 35 1m
1177\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-extension\fP
1178.mk ##
1179.nr 31 \n(##
1180.sp |\n(##u-1v
1181.nr 37 \n(41u
1182.in +\n(37u
1183.l+
1184.in -\n(37u
1185.mk 32
1186.if \n(32>\n(31 .nr 31 \n(32
1187.sp |\n(31u
1188.fc
1189.nr T. 1
1190.T# 1
1191.35
1192.rm a+
1193.rm b+
1194.rm c+
1195.rm d+
1196.rm e+
1197.rm f+
1198.rm g+
1199.rm h+
1200.rm i+
1201.rm j+
1202.rm k+
1203.rm l+
1204.TE
1205.if \n-(b.=0 .nr c. \n(.c-\n(d.-68
1206
1207.LP
1208.LP
1209The \f2classpath\fP attribute is a
1210.na
1211\f2path\-like structure\fP @
1212.fi
1213http://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:
1214.LP
1215.nf
1216\f3
1217.fl
1218 <taskdef name="wsgen" classname="com.sun.tools.ws.ant.WsGen">\fP
1219.br
1220\f3
1221.fl
1222 <classpath path="jaxws.classpath"/>\fP
1223.br
1224\f3
1225.fl
1226 </taskdef>
1227.fl
1228\fP
1229.fi
1230
1231.LP
1232.LP
1233where \f2jaxws.classpath\fP is a reference to a
1234.na
1235\f2path\-like structure\fP @
1236.fi
1237http://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.
1238.LP
1239.SH "Example"
1240.LP
1241
1242.LP
1243.nf
1244\f3
1245.fl
1246<wsgen
1247.fl
1248 resourcedestdir="${wsdl.dir}"
1249.fl
1250 sei="fromjava.server.AddNumbersImpl">
1251.fl
1252 <classpath refid="compile.classpath"/>
1253.fl
1254</wsgen>
1255.fl
1256\fP
1257.fi
1258
1259.LP
1260
1261.LP
1262