如何在Maven插件构建阶段获取依赖类并检查类注解

• 借助Maven核心组件实现：
  1. 在插件的Mojo类中注入@Component注解的DependencyGraphBuilder、ArtifactResolver，以及MavenProject对象。
  2. 调用dependencyGraphBuilder.buildDependencyGraph(project, null)生成完整依赖图，遍历图中DependencyNode节点获取对应Artifact。
  3. 通过artifactResolver.resolve(artifact, project.getRemoteArtifactRepositories(), project.getLocalRepository())确保依赖包已下载到本地仓库。
  4. 将依赖的JAR文件转为File对象，用JarFile或ASM、Javassist等工具读取其中的.class文件。
• 关键细节：
  • 可通过DependencyNode.getDependency().getScope()过滤特定范围的依赖（如仅编译依赖）。
  • 依赖图默认包含传递依赖，若只需直接依赖，可在构建时设置过滤规则。

获取依赖类列表并检查注解 #

按以下步骤实现：

1. 参照问题1的方法获取所有依赖JAR文件。
2. 用ASM（轻量字节码框架，无需加载类到JVM）遍历.class文件检查注解，示例代码：

   JarFile jarFile = new JarFile(artifactFile);
   Enumeration<JarEntry> entries = jarFile.entries();
   while (entries.hasMoreElements()) {
       JarEntry entry = entries.nextElement();
       if (entry.getName().endsWith(".class") && !entry.isDirectory()) {
           ClassReader cr = new ClassReader(jarFile.getInputStream(entry));
           cr.accept(new ClassVisitor(Opcodes.ASM9) {
               @Override
               public AnnotationVisitor visitAnnotation(String descriptor, boolean visible) {
                   // 匹配目标注解的内部描述符，如@MyAnnotation对应"Lcom/example/MyAnnotation;"
                   if ("Lcom/example/MyAnnotation;".equals(descriptor)) {
                       System.out.println("找到带注解的类：" + entry.getName());
                   }
                   return super.visitAnnotation(descriptor, visible);
               }
           }, ClassReader.SKIP_CODE | ClassReader.SKIP_DEBUG);
       }
   }
   jarFile.close();
   

3. 若用Javassist也可实现，但需注意类加载冲突问题，ASM更适合这类轻量扫描场景。

能否从pom获取源类并遍历检查？ #

• 直接从pom无法获取依赖源类，因为pom仅声明编译后的JAR构件，只有当依赖额外提供源码JAR（需配置<classifier>sources</classifier>）时才能获取。
• 若要检查源文件注解：
  1. 解析依赖时指定sources classifier，下载对应源码JAR。
  2. 解压源码JAR，用JavaParser等语法解析器遍历.java文件检查注解。
  3. 注意：并非所有依赖都提供源码JAR，这种方式局限性较大，多数场景下检查编译后的.class文件更可靠。

内容的提问来源于stack exchange，提问作者Piterowsky