バッチ・コンパイラー・クラスは、JDT コア・プラグインに配置されています。
このクラスの名前は org.eclipse.jdt.compiler.batch.BatchCompiler です。
これは plugins/org.eclipse.jdt.core_<version>.jar にパッケージされています。3.2 以降、個別にダウンロードして入手できるようになりました。
このファイルの名前は ecj.jar です。この対応するソースも使用可能です。これを入手するには、download page にアクセスして、セクション 「JDT コア・バッチ・コンパイラー (JDT Core Batch Compiler)」を検索します。この jar にはバッチ・コンパイラーと javac Ant アダプターが含まれています。
3.3 以降、この jar には、jsr199 (コンパイラー API) のサポートと jsr269 (注釈処理) のサポートも含まれています。注釈処理サポートを使用するには、1.6 の VM が必要です。
このため、スタンドアロンのアプリケーションとして、Eclipse 外部の Ant ビルド内部で使用できます。
java -jar org.eclipse.jdt.core_<version>.jar -classpath rt.jar A.java
または
java -jar ecj.jar -classpath rt.jar A.java
compile(String commandLine, PrintWriter outWriter, PrintWriter errWriter, CompilationProgress progress) メソッドを使用する場合:
org.eclipse.jdt.compiler.CompilationProgress progress = null; // instantiate your subclass org.eclipse.jdt.internal.compiler.batch.BatchCompiler.compile( "-classpath rt.jar A.java", new PrintWriter(System.out), new PrintWriter(System.err), progress);
クラス org.eclipse.jdt.compiler.CompilationProgress をサブクラス化することで、進行状況のレポートやバッチ・コンパイラーのキャンセルを制御できます。
推奨オプションは、背景がオレンジ色になっています。
複数回設定されているオプションがある場合、バッチ・コンパイラーは左から右にそれを使用します。 '+' または '-' なしの警告オプション (-warn:....) が使用されている場合、これは前に指定された警告のセットをオーバーライドします。 そのため、ユーザーはそのオプションが -warn オプションの他のすべての使用の前で指定されるようにする必要があります。
同じことが -err: オプションにも当てはまります。
| 名前 | 使用法 | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| クラスパス・オプション | |||||||||||||||
| -bootclasspath <dir 1>;<dir 2>;...;<dir P> | これは、コンパイラーにより使用されるクラス・ファイルのブートストラップに使用されるディレクトリーまたは JAR ファイルのリストです。
デフォルトで、実行中の VM のライブラリーが使用されます。
エントリーは、プラットフォームのパス・セパレーターにより分離されます。 各ディレクトリーまたはファイルでは、「[」と「]」の間でタイプのアクセス規則を指定することができます。 bootclasspath を指定しないと、コンパイラーは、システム・プロパティー |
||||||||||||||
| -cp -classpath <dir 1>;<dir 2>;...;<dir P> |
これは、ソース・ファイルのコンパイルに使用されるディレクトリーまたは JAR ファイルのリストです。
デフォルト値は、プロパティー "java.class.path" の値です。
エントリーは、プラットフォームのパス・セパレーターにより分離されます。 各ディレクトリーまたはファイルでは、「[」と「]」の間でタイプのアクセス規則を指定することができます (例えば、[-X] はタイプ X へのアクセスを禁止し、[~X] はタイプ X へのアクセスを非推奨とし、[+p/X:-p/*] はパッケージ p のすべてのタイプへのアクセスを禁止しつつ p/X へのアクセスを許可します)。 コンパイラーは、JAR ファイルのマニフェストの Class-Path 文節に再帰的に従い、参照される各 JAR ファイルがまだクラスパスにない場合は、クラスパスの最後にその JAR ファイルを追加します。 |
||||||||||||||
| -extdirs <dir 1>;<dir 2>;...;<dir P> | これは、拡張 ZIP/JAR ファイルの場所の指定に使用されるディレクトリーのリストです。 エントリーは、プラットフォームのパス・セパレーターにより分離されます。 | ||||||||||||||
| -endorseddirs <dir 1>;<dir 2>;...;<dir P> | これは、承認済み ZIP/JAR ファイルの場所の指定に使用されるディレクトリーのリストです。 エントリーは、プラットフォームのパス・セパレーターにより分離されます。 | ||||||||||||||
| -sourcepath <dir 1>;<dir 2>;...;<dir P> | これは、ソース・ファイルの指定に使用されるディレクトリーのリストです。
エントリーは、プラットフォームのパス・セパレーターにより分離されます。 各ディレクトリーでは、「[」と「]」の間でタイプのアクセス規則を指定することができます。 |
||||||||||||||
| -d <dir 1>|none | これは、生成された .class ファイルがダンプされるディレクトリーの指定に使用されます。
省略された場合、パッケージのディレクトリー構造は作成されません。 .class ファイルを全く生成しない場合は、-d none を使用してください。 |
||||||||||||||
| -encoding <encoding name> | すべてのソース・ファイルのデフォルト・エンコードを指定します。それぞれの入力ソース・ファイル/フォルダー名に、[<encoding name>] のサフィックスを付けることにより、ファイルごとにカスタム・エンコードを指定することもできます。例えば、X.java[utf8] は、現行ユーザー・ディレクトリーにあるコンパイル単位 X.java の UTF-8 エンコードを指定します。複数のデフォルト・ソース・ファイル・エンコードが指定されている場合は、最後のものが使用されます。 例:
|
||||||||||||||
| 準拠オプション | |||||||||||||||
| -target 1.1 から 1.7 または (5、5.0 など) | .class ファイルのターゲット設定を指定します。
指定可能な値は以下のとおりです。
clcd1.1 は、StackMap 属性を生成するために使用できます。 |
||||||||||||||
| -1.3 | 準拠レベルを 1.3 に設定します。-source 1.3 -target 1.1 を暗黙的に設定します。 | ||||||||||||||
| -1.4 | 準拠レベルを 1.4 に設定します (デフォルト)。-source 1.3 -target 1.2 を暗黙的に設定します。 | ||||||||||||||
| -1.5 | 準拠レベルを 1.5 に設定します。-source 1.5 -target 1.5 を暗黙的に設定します。 | ||||||||||||||
| -1.6 | 準拠レベルを 1.6 に設定します。 -source 1.6 -target 1.6 を暗黙的に設定します。 | ||||||||||||||
| -1.7 | 準拠レベルを 1.7 に設定します。-source 1.7 -target 1.7 を暗黙的に設定します。 | ||||||||||||||
| -source 1.1 から 1.7 または (5、5.0 など) | これは、コンパイラーによって予想されるソース・レベルを指定するのに使用します。 指定可能な値は以下のとおりです。
|
||||||||||||||
| 警告オプション | |||||||||||||||
| -?:warn -help:warn | 詳細な警告オプションを表示します。 | ||||||||||||||
| -warn:... | 使用可能な警告のセットを指定します。
例: -warn:unusedLocal,deprecation
|
||||||||||||||
| デフォルト | トークン名 | 説明 | |||||||||||||
| +/- | allDeadCode | 一般的な if(DEBUG) 検査を含む不要コード | |||||||||||||
| +/- | allDeprecation | 使用されないコード内でも使用すべきではない | |||||||||||||
| - | allJavadoc | javadoc が無効または欠落 | |||||||||||||
| - | allOver-ann | 欠落しているすべての @Override 注釈 (スーパークラスおよびスーパーインターフェース) | |||||||||||||
| - | all-static-method | すべてのメソッドを静的警告として宣言できます | |||||||||||||
| + | assertIdentifier | 識別子として使用された assert の発生 | |||||||||||||
| - | boxing | オートボクシング型変換 | |||||||||||||
| + | charConcat | 文字配列が文字列に明示的に変換されることなく、文字列の連結で使用された場合 | |||||||||||||
| + | compareIdentical | 同一の式を比較 | |||||||||||||
| - | conditionAssign | 予期しないブールの代入 | |||||||||||||
| + | constructorName | コンストラクター名を持つメソッド | |||||||||||||
| + | deadCode | 一般的な if (DEBUG) 検査を除く不要コード | |||||||||||||
| - | dep-ann | @Deprecated 注釈の欠落 | |||||||||||||
| +/- | deprecation | 使用すべきでないコード外部での使用すべきでないタイプまたはメンバーの使用 | |||||||||||||
| + | discouraged | 阻止されるアクセス規則に一致するタイプの使用 | |||||||||||||
| - | emptyBlock | 文書化されていない空のブロック | |||||||||||||
| + | enumIdentifier | 識別子として使用された enum の発生 | |||||||||||||
| + | enumSwitch | 不完全な列挙スイッチ | |||||||||||||
| - | enumSwitchPedantic | default ケースが存在する場合であっても列挙型 switch case の欠落をレポート | |||||||||||||
| - | fallthrough | case のフォールスルーの可能性 | |||||||||||||
| - | fieldHiding | 別の変数が非表示のフィールド | |||||||||||||
| + | finalBound | 最終バウンドがあるタイプ・パラメーター | |||||||||||||
| + | finally | 正常に完了していない finally ブロック | |||||||||||||
| + | forbidden | 禁止されるアクセス規則に一致するタイプの使用 | |||||||||||||
| - | hashCode | equals() をオーバーライドするときの hashCode() メソッドの欠落 | |||||||||||||
| +/- | hiding | fieldHiding、localHiding、typeHiding および maskedCatchBlock のマクロ | |||||||||||||
| - | includeAssertNull | assert 式内の汚染された変数に対して NULL 警告を出す | |||||||||||||
| - | indirectStatic | 静的メンバーへの間接参照 | |||||||||||||
| + | intfAnnotation | スーパー・インターフェースとして使用される注釈型 | |||||||||||||
| + | intfNonInherited | インターフェースを継承しないメソッドの互換性 | |||||||||||||
| - | intfRedundant | 冗長スーパーインターフェースの検索 | |||||||||||||
| - | javadoc | 無効な javadoc | |||||||||||||
| - | localHiding | 別の変数が非表示のローカル変数 | |||||||||||||
| + | maskedCatchBlock | 隠れた catch ブロック | |||||||||||||
| - | nls | 非 nls の文字列リテラル (タグ //$NON-NLS-<n> が欠如) | |||||||||||||
| + | noEffectAssign | 効果のない代入 | |||||||||||||
| +/- | null | 潜在的な NULL 検査の欠落または冗長 | |||||||||||||
| - | nullAnnot | 注釈に基づいた NULL 分析を使用可能にします。 必要な場合、コンパイラーによって解釈される注釈型を、(nullable|nonnull|nonnullbydefault) を追加することにより指定できます。各注釈型は、完全修飾名を使用して指定します。 以下の -nonNullByDefault も参照してください。 |
|||||||||||||
| - | nullDereference | NULL 検査の欠落 | |||||||||||||
| - | over-ann | @Override 注釈の欠落 (スーパークラスのみ) | |||||||||||||
| - | paramAssign | パラメーターへの代入 | |||||||||||||
| + | pkgDefaultMethod | パッケージのデフォルト・メソッドを無効にする試行 | |||||||||||||
| + | raw | raw 型の使用 (パラメーター型の代わり) | |||||||||||||
| +/- | resource | Closeable 型のリソースの (潜在的に) 危険な使用法 | |||||||||||||
| - | semicolon | 不要なセミコロンまたは空のステートメント | |||||||||||||
| + | serial | serialVersionUID の欠落 | |||||||||||||
| - | specialParamHiding | 別のフィールドを非表示にするコンストラクターまたは setter パラメーター | |||||||||||||
| +/- | static-access | indirectStatic および staticReceiver のマクロ | |||||||||||||
| - | static-method | static メソッドになり得るインスタンス・メソッド | |||||||||||||
| + | staticReceiver | 静的フィールドの取得または静的メソッドの呼び出しに、静的ではない受信側が使用された場合 | |||||||||||||
| - | super | スーパーを呼び出さないでメソッドをオーバーライドする | |||||||||||||
| + | suppress | @SuppressWarnings を使用可能にする | |||||||||||||
| - | switchDefault | default ケースがない switch ステートメント | |||||||||||||
| - | syncOverride | synchronized 宣言されたメソッドのオーバーライドにおける synchronized の欠落 | |||||||||||||
| - | syntheticAccess | 内部クラスに対して合成アクセスを実行する場合 | |||||||||||||
| - | tasks | ソース・コード内でのタスク・タグのサポートを可能にする | |||||||||||||
| + | typeHiding | 別のタイプが非表示のタイプ・パラメーター | |||||||||||||
| + | unavoidableGenericProblems | 未加工 API による不可避の型の安全性に関する問題を無視する | |||||||||||||
| + | unchecked | 未検査の型操作 | |||||||||||||
| - | unnecessaryElse | 不要な ELSE 節 | |||||||||||||
| - | unqualifiedField | フィールドへの非修飾参照 | |||||||||||||
| +/- | unused | unusedAllocation、unusedArgument、unusedImport、unusedLabel、unusedLocal、unusedPrivate、unusedThrown および unusedTypeArgs のマクロ | |||||||||||||
| - | unusedAllocation | 使用されていないオブジェクトの割り振り | |||||||||||||
| - | unusedArgument | 未使用のメソッド引数 | |||||||||||||
| + | unusedImport | 未使用のインポート参照 | |||||||||||||
| + | unusedLabel | 未使用ラベル | |||||||||||||
| + | unusedLocal | 未使用のローカル変数 | |||||||||||||
| + | unusedPrivate | 未使用の private メンバー宣言 | |||||||||||||
| - | unusedThrown | 未使用で宣言済みのスローされた例外 | |||||||||||||
| + | unusedTypeArgs | メソッドおよびコンストラクターの未使用の型引数 | |||||||||||||
| - | uselessTypeCheck | 不要な cast/instanceof 演算命令 | |||||||||||||
| + | varargsCast | 可変引数に明示的なキャストが必要 | |||||||||||||
| +/- | warningToken | @SuppressWarnings での未処理または未使用の警告トークン | |||||||||||||
| -nowarn | 警告なし (-warn:none と同等) | ||||||||||||||
| -err:... | エラーに変換される使用可能な警告のセットを指定します。
例: -err:unusedLocal,deprecation 警告 unusedLocal および deprecation は、エラーに変換されます。 他の警告はすべて引き続き警告として報告されます。
|
||||||||||||||
| -deprecation | -warn:+deprecation と同等。 | ||||||||||||||
| -properties <file> | プロパティー・ファイルの内容に基づいて、警告/エラー・オプションを設定します。
このオプションは -nowarn、-err:..、または -warn:.. のオプションと共に使用できますが、
コマンド行の最後のものによって、使用されるオプションが設定されます。
プロパティー・ファイルの内容は、既存の java プロジェクト上でプロジェクト固有の設定値を設定し、
... org.eclipse.jdt.core.compiler.problem.annotationSuperInterface=warning org.eclipse.jdt.core.compiler.problem.assertIdentifier=warning org.eclipse.jdt.core.compiler.problem.autoboxing=ignore ... |
||||||||||||||
| デバッグ・オプション | |||||||||||||||
| -g[:none|:lines,vars,source] | デバッグの属性レベルを設定します
|
||||||||||||||
| -preserveAllLocals | すべてのローカル変数を保持することをコンパイラーに明示的に要求 (デバッグの目的)。 省略した場合、コンパイラーは未使用のローカル変数を削除します。 | ||||||||||||||
| 注釈処理オプション (1.6 以上の VM が必要であり、準拠レベルが 1.6 の場合にのみ使用します) | |||||||||||||||
| -Akey[=value] | 注釈プロセッサーに渡す注釈プロセッサー・オプション。key は、ドットで区切った ID のリストです。 |
||||||||||||||
| -proc:[only|none] | -proc:only を指定すると、注釈プロセッサーは実行されますが、コンパイルは実行されません。-proc:none を指定すると、注釈プロセッサーは発見されないか、実行されません。コンパイルは、注釈プロセッサーが見つからなかった場合と同じように処理されます。デフォルトでは、コンパイラーは注釈プロセッサーのクラスパスを検索する必要があるため、注釈処理が不要な場合に -proc:none を指定すると、コンパイルの速度が上がる可能性があります。 |
||||||||||||||
| -processor <class1[,class2,...]> | 実行する注釈プロセッサーの修飾付きのクラス名。指定した場合、通常のプロセッサー・ディスカバリー・プロセスはスキップされます。 | ||||||||||||||
| -processorpath <dir 1>;<dir 2>;...;<dir P> | 注釈プロセッサーを検索するディレクトリーまたは jar ファイルのリスト。 エントリーは、プラットフォームのパス・セパレーターにより分離されます。指定しない場合、代わりにクラスパスが検索されます。 | ||||||||||||||
| -s <dir> | 生成したソース・ファイルを作成するディレクトリー。 | ||||||||||||||
| -XprintProcessorInfo | プロセッサーで処理する注釈と要素に関する出力情報 | ||||||||||||||
| -XprintRounds | 注釈処理の丸めに関する出力情報 | ||||||||||||||
| -classNames <class1[,class2,...]> | 処理する必要があるバイナリー形式の修飾名 | ||||||||||||||
| 無視されるオプション (javac オプションとの互換用) | |||||||||||||||
| -J<option> | 仮想マシンにオプションを渡す | ||||||||||||||
| -X<option> | 標準外のオプションを指定。 -Xemacs は無視されません。 | ||||||||||||||
| -X | 標準外のオプションを印刷して終了 | ||||||||||||||
| -O | 実行時の最適化 | ||||||||||||||
| 拡張オプション | |||||||||||||||
| @<file> | ファイルからコマンド行の引数を読み取ります | ||||||||||||||
| -maxProblems <n> | コンパイル単位ごとの問題の最大数 (デフォルトは 100) | ||||||||||||||
| -log <filename> | コンパイラーからのすべての出力がダンプされるログ・ファイルを指定します。 これは、バッチ・コンパイラーをデバッグする場合や、バッチのビルドからすべてのエラーおよび警告が含まれたファイルを取得する場合、非常に役に立ちます。 拡張子が .xml の場合、生成されるログは xml ファイルになります。 | ||||||||||||||
| -Xemacs | emacs スタイルを使用してエラーと警告のロケーションをコンソールおよび通常のテキスト・ログに表示します。
XML ログは、このオプションによって影響を受けません。このオプションをアクティブにすると、メッセージは、
2. WARNING in /workspace/X.java以下のように表示されます。 /workspace/X.java:8: warning: The method... |
||||||||||||||
| -proceedOnError[:Fatal] | エラーが起こってもコンパイルを継続し、問題のメソッドまたは型があるクラス・ファイルをダンプします。これが推奨されるのは、エラーが残っていてもそのアプリケーションを実行する必要がある場合のみです。 ":Fatal" があると、すべてのオプション・エラーが重大エラーとして扱われ、実行時にエラーになるとコードが中止されます。 ":Fatal" がないと、オプション・エラーが発生してもコードは適切に生成されます。 生成された .class ファイルは問題なく実行することができます。 |
||||||||||||||
| -verbose | コンソールまたはログ・ファイル (指定された場合) に、アクセス/処理されたコンパイル単位を出力します | ||||||||||||||
| -referenceInfo | 参照情報を計算します。 これは、ビルダーに接続されている場合にのみ有用です。 それ以外の場合、参照情報は役に立ちません。 | ||||||||||||||
| -progress | 進行状況を表示します (-log モード時のみ)。 | ||||||||||||||
| -time | 速度情報を表示します。 | ||||||||||||||
| -noExit | コンパイルの最後に System.exit(n) を呼び出しません (エラーがない場合は n=0)。 | ||||||||||||||
| -repeat <n> | コンパイル処理を <n> 回繰り返します (パフォーマンス分析)。 | ||||||||||||||
| -inlineJSR | JSR バイトコードをインライン化します (target >= 1.5 の場合は暗黙)。 | ||||||||||||||
| -enableJavadoc | javadoc 内部の参照を考慮します。 | ||||||||||||||
| -missingNullDefault | 注釈に基づく NULL 分析が使用可能 (上述の「nullAnnot」を使用) である場合、このオプションは、パッケージまたは型にデフォルト注釈がないときに必ず警告を生成します。 | ||||||||||||||
| ヘルプ・オプション | |||||||||||||||
| -? -help | ヘルプ・メッセージを表示します。 | ||||||||||||||
| -v -version | コンパイラーのビルド番号を表示します。 これは、バグを報告する場合に非常に有用です。 | ||||||||||||||
| -showversion | コンパイラーのビルド番号を表示し、継続します。 これは、バグを報告する場合に非常に有用です。 | ||||||||||||||
d:¥temp -classpath rt.jar -time -g -d d:/tmp |
d:¥temp およびそのサブフォルダー内のすべてのソース・ファイルをコンパイルします。 クラスパスは、単に rt.jar です。 すべてのデバッグ属性を生成し、生成されたすべての .class ファイルが d:¥tmp にダンプされます。 コンパイラーの速度は、バッチ・プロセスの完了後に表示されます。 |
d:¥temp¥Test.java -classpath d:¥temp;rt.jar -g:none |
Test.java およびその従属ファイル (ある場合は、d:¥temp から従属ファイルを取得します) のみをコンパイルします。クラスパスは d:¥temp の後に rt.jar が付きます。これは、すべての必要なクラスが最初に d:¥temp、次に rt.jar で検索されるということです。デバッグ属性は生成されず、生成されたすべての .class ファイルが d:¥temp にダンプされます。 |