Moderne licensed

Migrate to Java 17

Recipe IDorg.openrewrite.java.migrate.UpgradeToJava17

Artifactorg.openrewrite.recipe:rewrite-migrate-java

This recipe will apply changes commonly needed when migrating to Java 17. Specifically, for those applications that are built on Java 8, this recipe will update and add dependencies on J2EE libraries that are no longer directly bundled with the JDK. 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 17 as the target/source and plugins will be also be upgraded to versions that are compatible with Java 17.

Composite recipejava17MSAL

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.UpgradeToJava17

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

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

Definition

This recipe runs the following recipes in order.

Migrate to Java 11org.openrewrite.java.migrate.Java8toJava11
Upgrade build to Java 17org.openrewrite.java.migrate.UpgradeBuildToJava17
Changes code to use Java 17's instanceof pattern matchingorg.openrewrite.staticanalysis.InstanceOfPatternMatch
Add @Serial annotation to serialVersionUIDorg.openrewrite.staticanalysis.AddSerialAnnotationToSerialVersionUID
Remove Runtime.traceInstructions(boolean) and Runtime.traceMethodCalls methodsorg.openrewrite.java.migrate.RemovedRuntimeTraceMethods
Change javax.tools.ToolProvider methods calls to staticorg.openrewrite.java.migrate.RemovedToolProviderConstructor
Change java.lang.reflect.Modifier and java.lang.invoke.ConstantBootstraps method calls to staticorg.openrewrite.java.migrate.RemovedModifierAndConstantBootstrapsConstructors
Add explicit import for Record classesorg.openrewrite.java.migrate.lang.ExplicitRecordImport
Use text blocksorg.openrewrite.java.migrate.lang.UseTextBlocks
Use java.security.cert instead of javax.security.certorg.openrewrite.java.migrate.DeprecatedJavaxSecurityCert
Adopt setLongThreadID in java.util.logging.LogRecordorg.openrewrite.java.migrate.DeprecatedLogRecordThreadID
Use SunJSSE instead of com.sun.net.ssl.internal.ssl.Providerorg.openrewrite.java.migrate.RemovedLegacySunJSSEProviderName
Set visibility of premain and agentmain methods to publicorg.openrewrite.java.migrate.Jre17AgentMainPreMainPublic
Remove Thread.countStackFrames() methodorg.openrewrite.java.migrate.DeprecatedCountStackFramesMethod
Replace finalize method in java.util.zip.ZipFile, java.util.zip.Inflater and java.util.zip.Deflaterorg.openrewrite.java.migrate.RemovedZipFinalizeMethods
Replace SSLSession.getPeerCertificateChain() methodorg.openrewrite.java.migrate.RemovedSSLSessionGetPeerCertificateChainMethodImpl
Replace com.sun.net.ssl packageorg.openrewrite.java.migrate.SunNetSslPackageUnavailable
Replace RMIConnectorServer.CREDENTIAL_TYPES constantorg.openrewrite.java.migrate.RemovedRMIConnectorServerCredentialTypesConstant
Replace finalize method in java.io.FileInputStream and java.io.FileOutputStreamorg.openrewrite.java.migrate.RemovedFileIOFinalizeMethods
Upgrade plugins to Java 17 compatible versionsorg.openrewrite.java.migrate.UpgradePluginsForJava17
Upgrade Gradle or Maven dependency versionsorg.openrewrite.java.dependencies.UpgradeDependencyVersion
Upgrade Gradle or Maven dependency versionsorg.openrewrite.java.dependencies.UpgradeDependencyVersion
Upgrade Maven dependency versionorg.openrewrite.maven.UpgradeDependencyVersion
Upgrade Maven plugin versionorg.openrewrite.maven.UpgradePluginVersion
Upgrade Gradle or Maven dependency versionsorg.openrewrite.java.dependencies.UpgradeDependencyVersion
Add lombok-mapstruct-binding when both MapStruct and Lombok are usedorg.openrewrite.java.migrate.AddLombokMapstructBinding
Enable Lombok annotation processororg.openrewrite.java.migrate.EnableLombokAnnotationProcessor

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