1 '\" t
2 .\" Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved.
3 .\" Title: wsgen
4 .\" Language: English
5 .\" Date: 2013年11月21日
6 .\" SectDesc: Java Webサービス・ツール
7 .\" Software: JDK 8
8 .\" Arch: 汎用
9 .\"
10 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
11 .\"
12 .\" This code is free software; you can redistribute it and/or modify it
13 .\" under the terms of the GNU General Public License version 2 only, as
14 .\" published by the Free Software Foundation.
15 .\"
16 .\" This code is distributed in the hope that it will be useful, but WITHOUT
17 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
18 .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
19 .\" version 2 for more details (a copy is included in the LICENSE file that
20 .\" accompanied this code).
21 .\"
22 .\" You should have received a copy of the GNU General Public License version
23 .\" 2 along with this work; if not, write to the Free Software Foundation,
24 .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
25 .\"
26 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
27 .\" or visit www.oracle.com if you need additional information or have any
28 .\" questions.
29 .\"
30 .pl 99999
31 .TH "wsgen" "1" "2013年11月21日" "JDK 8" "Java Webサービス・ツール"
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 .SH "NAME"
52 wsgen \- Webサービスのエンドポイント実装(SEI)クラスを読取り、Webサービスのデプロイメントと呼出しに必要なすべてのアーティファクトを生成します。
53 .SH "概要"
54 .sp
55 .if n \{\
56 .RS 4
57 .\}
58 .nf
59 \fIwsgen\fR [ \fIoptions\fR ] \fISEI\fR
60 .fi
61 .if n \{\
62 .RE
63 .\}
64 .PP
65 \fIoptions\fR
66 .RS 4
67 コマンドライン・オプション。オプションを参照してください。
68 .RE
69 .PP
70 \fISEI\fR
71 .RS 4
72 読み取るWebサービスのエンドポイント実装クラス(SEI)です。
73 .RE
74 .SH "説明"
75 .PP
76 \fIwsgen\fRコマンドは、JAX\-WS Webサービスで使用されるJAX\-WSポータブル・アーティファクトを生成します。このツールは、Webサービスのエンドポイント・クラスを読取り、Webサービスのデプロイメントと呼出しに必要なすべてのアーティファクトを生成します。JAXWS 2\&.1\&.1 RIでは\fIwsgen\fR
77 Antタスクも提供されます。
78 http://jax\-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsgenant\&.htmlのJAX\-WS (wsgen)ページのToolsタブを参照してください。
79 .PP
80 \fIwsgen\fRコマンドを起動するには、次を行います。
81 .sp
82 .if n \{\
83 .RS 4
84 .\}
85 .nf
86 export JAXWS_HOME=/pathto/jaxws\-ri
87 $JAXWS_HOME/bin/wsgen\&.sh \-help
88 .fi
89 .if n \{\
90 .RE
91 .\}
92 .SH "オプション"
93 .PP
94 \-classpath \fIpath\fR
95 .RS 4
96 入力クラス・ファイルの場所。
97 .RE
98 .PP
99 \-cp \fIpath\fR
100 .RS 4
101 入力クラス・ファイルの場所。
102 .RE
103 .PP
104 \-d \fIdirectory\fR
105 .RS 4
106 生成された出力ファイルを格納する場所。
107 .RE
108 .PP
109 \-extension
110 .RS 4
111 ベンダー拡張を使用可能にします。拡張を使用すると、アプリケーションの移植性が失われたり、他の実装と連携できなくなる可能性があります。
112 .RE
113 .PP
114 \-help
115 .RS 4
116 \fIwsgen\fRコマンドに関するヘルプ・メッセージを表示します。
117 .RE
118 .PP
119 \-keep
120 .RS 4
121 生成されたファイルを保存します。
122 .RE
123 .PP
124 \-r \fIdirectory\fR
125 .RS 4
126 このオプションを\fI\-wsdl\fRオプションとともに使用して、WSDLなど生成されたリソース・ファイルを配置する場所を指定します。
127 .RE
128 .PP
129 \-s \fIdirectory\fR
130 .RS 4
131 生成されたソース・ファイルを格納する場所。
132 .RE
133 .PP
134 \-verbose
135 .RS 4
136 コンパイラ・メッセージを表示します。
137 .RE
138 .PP
139 \-version
140 .RS 4
141 リリース情報を出力します。
142 .RE
143 .PP
144 \-wsdl [ :protocol ]
145 .RS 4
146 エンドポイントをデプロイする前に確認するWSDLファイルを生成するオプション・コマンド。WSDLファイルには、サービスを呼び出す方法、パラメータに必要な値、返されるデータ構造についてのコンピュータで読取り可能な記述が含まれます。
147 .sp
148 デフォルトでは\fIwsgen\fRコマンドはWSDLファイルを生成しません。\fIprotocol\fR値は省略可能であり、WSDLバインディング(\fIwsdl:binding\fR)で使用するプロトコルを指定するために使用されます。有効なプロトコルは、\fIsoap1\&.1\fRと\fIXsoap1\&.2\fRです。デフォルトは\fIsoap1\&.1\fRです。\fIXsoap1\&.2\fRプロトコルは標準ではないため、\fI\-extension\fRオプションとともにのみ使用可能です。
149 .RE
150 .PP
151 \-servicename \fIname\fR
152 .RS 4
153 \fI\-wsdl\fRオプションとともにのみ使用して、WSDLで生成される特定のWSDLサービス(\fIwsdl:service\fR)名を指定します。例:
154 \fI\-servicename "{http://mynamespace/}MyService"\fR。
155 .RE
156 .PP
157 \-portname \fIname\fR
158 .RS 4
159 \fI\-wsdl\fRオプションとともにのみ使用して、WSDLで生成される特定のWSDLポート(\fIwsdl:port\fR)名を指定します。例:
160 \fI\-portname "{http://mynamespace/}MyPort"\fR。
161 .RE
162 .SH "例"
163 .PP
164 次の例では、Stockディレクトリ内に\fI@WebService\fR注釈を持つ\fIStockService\fRのラッパー・クラスを生成します。
165 .sp
166 .if n \{\
167 .RS 4
168 .\}
169 .nf
170 wsgen \-d stock \-cp myclasspath stock\&.StockService
171 .fi
172 .if n \{\
173 .RE
174 .\}
175 .PP
176 次の例では、SOAP 1\&.1 WSDLおよび\fI@WebService\fR注釈を持つ\fIstock\&.StockService\fRクラスのスキーマを生成します。
177 .sp
178 .if n \{\
179 .RS 4
180 .\}
181 .nf
182 wsgen \-wsdl \-d stock \-cp myclasspath stock\&.StockService
183 .fi
184 .if n \{\
185 .RE
186 .\}
187 .PP
188 次の例では、SOAP 1\&.2 WSDLを生成します。
189 .sp
190 .if n \{\
191 .RS 4
192 .\}
193 .nf
194 wsgen \-wsdl:Xsoap1\&.2 \-d stock \-cp myclasspath stock\&.StockService
195 .fi
196 .if n \{\
197 .RE
198 .\}
199 .PP
200 \fB注意:\fR
201 サービスのデプロイ時にJAXWS実行時環境でWSDLが生成されるため、開発時にWSDLを生成する必要はありません。
202 .SH "関連項目"
203 .sp
204 .RS 4
205 .ie n \{\
206 \h'-04'\(bu\h'+03'\c
207 .\}
208 .el \{\
209 .sp -1
210 .IP \(bu 2.3
211 .\}
212 wsimport(1)
213 .RE
214 .sp
215 .RS 4
216 .ie n \{\
217 \h'-04'\(bu\h'+03'\c
218 .\}
219 .el \{\
220 .sp -1
221 .IP \(bu 2.3
222 .\}
223 http://jax\-ws\&.java\&.net/nonav/2\&.1\&.1/docs/wsgenant\&.htmlの
224 JAX\-WS (wsgen)ページのToolsタブを参照してください。
225 .RE
226 .br
227 'pl 8.5i
228 'bp