バッチ・コンパイラーの使用

バッチ・コンパイラーの検索

バッチ・コンパイラー・クラスは、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 ビルド内部で使用できます。

バッチ・コンパイラーの実行

使用可能なオプション

推奨オプションは、背景がオレンジ色になっています。

複数回設定されているオプションがある場合、バッチ・コンパイラーは左から右にそれを使用します。 '+' または '-' なしの警告オプション (-warn:....) が使用されている場合、これは前に指定された警告のセットをオーバーライドします。 そのため、ユーザーはそのオプションが -warn オプションの他のすべての使用の前で指定されるようにする必要があります。

同じことが -err: オプションにも当てはまります。

名前 使用法
クラスパス・オプション
-bootclasspath <dir 1>;<dir 2>;...;<dir P> これは、コンパイラーにより使用されるクラス・ファイルのブートストラップに使用されるディレクトリーまたは JAR ファイルのリストです。 デフォルトで、実行中の VM のライブラリーが使用されます。 エントリーは、プラットフォームのパス・セパレーターにより分離されます。
各ディレクトリーまたはファイルでは、「[」と「]」の間でタイプのアクセス規則を指定することができます。

bootclasspath を指定しないと、コンパイラーは、システム・プロパティー sun.boot.class.path、vm.boot.class.path、org.apache.harmony.boot.class.path をこの順序で使用して、推定によってブート・クラスパスを判別します。

-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 エンコードを指定します。

複数のデフォルト・ソース・ファイル・エンコードが指定されている場合は、最後のものが使用されます。

例:

  • ... -encoding UTF-8 X.java[Cp1252] Y.java[UTF-16] Z.java ....
    すべてのソース・ファイルは UTF-8 エンコードを使って読み取られます (これには Z.java が含まれます)。 X.java は Cp1252 エンコードを使って読み取られ、Y.java は UTF-16 エンコードを使って読み取られます。
  • ... -encoding UTF-8 -encoding UTF-16 ....
    すべてのソース・ファイルは UTF-16 エンコードを使って読み取られます。 UTF-8 の -encoding オプションは無視されます。
  • ... -encoding Cp1252 /foo/bar/X.java[UTF-16] /foo/bar[UTF-8] ....
    すべてのソース・ファイルは Cp1252 エンコードを使って読み取られます。 /foo/bar ディレクトリー内のファイルのうち、X.java ファイルだけはエンコード UTF-16 を使って読み取られます。 そのディレクトリー内のその他のファイルはすべて UTF-8 エンコードを使用します。
準拠オプション
-target 1.1 から 1.7 または (5、5.0 など) .class ファイルのターゲット設定を指定します。 指定可能な値は以下のとおりです。
  • 1.1 (メジャー・バージョン: 45 マイナー: 3)
  • 1.2 (メジャー・バージョン: 46 マイナー: 0)
  • 1.3 (メジャー・バージョン: 47 マイナー: 0)
  • 1.4 (メジャー・バージョン: 48 マイナー: 0)
  • 1.5、5 または 5.0 (メジャー・バージョン: 49 マイナー: 0)
  • 1.6、6 または 6.0 (メジャー・バージョン: 50 マイナー: 0)
  • 1.7、7 または 7.0 (メジャー・バージョン: 51 マイナー: 0)
デフォルトは以下のとおりです。
  • 1.1。-1.3 モードの場合
  • 1.2。-1.4 モードの場合
  • 1.5。-1.5 モードの場合
  • 1.6。-1.6 モードの場合
  • 1.7。-1.7 モードの場合

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 など) これは、コンパイラーによって予想されるソース・レベルを指定するのに使用します。
指定可能な値は以下のとおりです。
  • 1.3
  • 1.4
  • 1.5、5 または 5.0
  • 1.6、6 または 6.0
  • 1.7、7 または 7.0
デフォルトは以下のとおりです。
  • 1.3。-1.3 モードの場合
  • 1.3。-1.4 モードの場合
  • 1.5。-1.5 モードの場合
  • 1.6。-1.6 モードの場合
  • 1.7。-1.7 モードの場合
1.4 では、assert がキーワードとみなされます。1.5 および 1.6 では、enum および assert がキーワードとみなされます。
警告オプション
-?:warn -help:warn 詳細な警告オプションを表示します。
-warn:... 使用可能な警告のセットを指定します。
例: -warn:unusedLocal,deprecation
-warn:none すべての警告を使用不可にします
-warn:<warning tokens separated by ,> リストされているとおりの警告を使用可能にします
-warn:+<warning tokens separated by ,> 追加の警告を使用可能にします
-warn:-<warning tokens separated by ,> 特定の警告を使用不可にします
以下のデフォルト列にある「+/-」マークは、複数の細分化された警告バリアントをまとめたオプションを示すもので、バリアントの一部はデフォルトで有効になっていますが、それ以外のものは無効になっています。 つまり、所定のオプションに「+」を指定するとデフォルトよりも多くの警告が有効になり、「-」を指定するとデフォルトで有効である警告の一部が無効になります。
デフォルト トークン名 説明
+/- 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 は、エラーに変換されます。 他の警告はすべて引き続き警告として報告されます。
-err:<warning tokens separated by ,> リストされているとおりの警告をエラーに変換します
-err:+<warning tokens separated by ,> 追加の警告をエラーに変換します
-err:-<warning tokens separated by ,> 特定の警告がエラーに変換されないようにします。
-deprecation -warn:+deprecation と同等。
-properties <file> プロパティー・ファイルの内容に基づいて、警告/エラー・オプションを設定します。 このオプションは -nowarn、-err:..、または -warn:.. のオプションと共に使用できますが、 コマンド行の最後のものによって、使用されるオプションが設定されます。

プロパティー・ファイルの内容は、既存の java プロジェクト上でプロジェクト固有の設定値を設定し、 .settings/org.eclipse.jdt.core.prefs ファイルにあるファイルをプロパティー・ファイルとして使用するか、 または、org.eclipse.jdt.core.JavaCore クラスに定義されている定数を使用する項目/値の組み合わせが定義されているシンプルなテキスト・ファイルを使用することにより生成できます。

...
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] デバッグの属性レベルを設定します
-g すべてのデバッグ情報 (-g:lines,vars,source と同等)
-g:none デバッグ情報なし
-g:[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
(at line 8)...

以下のように表示されます。
/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 にダンプされます。