1 ." Copyright (c) 2005, 2011, Oracle and/or its affiliates. All rights reserved.
2 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
3 ."
4 ." This code is free software; you can redistribute it and/or modify it
5 ." under the terms of the GNU General Public License version 2 only, as
6 ." published by the Free Software Foundation.
7 ."
8 ." This code is distributed in the hope that it will be useful, but WITHOUT
9 ." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10 ." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
11 ." version 2 for more details (a copy is included in the LICENSE file that
12 ." accompanied this code).
13 ."
14 ." You should have received a copy of the GNU General Public License version
15 ." 2 along with this work; if not, write to the Free Software Foundation,
16 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
17 ."
18 ." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
19 ." or visit www.oracle.com if you need additional information or have any
20 ." questions.
21 ."
22 .TH wsgen 1 "07 May 2011"
23 .SH "名前"
24 wsgen \- XML Web Services (JAX\-WS) 2.0 のための Java(TM) API
25 .LP
26 \f3仕様バージョン:\fP 2.1
27 .br
28 \f3実装バージョン:\fP 2.1.1
29 .LP
30 \f2wsgen\fP ツールは、JAX\-WS Web サービスで使用される JAX\-WS ポータブルアーティファクトを生成します。このツールは、Web サービスのエンドポイント実装クラス (SEI) を読み取り、Web サービスの配備と呼び出しに必要なすべてのアーティファクトを生成します。
31 .SH "概要"
32 .LP
33 \f2wsgen\fP ツールは、JAX\-WS Web サービスで使用される JAX\-WS ポータブルアーティファクトを生成します。このツールは、Web サービスのエンドポイントクラスを読み取り、Web サービスの配備と呼び出しに必要なすべてのアーティファクトを生成します。JAXWS 2.1.1 RI には wsgen Ant タスクも用意されています。詳細は、
34 .na
35 \f2Wsgen Ant タスク\fP @
36 .fi
37 https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsgenant.htmlを参照してください。
38 .LP
39 .SH "wsgen の起動"
40 .RS 3
41 .TP 2
42 o
43 \f3Solaris/Linux\fP
44 .RS 3
45 .TP 2
46 *
47 \f2export JAXWS_HOME=/pathto/jaxws\-ri\fP
48 .TP 2
49 *
50 \f2$JAXWS_HOME/bin/wsgen.sh \-help\fP
51 .RE
52 .TP 2
53 o
54 \f3Windows\fP
55 .RS 3
56 .TP 2
57 *
58 \f2set JAXWS_HOME=c:\\pathto\\jaxws\-ri\fP
59 .TP 2
60 *
61 \f2%JAXWS_HOME%\\bin\\wsgen.bat \-help\fP
62 .RE
63 .RE
64
65 .LP
66 .SH "構文"
67 .nf
68 \f3
69 .fl
70 wsgen [options] <SEI>\fP
71 .br
72 \f3
73 .fl
74 \fP
75 .fi
76 .LP
77 次の表に、 \f2wsgen\fP のオプションを示します。
78 .br
79 .LP
80 .TS
81 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
82 .de 35
83 .ps \n(.s
84 .vs \n(.vu
85 .in \n(.iu
86 .if \n(.u .fi
87 .if \n(.j .ad
88 .if \n(.j=0 .na
89 ..
90 .nf
91 .nr #~ 0
92 .if n .nr #~ 0.6n
93 .ds #d .d
94 .if \(ts\n(.z\(ts\(ts .ds #d nl
95 .fc
96 .nr 33 \n(.s
97 .rm 80 81
98 .nr 34 \n(.lu
99 .eo
100 .am 81
101 .br
102 .di a+
103 .35
104 .ft \n(.f
105 .ll \n(34u*1u/3u
106 .if \n(.l<\n(81 .ll \n(81u
107 .in 0
108 入力クラスファイルの検索場所を指定します
109 .br
110 .di
111 .nr a| \n(dn
112 .nr a- \n(dl
113 ..
114 .ec \
115 .eo
116 .am 81
117 .br
118 .di b+
119 .35
120 .ft \n(.f
121 .ll \n(34u*1u/3u
122 .if \n(.l<\n(81 .ll \n(81u
123 .in 0
124 \-classpath <path> \f2と同じです\fP
125 .br
126 .di
127 .nr b| \n(dn
128 .nr b- \n(dl
129 ..
130 .ec \
131 .eo
132 .am 81
133 .br
134 .di c+
135 .35
136 .ft \n(.f
137 .ll \n(34u*1u/3u
138 .if \n(.l<\n(81 .ll \n(81u
139 .in 0
140 生成される出力ファイルを格納する場所を指定します
141 .br
142 .di
143 .nr c| \n(dn
144 .nr c- \n(dl
145 ..
146 .ec \
147 .eo
148 .am 81
149 .br
150 .di d+
151 .35
152 .ft \n(.f
153 .ll \n(34u*1u/3u
154 .if \n(.l<\n(81 .ll \n(81u
155 .in 0
156 ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可性があります
157 .br
158 .di
159 .nr d| \n(dn
160 .nr d- \n(dl
161 ..
162 .ec \
163 .eo
164 .am 81
165 .br
166 .di e+
167 .35
168 .ft \n(.f
169 .ll \n(34u*1u/3u
170 .if \n(.l<\n(81 .ll \n(81u
171 .in 0
172 ヘルプを表示します
173 .br
174 .di
175 .nr e| \n(dn
176 .nr e- \n(dl
177 ..
178 .ec \
179 .eo
180 .am 81
181 .br
182 .di f+
183 .35
184 .ft \n(.f
185 .ll \n(34u*1u/3u
186 .if \n(.l<\n(81 .ll \n(81u
187 .in 0
188 生成されたファイルを保持します
189 .br
190 .di
191 .nr f| \n(dn
192 .nr f- \n(dl
193 ..
194 .ec \
195 .eo
196 .am 81
197 .br
198 .di g+
199 .35
200 .ft \n(.f
201 .ll \n(34u*1u/3u
202 .if \n(.l<\n(81 .ll \n(81u
203 .in 0
204 常に \-wsdl オプションと組み合わせて使用します。WSDL などの生成されたリソースファイルの格納場所を指定します
205 .br
206 .di
207 .nr g| \n(dn
208 .nr g- \n(dl
209 ..
210 .ec \
211 .eo
212 .am 81
213 .br
214 .di h+
215 .35
216 .ft \n(.f
217 .ll \n(34u*1u/3u
218 .if \n(.l<\n(81 .ll \n(81u
219 .in 0
220 生成されるソースファイルを格納する場所を指定する
221 .br
222 .di
223 .nr h| \n(dn
224 .nr h- \n(dl
225 ..
226 .ec \
227 .eo
228 .am 81
229 .br
230 .di i+
231 .35
232 .ft \n(.f
233 .ll \n(34u*1u/3u
234 .if \n(.l<\n(81 .ll \n(81u
235 .in 0
236 コンパイラが実行している処理に関するメッセージを出力します
237 .br
238 .di
239 .nr i| \n(dn
240 .nr i- \n(dl
241 ..
242 .ec \
243 .eo
244 .am 81
245 .br
246 .di j+
247 .35
248 .ft \n(.f
249 .ll \n(34u*1u/3u
250 .if \n(.l<\n(81 .ll \n(81u
251 .in 0
252 バージョン情報を出力します。このオプションを使用した場合、バージョン情報が出力されるだけです。通常の処理は実行されません。
253 .br
254 .di
255 .nr j| \n(dn
256 .nr j- \n(dl
257 ..
258 .ec \
259 .eo
260 .am 81
261 .br
262 .di k+
263 .35
264 .ft \n(.f
265 .ll \n(34u*1u/3u
266 .if \n(.l<\n(81 .ll \n(81u
267 .in 0
268 デフォルトでは \f2wsgen\fP は WSDL ファイルを生成しません。このフラグは省略可能ですが、指定した場合は \f2wsgen\fP が WSDL ファイルを生成するようになります。このフラグは通常、エンドポイントの配備前に開発者が WSDL を参照できるようにするためだけに使用されます。 \f2protocol\fP は省略可能であり、wsdl:binding で使用すべきプロトコルを指定するために \f2使用されます\fP。有効なプロトコルは次のとおりです。 \f2soap1.1\fP と \f2Xsoap1.2\fP。デフォルトは \f2soap1.1\fP です。 \f2Xsoap1.2\fP は標準ではないため、 \f2\-extension\fP オプションと組み合わせないと使用できません。
269 .br
270 .di
271 .nr k| \n(dn
272 .nr k- \n(dl
273 ..
274 .ec \
275 .eo
276 .am 81
277 .br
278 .di l+
279 .35
280 .ft \n(.f
281 .ll \n(34u*1u/3u
282 .if \n(.l<\n(81 .ll \n(81u
283 .in 0
284 常に \f2\-wsdl\fP オプションと組み合わせて使用します。WSDL 内で生成されるべき \f2wsdl:service\fP の名前を指定するために使用します。例: \f2\-servicename "{http://mynamespace/}MyService"\fP
285 .br
286 .di
287 .nr l| \n(dn
288 .nr l- \n(dl
289 ..
290 .ec \
291 .eo
292 .am 81
293 .br
294 .di m+
295 .35
296 .ft \n(.f
297 .ll \n(34u*1u/3u
298 .if \n(.l<\n(81 .ll \n(81u
299 .in 0
300 常に \f2\-wsdl\fP オプションと組み合わせて使用します。WSDL 内で生成されるべき \f2wsdl:port\fP の名前を指定するために使用します。例: \f2\-portname "{http://mynamespace/}MyPort"\fP
301 .br
302 .br
303 .di
304 .nr m| \n(dn
305 .nr m- \n(dl
306 ..
307 .ec \
308 .35
309 .nf
310 .ll \n(34u
311 .nr 80 0
312 .nr 38 \w\f3オプション\fP
313 .if \n(80<\n(38 .nr 80 \n(38
314 .nr 38 \w\f4\-classpath <path>\fP
315 .if \n(80<\n(38 .nr 80 \n(38
316 .nr 38 \w\f4\-cp <path>\fP
317 .if \n(80<\n(38 .nr 80 \n(38
318 .nr 38 \w\f4\-d <directory>\fP
319 .if \n(80<\n(38 .nr 80 \n(38
320 .nr 38 \w\f4\-extension\fP
321 .if \n(80<\n(38 .nr 80 \n(38
322 .nr 38 \w\f4\-help\fP
323 .if \n(80<\n(38 .nr 80 \n(38
324 .nr 38 \w\f4\-keep\fP
325 .if \n(80<\n(38 .nr 80 \n(38
326 .nr 38 \w\f4\-r <directory>\fP
327 .if \n(80<\n(38 .nr 80 \n(38
328 .nr 38 \w\f4\-s <directory>\fP
329 .if \n(80<\n(38 .nr 80 \n(38
330 .nr 38 \w\f4\-verbose\fP
331 .if \n(80<\n(38 .nr 80 \n(38
332 .nr 38 \w\f4\-version\fP
333 .if \n(80<\n(38 .nr 80 \n(38
334 .nr 38 \w\f4\-wsdl[:protocol]\fP
335 .if \n(80<\n(38 .nr 80 \n(38
336 .nr 38 \w\f4\-servicename <name>\fP
337 .if \n(80<\n(38 .nr 80 \n(38
338 .nr 38 \w\f4\-portname <name>\fP
339 .if \n(80<\n(38 .nr 80 \n(38
340 .80
341 .rm 80
342 .nr 81 0
343 .nr 38 \w\f3説明\fP
344 .if \n(81<\n(38 .nr 81 \n(38
345 .81
346 .rm 81
347 .nr 38 \n(a-
348 .if \n(81<\n(38 .nr 81 \n(38
349 .nr 38 \n(b-
350 .if \n(81<\n(38 .nr 81 \n(38
351 .nr 38 \n(c-
352 .if \n(81<\n(38 .nr 81 \n(38
353 .nr 38 \n(d-
354 .if \n(81<\n(38 .nr 81 \n(38
355 .nr 38 \n(e-
356 .if \n(81<\n(38 .nr 81 \n(38
357 .nr 38 \n(f-
358 .if \n(81<\n(38 .nr 81 \n(38
359 .nr 38 \n(g-
360 .if \n(81<\n(38 .nr 81 \n(38
361 .nr 38 \n(h-
362 .if \n(81<\n(38 .nr 81 \n(38
363 .nr 38 \n(i-
364 .if \n(81<\n(38 .nr 81 \n(38
365 .nr 38 \n(j-
366 .if \n(81<\n(38 .nr 81 \n(38
367 .nr 38 \n(k-
368 .if \n(81<\n(38 .nr 81 \n(38
369 .nr 38 \n(l-
370 .if \n(81<\n(38 .nr 81 \n(38
371 .nr 38 \n(m-
372 .if \n(81<\n(38 .nr 81 \n(38
373 .35
374 .nf
375 .ll \n(34u
376 .nr 38 1n
377 .nr 79 0
378 .nr 40 \n(79+(0*\n(38)
379 .nr 80 +\n(40
380 .nr 41 \n(80+(3*\n(38)
381 .nr 81 +\n(41
382 .nr TW \n(81
383 .if t .if \n(TW>\n(.li .tm Table at line 137 file Input is too wide - \n(TW units
384 .fc
385 .nr #T 0-1
386 .nr #a 0-1
387 .eo
388 .de T#
389 .ds #d .d
390 .if \(ts\n(.z\(ts\(ts .ds #d nl
391 .mk ##
392 .nr ## -1v
393 .ls 1
394 .ls
395 ..
396 .ec
397 .ta \n(80u \n(81u
398 .nr 31 \n(.f
399 .nr 35 1m
400 \&\h'|\n(40u'\f3オプション\fP\h'|\n(41u'\f3説明\fP
401 .ne \n(a|u+\n(.Vu
402 .if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
403 .ta \n(80u \n(81u
404 .nr 31 \n(.f
405 .nr 35 1m
406 \&\h'|\n(40u'\f4\-classpath <path>\fP\h'|\n(41u'
407 .mk ##
408 .nr 31 \n(##
409 .sp |\n(##u-1v
410 .nr 37 \n(41u
411 .in +\n(37u
412 .a+
413 .in -\n(37u
414 .mk 32
415 .if \n(32>\n(31 .nr 31 \n(32
416 .sp |\n(31u
417 .ne \n(b|u+\n(.Vu
418 .if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
419 .ta \n(80u \n(81u
420 .nr 31 \n(.f
421 .nr 35 1m
422 \&\h'|\n(40u'\f4\-cp <path>\fP\h'|\n(41u'
423 .mk ##
424 .nr 31 \n(##
425 .sp |\n(##u-1v
426 .nr 37 \n(41u
427 .in +\n(37u
428 .b+
429 .in -\n(37u
430 .mk 32
431 .if \n(32>\n(31 .nr 31 \n(32
432 .sp |\n(31u
433 .ne \n(c|u+\n(.Vu
434 .if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
435 .ta \n(80u \n(81u
436 .nr 31 \n(.f
437 .nr 35 1m
438 \&\h'|\n(40u'\f4\-d <directory>\fP\h'|\n(41u'
439 .mk ##
440 .nr 31 \n(##
441 .sp |\n(##u-1v
442 .nr 37 \n(41u
443 .in +\n(37u
444 .c+
445 .in -\n(37u
446 .mk 32
447 .if \n(32>\n(31 .nr 31 \n(32
448 .sp |\n(31u
449 .ne \n(d|u+\n(.Vu
450 .if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
451 .ta \n(80u \n(81u
452 .nr 31 \n(.f
453 .nr 35 1m
454 \&\h'|\n(40u'\f4\-extension\fP\h'|\n(41u'
455 .mk ##
456 .nr 31 \n(##
457 .sp |\n(##u-1v
458 .nr 37 \n(41u
459 .in +\n(37u
460 .d+
461 .in -\n(37u
462 .mk 32
463 .if \n(32>\n(31 .nr 31 \n(32
464 .sp |\n(31u
465 .ne \n(e|u+\n(.Vu
466 .if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
467 .ta \n(80u \n(81u
468 .nr 31 \n(.f
469 .nr 35 1m
470 \&\h'|\n(40u'\f4\-help\fP\h'|\n(41u'
471 .mk ##
472 .nr 31 \n(##
473 .sp |\n(##u-1v
474 .nr 37 \n(41u
475 .in +\n(37u
476 .e+
477 .in -\n(37u
478 .mk 32
479 .if \n(32>\n(31 .nr 31 \n(32
480 .sp |\n(31u
481 .ne \n(f|u+\n(.Vu
482 .if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
483 .ta \n(80u \n(81u
484 .nr 31 \n(.f
485 .nr 35 1m
486 \&\h'|\n(40u'\f4\-keep\fP\h'|\n(41u'
487 .mk ##
488 .nr 31 \n(##
489 .sp |\n(##u-1v
490 .nr 37 \n(41u
491 .in +\n(37u
492 .f+
493 .in -\n(37u
494 .mk 32
495 .if \n(32>\n(31 .nr 31 \n(32
496 .sp |\n(31u
497 .ne \n(g|u+\n(.Vu
498 .if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
499 .ta \n(80u \n(81u
500 .nr 31 \n(.f
501 .nr 35 1m
502 \&\h'|\n(40u'\f4\-r <directory>\fP\h'|\n(41u'
503 .mk ##
504 .nr 31 \n(##
505 .sp |\n(##u-1v
506 .nr 37 \n(41u
507 .in +\n(37u
508 .g+
509 .in -\n(37u
510 .mk 32
511 .if \n(32>\n(31 .nr 31 \n(32
512 .sp |\n(31u
513 .ne \n(h|u+\n(.Vu
514 .if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
515 .ta \n(80u \n(81u
516 .nr 31 \n(.f
517 .nr 35 1m
518 \&\h'|\n(40u'\f4\-s <directory>\fP\h'|\n(41u'
519 .mk ##
520 .nr 31 \n(##
521 .sp |\n(##u-1v
522 .nr 37 \n(41u
523 .in +\n(37u
524 .h+
525 .in -\n(37u
526 .mk 32
527 .if \n(32>\n(31 .nr 31 \n(32
528 .sp |\n(31u
529 .ne \n(i|u+\n(.Vu
530 .if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
531 .ta \n(80u \n(81u
532 .nr 31 \n(.f
533 .nr 35 1m
534 \&\h'|\n(40u'\f4\-verbose\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 .i+
541 .in -\n(37u
542 .mk 32
543 .if \n(32>\n(31 .nr 31 \n(32
544 .sp |\n(31u
545 .ne \n(j|u+\n(.Vu
546 .if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
547 .ta \n(80u \n(81u
548 .nr 31 \n(.f
549 .nr 35 1m
550 \&\h'|\n(40u'\f4\-version\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 .j+
557 .in -\n(37u
558 .mk 32
559 .if \n(32>\n(31 .nr 31 \n(32
560 .sp |\n(31u
561 .ne \n(k|u+\n(.Vu
562 .if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
563 .ta \n(80u \n(81u
564 .nr 31 \n(.f
565 .nr 35 1m
566 \&\h'|\n(40u'\f4\-wsdl[:protocol]\fP\h'|\n(41u'
567 .mk ##
568 .nr 31 \n(##
569 .sp |\n(##u-1v
570 .nr 37 \n(41u
571 .in +\n(37u
572 .k+
573 .in -\n(37u
574 .mk 32
575 .if \n(32>\n(31 .nr 31 \n(32
576 .sp |\n(31u
577 .ne \n(l|u+\n(.Vu
578 .if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
579 .ta \n(80u \n(81u
580 .nr 31 \n(.f
581 .nr 35 1m
582 \&\h'|\n(40u'\f4\-servicename <name>\fP\h'|\n(41u'
583 .mk ##
584 .nr 31 \n(##
585 .sp |\n(##u-1v
586 .nr 37 \n(41u
587 .in +\n(37u
588 .l+
589 .in -\n(37u
590 .mk 32
591 .if \n(32>\n(31 .nr 31 \n(32
592 .sp |\n(31u
593 .ne \n(m|u+\n(.Vu
594 .if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
595 .ta \n(80u \n(81u
596 .nr 31 \n(.f
597 .nr 35 1m
598 \&\h'|\n(40u'\f4\-portname <name>\fP\h'|\n(41u'
599 .mk ##
600 .nr 31 \n(##
601 .sp |\n(##u-1v
602 .nr 37 \n(41u
603 .in +\n(37u
604 .m+
605 .in -\n(37u
606 .mk 32
607 .if \n(32>\n(31 .nr 31 \n(32
608 .sp |\n(31u
609 .fc
610 .nr T. 1
611 .T# 1
612 .35
613 .rm a+
614 .rm b+
615 .rm c+
616 .rm d+
617 .rm e+
618 .rm f+
619 .rm g+
620 .rm h+
621 .rm i+
622 .rm j+
623 .rm k+
624 .rm l+
625 .rm m+
626 .TE
627 .if \n-(b.=0 .nr c. \n(.c-\n(d.-57
628
629 .LP
630 .SH "例"
631 .nf
632 \f3
633 .fl
634 \fP\f3wsgen \-d stock \-cp myclasspath stock.StockService\fP
635 .fl
636 .fi
637 .LP
638 \f3stock\fP ディレクトリ内に @WebService 注釈が付けられた、StockService に必要なラッパークラスが生成されます。
639 .nf
640 \f3
641 .fl
642 \fP\f3wsgen \-wsdl \-d stock \-cp myclasspath stock.StockService\fP
643 .fl
644 .fi
645 .LP
646 SOAP 1.1 WSDL と、@WebService 注釈が付けられた Java クラス stock.StockService のスキーマが生成されます。
647 .nf
648 \f3
649 .fl
650 \fP\f3wsgen \-wsdl:Xsoap1.2 \-d stock \-cp myclasspath stock.StockService\fP
651 .fl
652 .fi
653 .LP
654 SOAP 1.2 WSDL が生成されます。
655 .LP
656 サービスを配備するときに JAXWS ランタイムによって自動的に WSDL が生成されるため、開発時に WSDL を生成する必要はありません。