Apache HBase项目中HBase Unsafe依赖源码定位问题求助

一、该包的性质 #

org.apache.hadoop.hbase.unsafe包下的类是自动生成的，并非项目源码仓库中直接存在的手动编写文件。

二、生成方式与源码获取 #

HBase为了适配不同JDK版本的Unsafe API，通过代码生成机制创建HBasePlatformDependent类，具体细节如下：

• 生成逻辑集中在hbase-common模块的代码生成器目录（通常是src/main/java/org/apache/hadoop/hbase/util/generator）
• 执行Maven构建时，会触发内置的代码生成插件（如maven-antrun-plugin或自定义任务），根据当前环境的JDK版本生成适配的实现类，输出到hbase-common/target/generated-sources目录下
• 获取源码的步骤：
  1. 在项目根目录执行mvn compile完成构建
  2. 进入hbase-common/target/generated-sources目录，即可找到生成的org.apache.hadoop.hbase.unsafe包及对应类的源码
  3. 如果使用IDE，需要将generated-sources目录标记为源码根目录，IDE才会自动识别这些类

三、同类依赖的排查方法 #

遇到类似找不到源码的依赖类时，可以用以下方法追踪：

• 查看Maven调试日志：执行mvn compile -X开启调试模式，搜索目标类名，定位代码生成的触发流程和输出路径
• 检查pom.xml的插件配置：查找maven-antrun-plugin、maven-processor-plugin等插件配置，看是否包含生成源码的任务
• 利用IDE跳转功能：如果IDE能识别到生成类，直接用"Go to Declaration"跳转；若识别不到，手动前往项目的target/generated-sources或target/classes目录查找
• 查阅项目构建文档：HBase根目录的BUILDING.txt文件会说明代码生成等特殊构建流程
• 搜索项目内的代码生成逻辑：在项目中搜索"generator"、"codegen"等关键词，找到负责生成目标类的代码实现

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