軟體套件 javax.tools

為能夠從程序（例如，編譯器）中調用的工具提供介面。

請參見：
描述

介面摘要

Diagnostic<S>	用於來自工具的診斷的介面。
DiagnosticListener<S>	用於接收來自工具的診斷的介面。
FileObject	工具的檔案抽象。
JavaCompiler	從程序中調用 Java™ 程式語言編譯器的介面。
JavaCompiler.CompilationTask	表示編譯任務的 future 的介面。
JavaFileManager	在 Java™ 程式語言源和類別檔案之上進行操作的工具的檔案管理器。
JavaFileManager.Location	檔案物件位置的介面。
JavaFileObject	在 Java™ 程式語言源和類別檔案上進行操作的工具的檔案抽象。
OptionChecker	識別選項的介面。
StandardJavaFileManager	基於 java.io.File 的檔案管理器。
Tool	可以從程序中調用的工具的公共介面。

類別摘要

DiagnosticCollector<S>	提供將診斷收集到一個列表中的簡單方法。
ForwardingFileObject<F extends FileObject>	將調用轉發到給定的檔案物件。
ForwardingJavaFileManager<M extends JavaFileManager>	將調用轉發到給定的檔案管理器。
ForwardingJavaFileObject<F extends JavaFileObject>	將調用轉發到給定的檔案物件。
SimpleJavaFileObject	為 JavaFileObject 中的大多數方法提供簡單實作。
ToolProvider	為尋找工具提供者提供方法，例如，編譯器的提供者。

列舉摘要

Diagnostic.Kind	診斷的種類別，例如，錯誤或者警告。
JavaFileObject.Kind	JavaFileObject 的種類別。
StandardLocation	檔案物件的標準位置。

軟體套件 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