Java Compiler API 核心原理与应用场景

2. JavaFileObject：源码与字节码的统一抽象

public interface JavaFileObject extends FileObject

它抽象了：

• .java 源码
• .class 字节码
• 内存中的'虚拟文件'

常见实现

• SimpleJavaFileObject
• StandardJavaFileManager 内部实现

这也是 '内存编译''动态代码生成' 的基础。

3. JavaFileManager：编译输入 / 输出控制中心

负责：

• 源文件的查找
• classpath / module-path 的解析
• 编译产物（.class）的输出位置

StandardJavaFileManager fm = compiler.getStandardFileManager(diagnostics, null, null);

高级用法

• 自定义 JavaFileManager
• 将 .class 输出到：
  • 内存
  • 数据库
  • 网络
  • 自定义 ClassLoader

4. CompilationTask：一次完整的编译任务

JavaCompiler.CompilationTask task = compiler.getTask(writer, fileManager, diagnostics, options, classes, compilationUnits);

参数语义

5. Diagnostic：编译错误的结构化表示

for (Diagnostic<?> d : diagnostics.getDiagnostics()) {
    System.out.println(d.getKind());
    System.out.println(d.getMessage(null));
}

可获取：

• 错误 / 警告 / 提示
• 行号、列号
• 源文件
• 错误码

这使得 IDE、代码分析器、在线判题系统 成为可能。

四、最小可运行示例

1. 编译磁盘上的 Java 文件

JavaCompiler compiler = ToolProvider.getSystemJavaCompiler();
DiagnosticCollector<JavaFileObject> diagnostics = new DiagnosticCollector<>();
StandardJavaFileManager fileManager = compiler.getStandardFileManager(diagnostics, null, null);
Iterable<? extends JavaFileObject> units = fileManager.getJavaFileObjectsFromStrings(List.of("HelloWorld.java"));
boolean success = compiler.getTask(null, fileManager, diagnostics, null, null, units).call();

2. 内存编译（无文件系统）

核心思路：

• 自定义 SimpleJavaFileObject
• 用 String 存源码
• 用 ByteArrayOutputStream 存 .class

这是 脚本引擎 / DSL / 规则引擎 的基础能力。

五、与 Annotation Processing（JSR 269）的关系

Java Compiler API 与 注解处理器 深度集成：

javac ├─ Parse ├─ Enter ├─ Annotation Processing ← APT ├─ Attr ├─ Flow ├─ Desugar └─ Generate 

典型应用

• Lombok
• MapStruct
• AutoValue
• Dagger
• 自研代码生成器

你可以通过 Compiler API 显式启用 / 控制注解处理器。

六、典型应用场景

1. 代码分析 / 静态检查

• 自研 Sonar 规则引擎
• 编译级 AST 校验
• API 兼容性检查

2. 动态代码执行

• 在线判题系统
• 规则引擎
• 表达式语言（EL / DSL）

3. 插件系统

• 热加载业务逻辑
• 用户自定义扩展
• 脚本替代 Groovy / JS

4. IDE / 工具链

• 语法检查
• 实时错误提示
• 编译日志可视化

七、与 Roslyn（C#）的对比

Java Compiler API 偏'编译控制'
Roslyn 偏'编译平台'

八、局限性与注意事项

1. 不是官方 Script Engine
2. API 偏底层，使用成本高
3. AST 操作不如 Roslyn 直观
4. 模块化（JPMS）后 classpath 配置更复杂
5. 不适合频繁高并发动态编译（需缓存 ClassLoader）

九、总结一句话

Java Compiler API 是'把 javac 变成库'的官方标准方案，是构建 Java 代码分析、动态编译、DSL、工具链与平台级能力的基础设施。