注解处理器在编译期通过Element和TypeMirror提取Java变量元数据，不操作运行时值；需过滤FIELD元素、调用VariableElement方法获取名称类型等，并用Filer生成JSON或Java文件。

Java 变量本身不能直接“在注解处理器中生成”，但变量的元数据（如名称、类型、修饰符、所属类、是否被特定注解标记等）可以在注解处理器中被提取、分析，并用于生成新的元数据文件（如 spring-configuration-metadata.json）或辅助代码（如 Builder 类、DTO 映射类等）。

关键在于：注解处理器运行在编译期，它不操作运行时变量值，而是通过 Java 编译器提供的 javax.annotation.processing 和 com.sun.source.tree 等 API，扫描源码中的元素（包括字段/变量），读取其结构信息和关联注解，再据此生成新文件或类。

---

注解处理器如何获取并处理 Java 变量的元数据

你需要在处理器中：

• 使用 RoundEnvironment 获取所有被目标注解标记的元素；
• 过滤出 ElementKind.FIELD 类型的元素（即类中的成员变量）；
• 调用 VariableElement 接口方法提取变量信息；
• 结合 Types、Elements 工具类解析类型、包名、默认值等；
• 最终写入 JSON 文件或生成 .java 源文件。

例如，处理一个带 @ConfigurationProperties 的配置类：

立即学习“Java免费学习笔记（深入）”；

Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

@ConfigurationProperties(prefix = "app")
public class AppProperties {
    private String name;
    private int version;
}

注解处理器会识别 AppProperties 类，遍历其所有 FIELD 元素，提取：

• 字段名：name, version
• 类型：String, int
• 所属类：AppProperties
• 是否有 @NotNull、@DefaultValue 等扩展注解

然后生成元数据片段：

{
  "name": "app.name",
  "type": "java.lang.String",
  "description": "",
  "sourceType": "com.example.AppProperties"
}

---

实现步骤简明清单

• 声明支持的注解
  在 process() 方法开头，用 getSupportedAnnotationTypes() 声明要监听的注解（如 "org.springframework.boot.context.properties.ConfigurationProperties"）。

• 遍历被注解的类型元素

  for (Element element : roundEnv.getElementsAnnotatedWith(ConfigurationProperties.class)) {
      if (element.getKind() == ElementKind.CLASS) {
          TypeElement typeElement = (TypeElement) element;
          // 遍历该类所有字段
          for (Element enclosed : typeElement.getEnclosedElements()) {
              if (enclosed.getKind() == ElementKind.FIELD) {
                  VariableElement field = (VariableElement) enclosed;
                  String fieldName = field.getSimpleName().toString();
                  TypeMirror fieldType = field.asType();
                  // 获取类型全限定名：types.erasure(fieldType).toString()
                  // 获取是否为 final / static：field.getModifiers()
              }
          }
      }
  }

• 使用工具类增强解析能力

  • Types：解析泛型、原始类型、数组等
  • Elements：获取包名、类名、Javadoc 注释
  • Messager：输出编译期提示或错误

• 生成元数据文件（如 JSON）
  使用 Filer 创建资源文件（非 .java）：

  FileObject resource = filer.createResource(
      StandardLocation.CLASS_OUTPUT,
      "",
      "META-INF/spring-configuration-metadata.json"
  );
  try (Writer writer = resource.openWriter()) {
      writer.write(jsonContent); // 手动拼或用 Jackson/Gson 序列化
  }

---

注意事项

• 注解必须声明为 @Retention(RetentionPolicy.SOURCE) 或 CLASS，才能被注解处理器读到（RUNTIME 注解也可，但非必需）；
• 不要依赖反射（Class<?>），因为源码尚未编译成 class，只能用 Element 和 TypeMirror；
• 字段默认值（如 private String env = "dev";）无法直接从 VariableElement 获取，需借助 TreePath + JavacTrees（较复杂，通常只处理 @DefaultValue("xxx") 这类显式注解）；
• Spring Boot 的 spring-boot-configuration-processor 就是典型实现，它扫描 @ConfigurationProperties 并生成 spring-configuration-metadata.json，供 IDE 提示和配置校验使用。

---

不复杂但容易忽略。