Moderne licensed

Migrate to Java 21

Recipe IDorg.openrewrite.java.migrate.UpgradeToJava21Artifactorg.openrewrite.recipe:rewrite-migrate-java

This recipe will apply changes commonly needed when migrating to Java 21. This recipe will also replace deprecated API with equivalents when there is a clear migration strategy. Build files will also be updated to use Java 21 as the target/source and plugins will be also be upgraded to versions that are compatible with Java 21.

Composite recipejava21MSAL

Add to your build

Get a download tokenThis recipe is Moderne licensed, so the token must belong to a Moderne customer. It replaces YOUR_DOWNLOAD_TOKEN below.

~/.gradle/gradle.properties

codeGenomeUsername=you@example.com
codeGenomeToken=YOUR_DOWNLOAD_TOKEN

build.gradle.kts

plugins {
    id("org.openrewrite.rewrite") version("latest.release")
}

rewrite {
    activeRecipe("org.openrewrite.java.migrate.UpgradeToJava21")
}

repositories {
    mavenCentral()
    maven {
        url = uri("https://artifacts.codegenomeproject.org/maven")
        credentials {
            username = providers.gradleProperty("codeGenomeUsername").get()
            password = providers.gradleProperty("codeGenomeToken").get()
        }
    }
}

dependencies {
    rewrite("org.openrewrite.recipe:rewrite-migrate-java:3.45.0")
}

Then run

./gradlew rewriteRun

Usage

This recipe has no required configuration options. You’ll need the Moderne CLI configured before running the command below.

mod run . --recipe org.openrewrite.java.migrate.UpgradeToJava21

If the recipe isn’t available locally, install it with:

mod config recipes jar install org.openrewrite.recipe:rewrite-migrate-java:RELEASE

Definition

This recipe runs the following recipes in order.

Migrate to Java 17org.openrewrite.java.migrate.UpgradeToJava17
Upgrade build to Java 21org.openrewrite.java.migrate.UpgradeBuildToJava21
Remove extra semicolonsorg.openrewrite.staticanalysis.RemoveExtraSemicolons
Replace Thread.resume(), Thread.stop(), and Thread.suspend() with throw new UnsupportedOperationException()org.openrewrite.java.migrate.lang.ThreadStopUnsupported
Convert new URL(String) to URI.create(String).toURL()org.openrewrite.java.migrate.net.URLConstructorToURICreate
Adopt SequencedCollectionorg.openrewrite.java.migrate.util.SequencedCollection
Prefer Locale.of(..) over new Locale(..)org.openrewrite.java.migrate.util.UseLocaleOf
Replace deprecated Runtime#exec() methodsorg.openrewrite.staticanalysis.ReplaceDeprecatedRuntimeExecMethods
Upgrade actions/setup-java java-versionorg.openrewrite.github.SetupJavaUpgradeJavaVersion
Upgrade plugins to Java 21 compatible versionsorg.openrewrite.java.migrate.UpgradePluginsForJava21
Avoid using the deprecated empty finalize() method in java.desktoporg.openrewrite.java.migrate.DeleteDeprecatedFinalize
Adopt javax.security.auth.Subject.current() and javax.security.auth.Subject.callAs() methods`org.openrewrite.java.migrate.RemovedSubjectMethods
If-else-if-else to switchorg.openrewrite.java.migrate.lang.IfElseIfConstructToSwitch
Add null check to existing switch casesorg.openrewrite.java.migrate.lang.NullCheckAsSwitchCase
Convert assigning Switch statements to Switch expressionsorg.openrewrite.java.migrate.lang.SwitchCaseAssignmentsToSwitchExpression
Convert switch cases where every case returns into a returned switch expressionorg.openrewrite.java.migrate.lang.SwitchCaseReturnsToSwitchExpression
Convert switch expression yield to arroworg.openrewrite.java.migrate.lang.SwitchExpressionYieldToArrow
Adopt switch pattern matching (JEP 441)org.openrewrite.java.migrate.SwitchPatternMatching
Remove illegal semicolonsorg.openrewrite.java.migrate.RemoveIllegalSemicolons

Data tables

Structured output this recipe can produce.

Maven metadata failuresAttempts to resolve maven metadata that failed.org.openrewrite.maven.table.MavenMetadataFailures
Source files that had resultsSource files that were modified by the recipe run.org.openrewrite.table.SourcesFileResults
Source files that had search resultsSearch results that were found during the recipe run.org.openrewrite.table.SearchResults
Source files that errored on a recipeThe details of all errors produced by a recipe run.org.openrewrite.table.SourcesFileErrors
Recipe performanceStatistics used in analyzing the performance of recipes.org.openrewrite.table.RecipeRunStats