如何为不同JDK版本编译差异化代码？多方案探讨及疑问

1. 如何为不同JDK版本编译不同代码？ #

用Gradle Kts可以通过sourceSets划分不同JDK版本的源码目录，配合编译任务配置实现分版本编译，具体操作如下：

• 调整目录结构：在主源码目录下新增版本专属源码文件夹，通用代码（比如接口、公共工具类）放在共享目录：

  src/
    main/
      java/           # 通用共享代码
      java8/          # Java 8专属降级实现
      java21/         # Java 21专属优化实现
  

• Gradle Kts配置示例：

  plugins {
      `java-library`
  }
  
  // 注册Java 8编译任务
  val java8Compile by tasks.registering(JavaCompile::class) {
      sourceSets.main.get().java.srcDirs("src/main/java", "src/main/java8")
      sourceCompatibility = JavaVersion.VERSION_1_8
      targetCompatibility = JavaVersion.VERSION_1_8
      options.release.set(8)
      // 指定Java 8的JDK路径，可通过环境变量或项目属性配置
      executable = System.getenv("JAVA_8_HOME") + "/bin/javac"
  }
  
  // 注册Java 21编译任务
  val java21Compile by tasks.registering(JavaCompile::class) {
      sourceSets.main.get().java.srcDirs("src/main/java", "src/main/java21")
      sourceCompatibility = JavaVersion.VERSION_21
      targetCompatibility = JavaVersion.VERSION_21
      options.release.set(21)
      executable = System.getenv("JAVA_21_HOME") + "/bin/javac"
  }
  
  // 生成对应版本的Jar包
  val jar8 by tasks.registering(Jar::class) {
      dependsOn(java8Compile)
      from(java8Compile.get().destinationDir)
      archiveClassifier.set("jdk8")
  }
  
  val jar21 by tasks.registering(Jar::class) {
      dependsOn(java21Compile)
      from(java21Compile.get().destinationDir)
      archiveClassifier.set("jdk21")
  }
  
  // 配置发布任务
  publishing {
      publications {
          create<MavenPublication>("mavenJdk8") {
              artifact(jar8)
              // 补充groupId、artifactId、version等Maven元数据
          }
          create<MavenPublication>("mavenJdk21") {
              artifact(jar21)
              // 补充Maven元数据
          }
      }
  }
  

• 核心逻辑：通用代码共享，差异化实现隔离在版本专属目录，通过编译任务绑定对应JDK版本和源码目录，最终生成带版本分类器的Jar包（如xxx-jdk8.jar、xxx-jdk21.jar）发布。

2. 该需求能否通过注解处理器实现？ #

理论上可行，但完全没必要。

• 实现思路：自定义@JdkSpecific(8)、@JdkSpecific(21)这类注解标记版本专属代码，编写注解处理器在编译时根据目标JDK版本保留或剔除对应代码。
• 问题：需要手动处理编译期代码筛选、字节码生成逻辑，还要兼容不同JDK的注解处理API，实现复杂度远高于sourceSets方案，且容易引入编译期bug，后续维护成本极高。

3. 哪种方案最适配你的原需求？ #

首选方案5（通过Gradle sourceSets控制编译文件），理由如下：

• 无代码重复：通用代码共享，差异化实现隔离存储，彻底解决双仓库/模块的代码冗余问题。
• 无运行时开销：编译阶段直接生成对应版本的字节码，不需要运行时版本判断，性能最优。
• 配置可控：Gradle的sourceSets和编译任务属于标准功能，文档完善，调试完成后维护成本低。
• 对比其他方案：
  • 双仓库/模块：代码重复是致命缺陷，直接排除。
  • 宏：Java原生不支持，依赖非标准JDK，不可行。
  • 运行时分支：需要到处添加版本判断逻辑，代码冗余且有性能损耗，排除。
  • 注解处理器：实现复杂度太高，性价比极低，排除。

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