diff -r 8837e7172929 -r cabba0c0f3ee jdk/src/solaris/doc/sun/man/man1/ja/xjc.1 --- a/jdk/src/solaris/doc/sun/man/man1/ja/xjc.1 Mon Apr 18 23:00:53 2011 -0700 +++ b/jdk/src/solaris/doc/sun/man/man1/ja/xjc.1 Tue Apr 19 20:58:46 2011 -0700 @@ -19,266 +19,277 @@ ." or visit www.oracle.com if you need additional information or have any ." questions. ." -.TH xjc 1 "02 Jun 2010" +.TH xjc 1 "14 Apr 2011" .LP .ad c -.SH "名前" -xjc \- XML バインドのための Java(TM) アーキテクチャー +.SH "̾" +xjc \- XML ХɤΤ Java(TM) ƥ㡼 .br -バインディングコンパイラ +Хǥ󥰥ѥ .LP -\f3仕様バージョン:\fP 2.1 +\f3ͥС:\fP 2.1 .br -\f3リファレンス実装 (RI) バージョン:\fP 2.1.3 .ad l +\f3ե󥹼 (RI) С:\fP 2.1.3 .ad l .LP -.SH "xjc の起動" +.SH "xjc εư" .LP .LP -バインディングコンパイラを起動するには、使用するプラットフォームに応じた \f2bin\fP ディレクトリ内の \f2xjc\fP シェルスクリプトを使用します。また、バインディングコンパイラを実行するための Ant タスクも用意されています。 +Хǥ󥰥ѥưˤϡѤץåȥե˱ bin ǥ쥯ȥ \f2xjc\fP 륹ץ \f2\fP ѤޤޤХǥ󥰥ѥ¹Ԥ뤿 Ant ѰդƤޤ .na -\f2xjc を Ant とともに使用する\fP @ +\f2xjc Ant ȤȤ˻Ѥ\fP @ .fi -https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.htmlための手順を参照してください。 -.LP -.RS 3 - +https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.htmlμ򻲾ȤƤ .LP .LP \f2% xjc \-help\fP .LP -.RE -\f3出力\fP -.LP -.RS 3 - +.SS + .LP .nf \f3 .fl -Usage: xjc [\-options ...] ... [\-b ] ... +Usage: xjc [\-options ...] ... [\-b ] ... +.fl +If dir is specified, all schema files in it will be compiled. +.fl +If jar is specified, /META\-INF/sun\-jaxb.episode binding file will be compiled. .fl Options: .fl - \-nv : do not perform strict validation of the input schema(s) + \-nv : do not perform strict validation of the input schema(s) .fl - \-extension : allow vendor extensions \- do not strictly follow the + \-extension : allow vendor extensions \- do not strictly follow the Compatibility Rules and App E.2 from the JAXB Spec .fl - Compatibility Rules and App E.2 from the JAXB Spec + \-b : specify external bindings files (each must have its own \-b); if a directory is given, **/*.xjb is searched .fl - \-b : specify external bindings files (each must have its own \-b) + \-d : generated files will go into this directory +.fl + \-p : specifies the target package .fl - If a directory is given, **/*.xjb is searched + \-httpproxy : set HTTP/HTTPS proxy; format is [user[:password]@]proxyHost:proxyPort .fl - \-d : generated files will go into this directory + \-httpproxyfile : works like \-httpproxy but takes the argument in a file to protect password .fl - \-p : specifies the target package + \-classpath : specify where to find user class files .fl - \-httpproxy : set HTTP/HTTPS proxy. Format is [user[:password]@]proxyHost:proxyPort + \-catalog : specify catalog files to resolve external entity references; support TR9401, XCatalog, and OASIS XML Catalog format .fl - \-httpproxyfile : set the proxy string (same format as above). + \-readOnly : generated files will be in read\-only mode .fl - \-classpath : specify where to find user class files + \-npa : suppress generation of package level annotations (**/package\-info.java) +.fl + \-no\-header : suppress generation of a file header with timestamp .fl - \-catalog : specify catalog files to resolve external entity references + \-target 2.0 : behave like XJC 2.0 and generate code that doesnt use any 2.1 features .fl - support TR9401, XCatalog, and OASIS XML Catalog format. + \-xmlschema : treat input as W3C XML Schema (default) .fl - \-readOnly : generated files will be in read\-only mode + \-relaxng : treat input as RELAX NG (experimental,unsupported) .fl - \-npa : suppress generation of package level annotations (**/package\-info.java) + \-relaxng\-compact : treat input as RELAX NG compact syntax (experimental,unsupported) .fl - \-no\-header : suppress generation of a file header with timestamp + \-dtd : treat input as XML DTD (experimental,unsupported) .fl - \-target 2.0 : behave like XJC 2.0 and generate code that doesnt use any 2.1 features. + \-wsdl : treat input as WSDL and compile schemas inside it (experimental,unsupported) +.fl + \-verbose : be extra verbose .fl - \-xmlschema : treat input as W3C XML Schema (default) + \-quiet : suppress compiler output .fl - \-relaxng : treat input as RELAX NG (experimental,unsupported) + \-help : display this help message .fl - \-relaxng\-compact : treat input as RELAX NG compact syntax (experimental,unsupported) + \-version : display version information +.fl + .fl - \-dtd : treat input as XML DTD (experimental,unsupported) + .fl - \-wsdl : treat input as WSDL and compile schemas inside it (experimental,unsupported) +Extensions: .fl - \-verbose : be extra verbose + \-Xlocator : enable source location support for generated code .fl - \-quiet : suppress compiler output + \-Xsync\-methods : generate accessor methods with the 'synchronized' keyword .fl - \-help : display this help message + \-mark\-generated : mark the generated code as @javax.annotation.Generated .fl - \-version : display version information + \-episode : generate the episode file for separate compilation .fl \fP .fi -.RE .LP -.SH "オプション" -.LP - +.SH "ץ" .LP .RS 3 .TP 3 \-nv -デフォルトでは、XJC バインディングコンパイラは、ソーススキーマを処理する前に厳密な検証を実行します。このオプションを使用すると、厳密なスキーマ検証を無効にします。これは、バインディングコンパイラが検証を一切実行しないということではありません。 より厳密でない検証を実行するということです。 +ǥեȤǤϡXJC Хǥ󥰥ѥϡޤ˸̩ʸڤ¹ԤޤΥץѤȡ̩ʥ޸ڤ̵ˤޤϡХǥ󥰥ѥ餬ڤڼ¹ԤʤȤȤǤϤޤ󡣤긷̩Ǥʤڤ¹ԤȤȤǤ .TP 3 \-extension -デフォルトでは、XJC バインディングコンパイラは、JAXB 仕様の「Compatibility」の章で説明されている規則を厳密に強制します。付録 E.2 には、JAXB v1.0 で完全にはサポートされていない一連の W3C XML スキーマ機能が定義されています。 場合によっては、このスイッチで有効になる「\-extension」モードでそれらの機能が使用できるかもしれません。また、デフォルトの厳密なモードでは、仕様に定義されているバインディングカスタマイズのみが使用できます。「\-extension」スイッチを指定すれば、JAXB Vendor Extension を使用できます。 +ǥեȤǤϡXJC Хǥ󥰥ѥϡJAXB ͤΡCompatibilityפξϤƤ뵬§̩˶ޤϿ E.2 ˤϡJAXB v1.0 ǴˤϥݡȤƤʤϢ W3C XML ޵ǽƤޤˤäƤϡΥåͭˤʤ\-extensionץ⡼ɤǤεǽѤǤ뤫⤷ޤ󡣤ޤǥեȤθ̩ʥ⡼ɤǤϡͤƤХǥ󥰥ޥΤߤѤǤޤ\-extensionץåꤹСJAXB Vendor Extension ѤǤޤ .TP 3 \-b -処理する外部バインディングファイルを 1 つまたは複数指定します。(バインディングファイルごとに「\f2\-b\fP」スイッチを指定する必要があります。)外部バインディングファイルの構文は非常に柔軟です。複数のスキーマのカスタマイズが含まれる 1 つのバインディングファイルを使用したり、それらのカスタマイズを複数のバインディングファイルに分割したりできます。 次に例を示します。 -.RS 3 - -.LP -\f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings123.xjb\fP +볰Хǥ󥰥ե 1 Ĥޤʣꤷޤ(Хǥ󥰥ե뤴Ȥ \f2\-b\fP åꤹɬפޤ) Хǥ󥰥եιʸ˽ǤʣΥޤΥޥޤޤ 1 ĤΥХǥ󥰥եѤꡢΥޥʣΥХǥ󥰥եʬ䤷Ǥޤ򼨤ޤ \f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings123.xjb\fP .br -\f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings1.xjb \-b bindings2.xjb \-b bindings3.xjb\fP -.RE -また、コマンド行にスキーマファイルとバインディングファイルを指定する順番は任意です。 +\f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings1.xjb \-b bindings2.xjb \-b bindings3.xjb\fP ޤޥɹԤ˥ޥեȥХǥ󥰥եꤹ֤ǤդǤ .TP 3 \-d -デフォルトでは、XJC バインディングコンパイラは、Java コンテンツクラスを現在のディレクトリに生成します。このオプションを使用すると、代替出力ディレクトリを指定できます。出力ディレクトリはあらかじめ存在している必要があります。 XJC バインディングコンパイラは、このディレクトリを自動的に作成しません。 +ǥեȤǤϡXJC Хǥ󥰥ѥϡJava ƥĥ饹򸽺ߤΥǥ쥯ȥޤΥץѤȡؽϥǥ쥯ȥǤޤϥǥ쥯ȥϤ餫¸ߤƤɬפޤXJC Хǥ󥰥ѥϡΥǥ쥯ȥưŪ˺ޤ .TP 3 \-p -このコマンド行オプション経由でターゲットパッケージを指定した場合、その指定内容は、パッケージ名に対するすべてのバインディングカスタマイズや、仕様で規定されているデフォルトのパッケージ名アルゴリズムよりも優先されます。 +Υޥɹԥץͳǥåȥѥåꤷ硢λƤϡѥå̾Ф뤹٤ƤΥХǥ󥰥ޥ䡢ͤǵꤵƤǥեȤΥѥå̾르ꥺͥ褵ޤ .TP 3 \-httpproxy -HTTP/HTTPS プロキシを指定します。形式は [user[:password]@]proxyHost[:proxyPort] です。従来の \f2\-host\fP および \f2\-port\fP は、下位互換性のためにリファレンス実装でもサポートされていますが、推奨されなくなりました。このオプションで指定されたパスワードは、\f2top\fP コマンドを使用するユーザーなど、ほかのユーザーが表示できる引数であることに注意してください。セキュリティーを高めるには、次の \f2\-httpproxyfile\fP を使用してください。 +HTTP/HTTPS ץꤷޤ [user[:password]@]proxyHost[:proxyPort] Ǥ \f2\-host\fP \f2\-port\fP ϡ̸ߴΤ˥ե󥹼Ǥ⥵ݡȤƤޤ侩ʤʤޤΥץǻꤵ줿ѥɤϡ \f2top\fP ޥɤѤ桼ʤɡۤΥ桼ɽǤǤ뤳ȤդƤƥˤϡ \f2\-httpproxyfile\fP ѤƤ .TP 3 \-httpproxyfile -HTTP/HTTPS プロキシをファイル経由で指定します。形式は上記と同じですが、このファイル内に指定されたパスワードをほかのユーザーが表示することはできません。 +HTTP/HTTPS ץեͳǻꤷޤϾ嵭ƱǤΥե˻ꤵ줿ѥɤۤΥ桼ɽ뤳ȤϤǤޤ .TP 3 \-classpath -\f2\fP および \f2\fP カスタマイズが使用するクライアントアプリケーションのクラスファイルの検索場所を指定します。 + \f2ޥѤ\fP 饤ȥץꥱ \f2饹եθ\fP ꤷޤ .TP 3 \-catalog -外部エンティティー参照を解決するカタログファイルを指定します。TR9401、XCatalog、および OASIS XML Catalog 形式がサポートされます。詳細は、『XML Entity and URI Resolvers』ドキュメントを参照するか、\f2カタログリゾルバ\fPのサンプルアプリケーションを調べてください。 +ƥƥȤ褹륫եꤷޤTR9401XCatalog OASIS XML Catalog ݡȤޤܺ٤ϡXML Entity and URI Resolvers٥ɥȤ򻲾Ȥ뤫 \f2꥾Ф\fP ץ륢ץꥱĴ٤Ƥ .TP 3 \-readOnly -デフォルトでは、XJC バインディングコンパイラは、生成する Java ソースファイルを書き込みから保護しません。このオプションを使用すると、XJC バインディングコンパイラは生成される Java ソースを強制的に読み取り専用にします。 +ǥեȤǤϡXJC Хǥ󥰥ѥϡ Java ե񤭹ߤݸޤ󡣤ΥץѤȡXJC Хǥ󥰥ѥ Java Ūɤ߼Ѥˤޤ .TP 3 \-npa -パッケージレベルの注釈を **/package\-info.java に生成することを抑制します。このスイッチを使用して生成するコードでは、これらの注釈がほかの生成済みクラスに内部化されます。 +ѥå٥ **/package\-info.java 뤳ȤޤΥåѤ륳ɤǤϡ᤬ۤѤߥ饹ޤ .TP 3 \-no\-header -多少のメモとタイムスタンプを含むファイルヘッダーコメントの生成を抑制します。このオプションを使用すると、生成されたコードがわかりにくくなります。 +¿ΥȥॹפޤեإåȤޤΥץѤȡ줿ɤ狼ˤʤޤ .TP 3 \-target 2.0 -なんらかの JAXB 2.1 機能に依存するコードを生成しないようにします。これにより、生成されたコードを JAXB 2.0 ランタイム (JavaSE 6 など) で実行できます。 +ʤ餫 JAXB 2.1 ǽ˰¸륳ɤʤ褦ˤޤˤꡢ줿ɤ JAXB 2.0 󥿥 (JavaSE 6 ʤ) Ǽ¹ԤǤޤ .TP 3 \-xmlschema -入力スキーマを W3C XML スキーマ (デフォルト) と見なします。このスイッチを指定しなくても、入力スキーマは W3C XML スキーマと見なされます。 +ϥޤ W3C XML (ǥե) ȸʤޤΥåꤷʤƤ⡢ϥޤ W3C XML ޤȸʤޤ .TP 3 \-relaxng -入力スキーマを RELAX NG として扱います (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。 +ϥޤ RELAX NG Ȥưޤ (Ṳ̄ݡ)RELAX NG ޤΥݡȤ JAXB Vendor Extension Ȥ󶡤Ƥޤ .TP 3 \-relaxng\-compact -入力スキーマを RELAX NG 圧縮構文として処理します (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。 +ϥޤ RELAX NG ̹ʸȤƽޤ (Ṳ̄ݡ)RELAX NG ޤΥݡȤ JAXB Vendor Extension Ȥ󶡤Ƥޤ .TP 3 \-dtd -入力スキーマを XML DTD として扱います (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。 +ϥޤ XML DTD Ȥưޤ (Ṳ̄ݡ)RELAX NG ޤΥݡȤ JAXB Vendor Extension Ȥ󶡤Ƥޤ .TP 3 \-wsdl -入力を WSDL として扱い、その内部のスキーマをコンパイルします (試験的、未サポート)。 +Ϥ WSDL ȤưΥޤ򥳥ѥ뤷ޤ (Ṳ̄ݡ) .TP 3 \-quiet -進捗情報や警告など、コンパイラの出力を抑制します。 +ĽٹʤɡѥνϤޤ .TP 3 \-verbose -情報メッセージを出力したり特定のエラー発生時にスタックトレースを表示したりするなど、極めて冗長になります。 +åϤΥ顼ȯ˥åȥ졼ɽꤹʤɡˤƾĹˤʤޤ .TP 3 \-help -コンパイラスイッチの概要を表示します。 +ѥ饹åγפɽޤ .TP 3 \-version -コンパイラのバージョン情報を表示します。 +ѥΥСɽޤ .TP 3 -コンパイル対象となる 1 つまたは複数のスキーマファイルを指定します。ユーザーがディレクトリを指定した場合、xjc はそのディレクトリを走査し、そこで見つかったすべてのスキーマファイルをコンパイルします。 +ѥоݤȤʤ 1 ĤޤʣΥޥեꤷޤ桼ǥ쥯ȥꤷ硢xjc ϤΥǥ쥯ȥǸĤä٤ƤΥޥե򥳥ѥ뤷ޤ .RE + +.LP .SS -非推奨コマンド行オプションおよび削除されたコマンド行オプションの概要 +ɸΥޥɹԥץ .LP .RS 3 +.TP 3 +\-Xlocator +줿ɤǤϡ󲽤ΤȤ Java Bean 󥹥󥹤˴ޤޤ륽 XML ˴ؤ SAX Locator 󤬸ޤ +.TP 3 +\-Xsync\-methods +줿٤ƤΥ᥽åɥ˥㡼 \f2Ʊ줿\fP ɤޤޤ +.TP 3 +\-mark\-generated +줿ɤ \f2@javax.annotation.Generated\fP դޤ +.TP 3 +\-episode +ѥ뤴Ȥ˻ꤵ줿ԥɥեޤ +.RE .LP +.SS +侩ޥɹԥץ󤪤Ӻ줿ޥɹԥץ +.LP .RS 3 .TP 3 \-host & \-port -これらのオプションは非推奨となり、\f3\-httpproxy\fP オプションで置き換えられました。これらのオプションは、下位互換性を確保する目的で引き続きサポートされますが、ドキュメントには記載されず、将来のリリースで削除される可能性もあります。 +Υץ侩Ȥʤꡢ\f3\-httpproxy\fP ץ֤ޤΥץϡ̸ߴݤŪǰ³ݡȤޤɥȤˤϵܤ줺Υ꡼Ǻǽ⤢ޤ .TP 3 \-use\-runtime -JAXB 2.0 仕様で移植性のあるランタイムが規定されたため、JAXB RI が **/impl/runtime パッケージを生成する必要がなくなりました。このため、このスイッチは不要となり、削除されました。 +JAXB 2.0 ͤǰܿΤ󥿥बꤵ줿ᡢJAXB RI **/impl/runtime ѥåɬפʤʤޤΤᡢΥåפȤʤꡢޤ .TP 3 \-source -\-source 互換性スイッチは、JAXB 2.0 の最初の Early Access 版で導入されました。このスイッチは、JAXB 2.0 の今後のリリースから削除されることになりました。1.0.x コードを生成する必要がある場合には、1.0.x コードベースのインストールを使用してください。 -.TP 3 -\-Xlocator & \-Xsync\-methods -これらのスイッチは現時点では無効化されています。この機能は将来、個別のダウンロードとして提供される予定です。 +\-source ߴåϡJAXB 2.0 κǽ Early Access ǤƳޤΥåϡJAXB 2.0 κΥ꡼뤳Ȥˤʤޤ1.0.x ɤɬפϡ1.0.x ɥ١Υ󥹥ȡѤƤ .RE .LP -.RE .SS -コンパイラの制限 +ѥ .LP .LP -通常は、関連するすべてのスキーマを、同じバインディングコンパイラスイッチを指定して 1 つの単位としてコンパイルするのがもっとも安全です。 +̾ϡϢ뤹٤ƤΥޤƱХǥ󥰥ѥ饹åꤷ 1 Ĥñ̤Ȥƥѥ뤹ΤäȤǤ .LP .LP -xjc を実行するときは、次に示す制限に注意してください。これらの制限のほとんどは、xjc を何度か呼び出して複数のスキーマをコンパイルする場合にのみ適用されます。 +xjc ¹ԤȤϡ˼¤դƤ¤ΤۤȤɤϡxjc ٤ƤӽФʣΥޤ򥳥ѥ뤹ˤΤŬѤޤ .LP .RS 3 .TP 2 o -複数のスキーマを同時にコンパイルする場合は、ターゲットの Java パッケージ名に次の優先順位の規則が適用されることに注意してください。 +ʣΥޤƱ˥ѥ뤹ϡåȤ Java ѥå̾˼̤ͥε§ŬѤ뤳ȤդƤ .RS 3 .TP 3 1. -「\f2\-p\fP」コマンド行オプションがもっとも優先されます。 +\f2\-p\fPץޥɹԥץ󤬤äȤͥ褵ޤ .TP 3 2. -<\f2jaxb:package\fP> のカスタマイズ +<\f2jaxb:package\fP> Υޥ .TP 3 3. -\f2targetNamespace\fP が宣言されている場合は、仕様に定義されている \f2targetNamespace\fP \-> Java パッケージ名のアルゴリズムを適用します。 +\f2targetNamespace\fP Ƥϡ \f2ͤƤ targetNamespace\fP \-> Java ѥå̾Υ르ꥺŬѤޤ .TP 3 4. -\f2targetNamespace\fP が宣言されていない場合は、"generated" という名前のハードコードされたパッケージを使用します。 +\f2targetNamespace\fP ƤʤϡgeneratedפȤ̾Υϡɥɤ줿ѥåѤޤ .RE .TP 2 o -名前空間ごとに複数の <\f2jaxb:schemaBindings\fP> を持つことは不正です。 このため、1 つのターゲット名前空間内の 2 つのスキーマを、異なる Java パッケージにコンパイルすることはできません。 +֤̾Ȥʣ <\f2jaxb:schemaBindings\fP> ĤȤǤΤᡢ1 ĤΥå̾ 2 ĤΥޤۤʤ Java ѥå˥ѥ뤹뤳ȤϤǤޤ .TP 2 o -1 つの Java パッケージにコンパイルされるすべてのスキーマは、XJC バインディングコンパイラに同時に送信する必要があります。 個別にコンパイルすることはできず、予期したとおりに動作しません。 +1 Ĥ Java ѥå˥ѥ뤵뤹٤ƤΥޤϡXJC Хǥ󥰥ѥƱɬפޤ̤˥ѥ뤹뤳ȤϤǤͽȤưޤ .TP 2 o -複数のスキーマファイルにまたがる要素置換グループは、同時にコンパイルする必要があります。 +ʣΥޥեˤޤִ롼פϡƱ˥ѥ뤹ɬפޤ .RE .LP -.SH "関連項目" +.SH "Ϣ" .LP .RS 3 .TP 2 o -コマンド行でのコンバータの実行 (XJC):[ +ޥɹԤǤΥСμ¹ (XJC): [ .na -\f2コマンド行の命令\fP @ +\f2ޥɹԤ̿\fP @ .fi -https://jaxb.dev.java.net/nonav/2.1.3/docs/xjc.html、 +https://jaxb.dev.java.net/nonav/2.1.3/docs/xjc.html .na -\f2xjc を Ant とともに使用する\fP @ +\f2xjc Ant ȤȤ˻Ѥ\fP @ .fi https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.html] .TP 2 o .na -\f2XML バインドのための JavaTM アーキテクチャー (JAXB)\fP @ +\f2XML ХɤΤ Java ƥ㡼 (JAXB)\fP @ .fi http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html .RE