如何获取外部库中Java枚举源码以生成带注释的Markdown表格？

要解决外部Jar中枚举无法生成带注释的Markdown表格问题，核心是获取对应依赖的源码Jar包（编译后的class文件不保留Javadoc注释，只有源码Jar才有完整注释），以下是具体可行的实现路径：

1. 通过类引用定位依赖元数据，获取源码Jar #

你可以通过枚举类的引用间接拿到其所在Jar的Maven元数据，再以此下载源码Jar：

• 首先，从类对象获取所在Jar的路径：

  URL jarUrl = MyEnum.class.getProtectionDomain().getCodeSource().getLocation();
  

• 然后读取Jar内的META-INF/maven/<groupId>/<artifactId>/pom.properties文件，该文件包含了groupId、artifactId、version这三个核心依赖坐标（大部分正规Maven发布的Jar都会包含这个文件）。
• 有了依赖坐标后，构造源码Jar的坐标：源码Jar的命名规则通常是[artifactId]-[version]-sources.jar，比如主Jar是example-1.0.0.jar，源码Jar就是example-1.0.0-sources.jar。
• 使用Maven Resolver库（官方的依赖解析工具）编程式下载源码Jar到本地仓库，或者直接读取远程仓库的源码Jar流。

2. 解析源码Jar中的枚举类 #

拿到源码Jar后，需要读取对应的.java文件并解析其中的枚举信息：

• 定位源码Jar中对应类的路径：比如全类名com.example.MyEnum对应的源码路径是com/example/MyEnum.java。
• 使用Java源码解析库处理文件，推荐JavaParser（轻量易用）或Eclipse JDT Core（功能强大）：
  示例（JavaParser）：

  // 从源码Jar中读取MyEnum.java的输入流
  InputStream sourceStream = ...;
  CompilationUnit cu = JavaParser.parse(sourceStream);
  // 找到枚举声明
  EnumDeclaration enumDecl = cu.findFirst(EnumDeclaration.class).get();
  // 遍历每个枚举常量
  for (EnumConstantDeclaration constant : enumDecl.getEntries()) {
      // 获取常量名
      String name = constant.getNameAsString();
      // 获取构造参数值（比如示例中的1、2）
      String code = constant.getArguments().get(0).toString();
      // 获取Javadoc注释
      Optional<Javadoc> javadoc = constant.getJavadoc();
      String description = javadoc.map(jd -> jd.getDescription().toText()).orElse("");
      // 收集数据生成表格
  }
  

3. 处理无源码Jar的 fallback 方案 #

如果依赖没有发布源码Jar，确实无法获取注释信息，此时可以：

• 仅从class文件提取枚举常量名和构造参数值（虽然没有注释，但能保证表格的基本结构）；
• 提示用户手动补充该枚举的注释信息；
• 尝试从class文件的Deprecated等注解中提取有限信息，但无法替代Javadoc。

关键注意事项 #

• 确保你的插件运行环境能访问Maven仓库（本地+远程），如果是离线环境，需要提前下载好依赖的源码Jar；
• 部分非Maven构建的Jar可能没有pom.properties文件，这种情况可以尝试解析Jar的Manifest文件，或者让用户手动输入依赖坐标；
• 解析源码时要处理各种语法情况（比如带多个构造参数、嵌套枚举等），保证兼容性。

内容的提问来源于stack exchange，提问作者Baksa Zoltán