パッケージjavax.tools
これらのインタフェースおよびクラスは、Java Platform, Standard Edition (Java SE)の一部として必要ですが、実装するツールを提供する必要はありません。
明示的に許可されていないかぎり、null引数が指定されている 合、またはnull要 を含む「リストまたはコレクション」が指定されている 合、このパッケージのすべてのメソッドがNullPointerExceptionをスローする可能性があります。 同様に、明示的に許可されていないかぎり、どのメソッドもnullを返すことはできません。
このパッケージは、Javaプログラミング言語コンパイラ・フレー ワークのホー です。 このフレー ワークのクライアントは、プログラ からコンパイラを検索し、実行することができます。 このフレー ワークには、診断(DiagnosticListener)への構 化アクセス用のサービス・プロバイダ・インタフェース(SPI)と、ファイル・アクセス(JavaFileManagerとJavaFileObject)をオーバーライドするためのファイル抽象化も用意されています。 SPIの使用方法の詳細は、JavaCompilerを参照してく さい。
実行時は、コンパイラは不要です。 た し、デフォルトのコンパイラが提供されている 合は、ToolProviderを使用して検索できます。次に例を示します:
JavaCompiler compiler = ToolProvider.getSystemJavaCompiler();
サービス・プロバイダ・メカニズ を利用して、代替のコンパイラまたはツールを提供できます。
たとえば、com.vendor.VendorJavaCompilerがJavaCompilerツールのプロバイダである 合、そのjarファイルには META-INF/services/javax.tools.JavaCompilerファイルが含まれます。 このファイルには、次の行が含まれます。
com.vendor.VendorJavaCompiler
jarファイルがクラス・パスにある 合、VendorJavaCompilerは次のようなコードを使用して検索できます:
JavaCompiler compiler = ServiceLoader.load(JavaCompiler.class).iterator().next();
- 導入されたバージョン:
- 1.6
-
クラス説明Diagnostic<S>ツールからの診断情 を表示するインタフェースです。診断情 の種類(エラー、警告など)です。診断情 を簡単に収集し、リスト化する手段を提供します。ツールからの診断情 を受け取るインタフェースです。プログラ からJavaプログラミング言語ドキュメント・ツールを起動するインタフェースです。ドキュメント・タスクのフューチャを表すインタフェースです。
DocumentationToolに固有の 所です。ツール用のファイルの抽象化です。ForwardingFileObject<F extends FileObject>指定されたファイル・オブジェクトに呼出しを転送します。ForwardingJavaFileManager<M extends JavaFileManager>指定されたファイル・マネージャに呼出しを転送します。ForwardingJavaFileObject<F extends JavaFileObject>指定されたファイル・オブジェクトに呼出しを転送します。プログラ からJavaプログラミング言語コンパイラを起動するインタフェースです。コンパイル・タスクの将来を表すインタフェースです。Javaプログラミング言語のソース・ファイルおよびクラス・ファイルで動作するツールのファイル・マネージャ。ファイル・オブジェクトの 所のインタフェースです。Javaプログラミング言語のソース・ファイルおよびクラス・ファイルで動作するツールのファイル抽象化。JavaFileObjectの種類です。オプションを認識するインタフェースです。JavaFileObjectに含まれる大部分のメソッドに対して、簡単な実装を提供します。java.io.Fileとjava.nio.file.Pathに基づくファイル・マネージャ。文字列からPathオブジェクトを作成するファクトリ。ファイル・オブジェクトの標準の 所です。プログラ から呼出し可能なツールの共通インタフェースです。コンパイラのプロバイダなど、ツール・プロバイダを検索するメソッドを提供します。