了解 Java 注释处理上下文中的增量环境

Question

我对 Java 注释处理上下文中的增量环境到底是什么感到困惑。高度赞赏一个例子。

以下是 Filer 的 Javadoc 的引用：

文件创建方法采用可变数量的参数来允许 作为工具提示提供的原始元素 更好地管理依赖关系的基础设施。起源元素 是类型或包（代表包信息文件） 导致注释处理器尝试创建新文件。为了 例如，如果注释处理器尝试创建源文件， generatedFromUserSource，响应处理

@Generate
公共类用户源{}

UserSource 的类型元素应作为 创建方法调用如下：

filer.createSourceFile("GenerateFromUserSource",
                       eltUtils.getTypeElement("UserSource"));

如果没有原始元素，则不需要传递任何元素。 这个 信息可用于增量环境中以确定 需要重新运行处理器或删除生成的文件。非增量式 环境可能会忽略原始元素信息。

我理解，例如，在上面的示例中，如果删除 @Generate ，则下次运行编译时将使用先前生成的 GenerateFromUserSource< /code> 将被删除。 （据说，显然，一些实现，例如com.sun.tools.javac .processing.JavacFiler 完全忽略原始元素。）这是否会使其增量？我没有想到任何需要重新运行处理器的示例。

为了让事情变得更加混乱，我偶然发现了这个 问题，显然，存在三种类型的处理器：

1. 动态、2.隔离、3.聚合

和增量处理器需要在 META-INF 中与非增量处理器不同的位置注册。我目前正在使用 @AutoService，我认为不支持本次报名。

由于（大部分）Filer 中不允许覆盖，因此我希望能够澄清是什么使处理器增量。