在Gradle项目中启用Java 19预览与孵化器特性-小浪学习网

在Gradle项目中启用Java 19预览与孵化器特性

本教程详细阐述如何在gradle项目中配置Java 19的预览（如虚拟线程）和孵化器（如结构化并发）特性。通过修改build.gradle文件，设置compileJava任务的编译器参数和application插件的jvm启动参数，确保编译和运行时均正确启用这些实验性功能，从而顺利体验Java平台的新技术。

java平台持续演进，定期引入新的语言特性和api。为了让开发者能够提前体验和提供反馈，java引入了预览（preview）和孵化器（incubator）机制。java 19版本中，虚拟线程（virtual threads）作为预览特性，而结构化并发（structured concurrency）则作为孵化器特性被引入，它们代表了未来java并发编程的重要方向。要在基于gradle构建的项目中利用这些前沿功能，需要进行特定的配置。

理解预览与孵化器特性

在深入Gradle配置之前，了解这些特性的含义至关重要：

预览特性 (–enable-preview): 这些功能已基本完成，但尚未最终确定。它们可能在未来的Java版本中进行微调或移除。使用时必须通过–enable-preview参数显式启用。
孵化器特性 (–add-modules): 这些功能仍处于早期探索阶段，旨在收集社区反馈。它们通常位于特定的孵化器模块中，需要通过–add-modules参数显式添加。对于Java 19，结构化并发位于jdk.incubator.concurrent模块中。

Gradle配置步骤

要在Gradle项目中启用Java 19的预览和孵化器特性，需要分别配置项目的编译阶段和运行阶段。

1. 配置编译阶段 (compileJava 任务)

在build.gradle文件中，通过配置compileJava任务的options.compilerArgs属性来添加所需的编译器参数。这些参数指示java编译器在编译时启用预览功能并引入孵化器模块。

–release 19: 指定编译器目标Java版本为19。
–enable-preview: 启用Java 19的预览特性。
–add-modules jdk.incubator.concurrent: 添加结构化并发所在的孵化器模块。

apply plugin: 'java' // 确保应用了Java插件  compileJava {     options.compilerArgs.addAll(['--release', '19'])     options.compilerArgs.addAll(['--enable-preview'])     options.compilerArgs.addAll(['--add-modules', 'jdk.incubator.concurrent']) }

2. 配置运行阶段 (application 插件)

如果你的项目使用了application插件来生成可执行的JAR或启动脚本，那么还需要为应用程序的JVM启动配置相应的运行时参数。这通过application插件的applicationDefaultJvmArgs属性完成。

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

–enable-preview: 启用Java 19的预览特性。
–add-modules jdk.incubator.concurrent: 添加结构化并发所在的孵化器模块。

apply plugin: 'application' // 确保应用了Application插件  // 替换为你的主类，例如： mainClassName = "net.codetojoy.Runner"  application {     applicationDefaultJvmArgs = ['--enable-preview',                                  '--add-modules', 'jdk.incubator.concurrent'] }

完整build.gradle示例

结合上述配置，一个启用Java 19预览与孵化器特性的完整build.gradle文件示例如下：

// 推荐使用plugins DSL来声明插件 plugins {     id 'java'     id 'application'     // id 'org.gradle.toolchains.foojay-resolver' version '0.5.0' // 如果需要自动下载JDK }  group = 'com.example' version = '1.0-SNAPSHOT'  repositories {     mavenCentral() }  dependencies {     // 你的项目依赖，例如：     // implementation 'org.slf4j:slf4j-api:1.7.32'     // testImplementation 'org.junit.jupiter:junit-jupiter-api:5.9.1'     // testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.9.1' }  // 替换为你的主类 mainClassName = "net.codetojoy.Runner"  // 配置编译Java代码的JDK版本和特性 compileJava {     options.compilerArgs.addAll(['--release', '19']) // 指定目标Java版本     options.compilerArgs.addAll(['--enable-preview']) // 启用预览特性     options.compilerArgs.addAll(['--add-modules', 'jdk.incubator.concurrent']) // 添加孵化器模块 }  // 配置应用程序运行时的JVM参数 application {     applicationDefaultJvmArgs = ['--enable-preview',                                  '--add-modules', 'jdk.incubator.concurrent'] }  // 针对测试任务的配置，如果需要启用预览特性，也需添加 tasks.named('test') {     useJUnitPlatform()     jvmArgs(['--enable-preview', '--add-modules', 'jdk.incubator.concurrent']) }  // 可选：使用Gradle Toolchain配置JDK，这是一种更现代和推荐的方式 // java { //     toolchain { //         languageVersion = JavaLanguageVersion.of(19) //     } // }

注意事项

Gradle版本兼容性: 确保你的Gradle版本支持Java 19。例如，Gradle 7.6及更高版本提供了对Java 19的良好支持。建议使用Gradle Wrapper来管理项目所需的Gradle版本，以确保环境一致性。
JDK安装: 你的开发环境需要安装Java 19 JDK。如果使用Gradle Toolchain，Gradle可以自动管理和下载所需的JDK。
特性稳定性: 预览和孵化器特性并非最终版本，它们在未来的Java版本中可能会发生变化，甚至被移除。在生产环境中使用这些特性时需谨慎，并密切关注Java平台的官方发布说明。
编译与运行一致性: 务必确保编译和运行阶段都正确配置了–enable-preview和–add-modules参数。缺少任何一个都可能导致编译失败或运行时错误。
模块名称: 孵化器模块的名称可能会随着Java版本迭代而变化。请查阅相应Java版本的官方文档以获取最新信息。
测试配置: 如果你的测试代码也使用了这些预览或孵化器特性，请确保在test任务中也配置了相应的JVM参数。