Java Custom Annotation 的处理器代码什么时候调用？ （运行时保留）

Question

我知道 Custom Java Annotations 需要一个带有 @interface 的半接口声明和一个定义实际的 processor 代码（在某些文本中称为消费者代码）注释背后的业务逻辑。到目前为止很清楚，但我的问题是，处理器代码在何处/何时被调用以及由谁调用？我的意思是，Java 编译器是否生成调用所有注释处理器的代码，例如，在类加载时？还是程序员自己决定何时为他们的自定义注释调用他们的处理器代码？ 例如，@GetMapping("/users") 在某个方法上，告诉 servlet API 将请求映射到其请求路径中的 /users，应该传递给该方法。所以它在后台有一些处理器，应该调用它在某处存储此映射配置，但是何时以及谁调用该处理器？我想我的问题只对@Retention(RetentionPolicy.RUNTIME) 的注释有意义。谢谢

Answer 1

顾名思义，Annotation 是附加信息（或行为）。默认情况下，此信息不会被处理或用于更改任何行为。必须有一些实体来处理注释。

保留策略告诉 Java 编译器注解的范围。即是否需要在运行时或编译时处理额外的信息。

对于编译时处理，annotation processors 使用 -processor 标志挂接到编译过程。对于运行时处理，反射（例如this）用于访问附加信息。

@GetMapping("/users") 在某个方法上，告诉 servlet API 将请求映射到其请求路径中的 /users，

仅仅存在注释不会导致这种行为。 spring 框架（简化了很多）-

• 将自身安装为/* 的servlet 端点。见FrameworkServlet
• 使用反射枚举带有GetMapping注解的方法
• 使用带注释的信息来填充 URL 到方法的映射。
• 在处理请求时，使用映射路由到预期的方法。

理解流程的一个简单技巧（是的，Java 有时太神奇了）是安装断点并查看调用堆栈。

Answer 2

annotation processor 在编译时运行。调用javac 时，用户传递-processor 命令行选项，然后javac 调用处理器。注释处理器可以发出错误、创建文件（包括 Java 代码文件），甚至修改现有代码。除了上面链接的 Oracle 文档之外，您可能还想查看教程，例如 Baeldung's。

有些框架直接解释注解，所以你不需要编写自己的注解处理器。

为了影响运行时行为，您的代码可以反射性地读取注释；在这种情况下，编译时不会运行注释处理器。