Java SE 6 編譯器 API 完全指南：三種調用方式與動態編譯實戰

Java SE 6 引入標準化的 javax.tools 包，徹底改變了以往依賴 tools.jar 內部 API 的尷尬局面。本文系統講解三種調用編譯器的方式，並演示記憶體中動態編譯執行的進階技巧。

方式一：JavaCompiler 簡易 API

適用於簡單編譯場景，核心類 JavaCompiler、ToolProvider：

JavaCompiler compiler = ToolProvider.getSystemJavaCompiler();
// 參數：標準輸入、標準輸出、錯誤輸出、源文件路徑（可變參數）
int result = compiler.run(null, null, null, "Test.java");
System.out.println(result == 0 ? "編譯成功" : "編譯失敗");

特點：零配置、直接使用系統預設輸出流、返回碼判斷結果。

方式二：StandardJavaFileManager 精細控制

提供診斷監聽、編碼控制、輸出目錄自定義等企業級功能：

JavaCompiler compiler = ToolProvider.getSystemJavaCompiler();
DiagnosticCollector diagnostics = new DiagnosticCollector<>();
StandardJavaFileManager fileManager = compiler.getStandardFileManager(diagnostics, null, null);

// 準備編譯單元
Iterable compilationUnits = 
    fileManager.getJavaFileObjectsFromStrings(Arrays.asList("Test.java"));

// 編譯選項：-d 指定輸出目錄，-sourcepath 指定依賴源碼路徑
Iterable options = Arrays.asList("-d", "D:/output");

CompilationTask task = compiler.getTask(null, fileManager, diagnostics, options, null, compilationUnits);
boolean success = task.call();
fileManager.close();

// 詳細錯誤診斷
for (Diagnostic d : diagnostics.getDiagnostics()) {
    System.out.printf("行號:%d 錯誤:%s%n", d.getLineNumber(), d.getMessage(Locale.getDefault()));
}

方式三：記憶體中動態編譯與反射執行

無需磁盤 I/O，源碼以字串形式傳入，編譯後直接反射調用：

// 自定義 JavaFileObject 承載字串源碼
class StringSource extends SimpleJavaFileObject {
    private final String code;
    StringSource(String name, String code) {
        super(URI.create("string:///" + name.replace('.', '/') + Kind.SOURCE.extension), Kind.SOURCE);
        this.code = code;
    }
    @Override public CharSequence getCharContent(boolean ignoreEncodingErrors) { return code; }
}

// 使用示例
StringWriter writer = new StringWriter();
PrintWriter out = new PrintWriter(writer);
out.println("public class HelloWorld {");
out.println("  public static void main(String[] args) {");
out.println("    System.out.println(\"Hello, Dynamic Java!\");");
out.println("  }");
out.println("}");
out.close();

JavaFileObject source = new StringSource("HelloWorld", writer.toString());
CompilationTask task = compiler.getTask(null, null, diagnostics, null, null, Arrays.asList(source));
if (task.call()) {
    Class clazz = Class.forName("HelloWorld");
    clazz.getMethod("main", String[].class).invoke(null, (Object) new String[0]);
}

進階編譯選項速查

應用場景

• 動態規則引擎：業務規則以 Java 代碼存儲，運行時編譯執行
• 模板引擎：JSP/Velocity 等模板編譯為 Servlet
• 嵌入式腳本：為應用提供 Java 級別的擴展點
• 測試框架：動態生成測試用例並執行