1 '\" t
2 .\" Copyright (c) 2005, 2014, Oracle and/or its affiliates. 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 Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
20 .\" or visit www.oracle.com if you need additional information or have any
21 .\" questions.
22 .\"
23 .\" Title: xjc
24 .\" Language: Japanese
25 .\" Date: 2013年11月21日
26 .\" SectDesc: Java Webサービス・ツール
27 .\" Software: JDK 8
28 .\" Arch: 汎用
29 .\" Part Number: E58103-01
30 .\" Doc ID: JSSON
31 .\"
32 .if n .pl 99999
33 .TH "xjc" "1" "2013年11月21日" "JDK 8" "Java Webサービス・ツール"
34 .\" -----------------------------------------------------------------
35 .\" * Define some portability stuff
36 .\" -----------------------------------------------------------------
37 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
38 .\" http://bugs.debian.org/507673
39 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
40 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
41 .ie \n(.g .ds Aq \(aq
42 .el .ds Aq '
43 .\" -----------------------------------------------------------------
44 .\" * set default formatting
45 .\" -----------------------------------------------------------------
46 .\" disable hyphenation
47 .nh
48 .\" disable justification (adjust text to left margin only)
49 .ad l
50 .\" -----------------------------------------------------------------
51 .\" * MAIN CONTENT STARTS HERE *
52 .\" -----------------------------------------------------------------
53 .SH "名前"
54 xjc \- XMLスキーマ・ファイルを完全注釈付きのJavaクラスにコンパイルします。
55 .SH "概要"
56 .sp
57 .if n \{\
58 .RS 4
59 .\}
60 .nf
61 \fBxjc\fR [ \fIoptions\fR ] \fBschema\fR \fIfile/URL/dir/jar\fR \&.\&.\&. [\fB\-b\fR \fIbindinfo\fR ] \&.\&.\&.
62 .fi
63 .if n \{\
64 .RE
65 .\}
66 .PP
67 \fIoptions\fR
68 .RS 4
69 コマンド行オプション。オプションを参照してください。
70 .RE
71 .PP
72 schema \fIfile/URL/dir/jar \&.\&.\&.\fR
73 .RS 4
74 XMLスキーマ・ファイルの場所。\fBdir\fRが指定されている場合は、すべてのスキーマ・ファイルがコンパイルされます。\fBjar\fRが指定されている場合は、\fB/META\-INF/sun\-jaxb\&.episode\fRバインディング・ファイルがコンパイルされます。
75 .RE
76 .PP
77 \-b \fIbindinfo\fR
78 .RS 4
79 バインディング・ファイルの場所。
80 .RE
81 .SH "説明"
82 .PP
83 プラットフォームのbinディレクトリにある適切な\fBxjc\fRシェル・スクリプトを使用して、バインディング・コンパイラを起動します。バインディング・コンパイラを実行するAntタスクもあります。http://jaxb\&.java\&.net/nonav/2\&.1\&.3/docs/xjcTask\&.htmlの
84 Using the XJC with Antを参照してください
85 .SH "オプション"
86 .sp
87 .RS 4
88 .ie n \{\
89 \h'-04'\(bu\h'+03'\c
90 .\}
91 .el \{\
92 .sp -1
93 .IP \(bu 2.3
94 .\}
95 非標準オプションも参照してください
96 .RE
97 .sp
98 .RS 4
99 .ie n \{\
100 \h'-04'\(bu\h'+03'\c
101 .\}
102 .el \{\
103 .sp -1
104 .IP \(bu 2.3
105 .\}
106 非推奨で削除されたオプションも参照してください
107 .RE
108 .PP
109 \-nv
110 .RS 4
111 デフォルトでは、XJCバインディング・コンパイラは、ソース・スキーマを処理する前に厳密な検証を実行します。このオプションを使用すると、厳密なスキーマ検証か無効になります。これは、バインディング・コンパイラが検証を一切実行しないということではありません。より厳密でない検証を実行するということです。
112 .RE
113 .PP
114 \-extension
115 .RS 4
116 デフォルトでは、XJCバインディング・コンパイラは、JAXB仕様のCompatibilityの章で説明されているルールを厳密に強制します。付録E\&.2には、JAXB v1\&.0で完全にはサポートされていない一連のW3C XMLスキーマ機能が定義されています。場合によっては、このスイッチで有効になる\fB\-extension\fRモードでそれらの機能が使用できる場合があります。また、デフォルトの厳密なモードでは、仕様に定義されているバインディング・カスタマイズのみが使用できます。\fB\-extension\fRスイッチを指定すれば、JAXB Vendor Extensionを使用できます。
117 .RE
118 .PP
119 \-b \fIfile\fR
120 .RS 4
121 処理する外部バインディング・ファイルを1つまたは複数指定します。バインディング・ファイルごとに\fB\-b\fRスイッチを指定する必要があります。外部バインディング・ファイルの構文は柔軟です。複数のスキーマのカスタマイズが含まれる1つのバインディング・ファイルを使用したり、それらのカスタマイズを複数のバインディング・ファイルに分割したりできます。次に例を示します。\fBxjc schema1\&.xsd schema2\&.xsd schema3\&.xsd \-b bindings123\&.xjb\fR
122 \fBxjc schema1\&.xsd schema2\&.xsd schema3\&.xsd \-b bindings1\&.xjb \-b bindings2\&.xjb \-b bindings3\&.xjb\fRまた、コマンド行にスキーマ・ファイルとバインディング・ファイルを指定する順番は任意です。
123 .RE
124 .PP
125 \-d \fIdir\fR
126 .RS 4
127 デフォルトでは、XJCバインディング・コンパイラは、Javaコンテンツ・クラスを現在のディレクトリに生成します。このオプションを使用すると、代替出力ディレクトリを指定できます。出力ディレクトリはすでに存在している必要があります。XJCバインディング・コンパイラでは作成されません。
128 .RE
129 .PP
130 \-p \fIpkg\fR
131 .RS 4
132 このコマンド行オプションでターゲット・パッケージを指定した場合、その指定内容は、パッケージ名に対するすべてのバインディング・カスタマイズや、仕様で規定されているデフォルトのパッケージ名アルゴリズムよりも優先されます。
133 .RE
134 .PP
135 \-httpproxy \fIproxy\fR
136 .RS 4
137 \fI[user[:password]@]proxyHost[:proxyPort]\fR形式でHTTPまたはHTTPSプロキシを指定します。古い\fB\-host\fRおよび\fB\-port\fRオプションは、後方互換性のために引き続きRIでサポートされますが、非推奨となりました。このオプションで指定されたパスワードは、topコマンドを使用する他のユーザーが表示できる引数です。セキュリティを高めるには、\fB\-httpproxyfile\fRを使用してください。
138 .RE
139 .PP
140 \-httpproxyfile file
141 .RS 4
142 ファイルを使用して、HTTPまたはHTTPSプロキシを指定します。形式は\fB\-httpproxy\fRオプションと同じですが、このファイル内に指定されたパスワードを他のユーザーが表示することはできません。
143 .RE
144 .PP
145 \-classpath arg
146 .RS 4
147 \fIjxb:javaType\fRおよびxjc:\fIsuperClass\fRカスタマイズが使用するクライアント・アプリケーションのクラス・ファイルの検索場所を指定します。
148 .RE
149 .PP
150 \-catalog file
151 .RS 4
152 外部エンティティ参照を解決するカタログ・ファイルを指定します。TR9401、XCatalogおよびOASIS XML Catalogの各形式がサポートされます。http://xerces\&.apache\&.org/xml\-commons/components/resolver/resolver\-article\&.htmlの
153 XML Entity and URI Resolversを参照してください
154 .RE
155 .PP
156 \-readOnly
157 .RS 4
158 デフォルトでは、XJCバインディング・コンパイラは、生成するJavaソース・ファイルを書込みから保護しません。このオプションを使用すると、XJCバインディング・コンパイラは生成されるJavaソースを強制的に読取り専用にします。
159 .RE
160 .PP
161 \-npa
162 .RS 4
163 \fB**/package\-info\&.java\fRへのパッケージ・レベルの注釈の生成を抑制します。このスイッチを使用して生成するコードでは、これらの注釈が他の生成済クラスに内部化されます。
164 .RE
165 .PP
166 \-no\-header
167 .RS 4
168 多少のメモとタイムスタンプを含むファイル・ヘッダー・コメントの生成を抑制します。これを使用すると、生成されたコードと\fBdiff\fRコマンドとの互換性がより強くなります。
169 .RE
170 .PP
171 \-target 2\&.0
172 .RS 4
173 JAXB 2\&.1機能に依存するコードを生成しないようにします。これにより、生成されたコードをJAXB 2\&.0ランタイム環境(Java SE 6など)で実行できるようになります。
174 .RE
175 .PP
176 \-xmlschema
177 .RS 4
178 入力スキーマをW3C XMLスキーマとして扱います(デフォルト)。このスイッチを指定しない場合、入力スキーマはW3C XMLスキーマと同じように扱われます。
179 .RE
180 .PP
181 \-relaxing
182 .RS 4
183 入力スキーマをRELAX NGとして扱います(試験的および未サポート)。RELAX NGスキーマのサポートはJAXB Vendor Extensionとして提供されています。
184 .RE
185 .PP
186 \-relaxing\-compact
187 .RS 4
188 入力スキーマをRELAX NG圧縮構文として処理します(試験的および未サポート)。RELAX NGスキーマのサポートはJAXB Vendor Extensionとして提供されています。
189 .RE
190 .PP
191 \-dtd
192 .RS 4
193 入力スキーマをXML DTDとして扱います(試験的および未サポート)。RELAX NGスキーマのサポートはJAXB Vendor Extensionとして提供されています。
194 .RE
195 .PP
196 \-wsdl
197 .RS 4
198 入力をWSDLとして扱い、その内部のスキーマをコンパイルします(試験的および未サポート)。
199 .RE
200 .PP
201 \-quiet
202 .RS 4
203 進捗情報や警告など、コンパイラの出力を抑制します。
204 .RE
205 .PP
206 \-verbose
207 .RS 4
208 情報メッセージを出力したり特定のエラー発生時にスタック・トレースを表示したりするなど、きわめて冗長になります。
209 .RE
210 .PP
211 \-help
212 .RS 4
213 コンパイラ・スイッチのサマリーを表示します。
214 .RE
215 .PP
216 \-version
217 .RS 4
218 コンパイラのバージョン情報を表示します。
219 .RE
220 .PP
221 \fIschema file/URL/dir\fR
222 .RS 4
223 コンパイル対象となる1つまたは複数のスキーマ・ファイルを指定します。ディレクトリを指定する場合、\fBxjc\fRコマンドはすべてのスキーマ・ファイルをスキャンしてコンパイルします。
224 .RE
225 .SS "非標準オプション"
226 .PP
227 \-XLocator
228 .RS 4
229 生成されたコードでは、非整列化の後にJava Beanインスタンスに含まれるソースXMLに関するSAX Locator情報が公開されます。
230 .RE
231 .PP
232 \-Xsync\-methods
233 .RS 4
234 生成されたすべてのメソッド・シグニチャに\fBsynchronized\fRキーワードが含められます。
235 .RE
236 .PP
237 \-mark\-generated
238 .RS 4
239 生成されたコードに注釈\fB@javax\&.annotation\&.Generated\fRを付けます。
240 .RE
241 .PP
242 \-episode file
243 .RS 4
244 コンパイルごとに指定されたエピソード・ファイルを生成します。
245 .RE
246 .SS "非推奨で削除されたオプション"
247 .PP
248 \-host & \-port
249 .RS 4
250 これらのオプションは\fB\-httpproxy\fRオプションで置き換えられました。これらのオプションは、後方互換性を確保するためにサポートされますが、ドキュメントには記載されず、将来のリリースで削除される可能性もあります。
251 .RE
252 .PP
253 \-use\-runtime
254 .RS 4
255 JAXB 2\&.0仕様では、移植性のあるランタイム環境が定義されたため、JAXB RIが\fB**/impl/runtime \fRパッケージを生成する必要がなくなりました。このため、このスイッチは不要となり、削除されました。
256 .RE
257 .PP
258 \-source
259 .RS 4
260 \fB\-source\fR互換性スイッチは、JAXB 2\&.0の最初のEarly Access版で導入されました。このスイッチはJAXB 2\&.0の今後のリリースから削除されます。1\&.0\&.xコードを生成する必要がある場合は、1\&.0\&.xコード・ベースのインストールを使用してください。
261 .RE
262 .SH "コンパイラの制限"
263 .PP
264 通常は、関連するすべてのスキーマを、同じバインディング・コンパイラ・スイッチを指定して1つの単位としてコンパイルするのが最も安全です。\fBxjc\fRコマンドの実行時には、次の制限リストに留意してください。これらの問題のほとんどは、\fBxjc\fRコマンドを何度か呼び出して複数のスキーマをコンパイルする場合にのみ当てはまります。
265 .PP
266 複数のスキーマを同時にコンパイルする場合は、ターゲットのJavaパッケージ名に次の優先順位のルールが適用されることに注意してください。
267 .sp
268 .RS 4
269 .ie n \{\
270 \h'-04' 1.\h'+01'\c
271 .\}
272 .el \{\
273 .sp -1
274 .IP " 1." 4.2
275 .\}
276 \fB\-p\fRオプションが最も優先されます。
277 .RE
278 .sp
279 .RS 4
280 .ie n \{\
281 \h'-04' 2.\h'+01'\c
282 .\}
283 .el \{\
284 .sp -1
285 .IP " 2." 4.2
286 .\}
287 \fIjaxb:package\fRのカスタマイズ。
288 .RE
289 .sp
290 .RS 4
291 .ie n \{\
292 \h'-04' 3.\h'+01'\c
293 .\}
294 .el \{\
295 .sp -1
296 .IP " 3." 4.2
297 .\}
298 \fBtargetNamespace\fRが宣言されている場合は、\fBt\fR\fBargetNamespace\fRを仕様で定義されているJavaパッケージ名のアルゴリズムに適用します。
299 .RE
300 .sp
301 .RS 4
302 .ie n \{\
303 \h'-04' 4.\h'+01'\c
304 .\}
305 .el \{\
306 .sp -1
307 .IP " 4." 4.2
308 .\}
309 \fBtargetNamespace\fRが宣言されていない場合は、\fBgenerated\fRという名前のハードコードされたパッケージを使用します。
310 .RE
311 .PP
312 1つのネームスペースが複数の\fIjaxb:schemaBindings\fRを持つことはできないため、異なるJavaパッケージにコンパイラされる同一ターゲット・ネームスペースが2つのスキーマを持つことはできません。
313 .PP
314 同じJavaパッケージにコンパイラされるスキーマはすべて、同時にXJCバインディング・コンパイラに送信される必要があります。別々にコンパイルすると、予想どおりに機能しません。
315 .PP
316 複数のスキーマ・ファイルにまたがる要素置換グループは、同時にコンパイルする必要があります。
317 .SH "関連項目"
318 .sp
319 .RS 4
320 .ie n \{\
321 \h'-04'\(bu\h'+03'\c
322 .\}
323 .el \{\
324 .sp -1
325 .IP \(bu 2.3
326 .\}
327 http://jaxb\&.java\&.net/nonav/2\&.2\&.3u1/docs/xjc\&.htmlの
328 Binding Compiler (xjc)
329 .RE
330 .sp
331 .RS 4
332 .ie n \{\
333 \h'-04'\(bu\h'+03'\c
334 .\}
335 .el \{\
336 .sp -1
337 .IP \(bu 2.3
338 .\}
339 http://www\&.oracle\&.com/technetwork/articles/javase/index\-140168\&.htmlの
340 Java Architecture for XML Binding (JAXB)
341 .RE
342 .br
343 'pl 8.5i
344 'bp