Moderne licensed

Migrate to Spring Boot 3.1

Recipe IDorg.openrewrite.java.spring.boot3.UpgradeSpringBoot_3_1Artifactorg.openrewrite.recipe:rewrite-spring

Migrate applications to the latest Spring Boot 3.1 release. This recipe will modify an application's build files, make changes to deprecated/preferred APIs, and migrate configuration settings that have changes between versions. This recipe will also chain additional framework migrations (Spring Framework, Spring Data, etc) that are required as part of the migration to Spring Boot 3.0.

Composite recipespringbootMSAL

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.spring.boot3.UpgradeSpringBoot_3_1")
}

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-spring:6.40.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.spring.boot3.UpgradeSpringBoot_3_1

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

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

Definition

This recipe runs the following recipes in order.

Migrate to Spring Boot 3.0org.openrewrite.java.spring.boot3.UpgradeSpringBoot_3_0
Upgrade Gradle or Maven dependency versionsorg.openrewrite.java.dependencies.UpgradeDependencyVersion
Upgrade Gradle or Maven dependency versionsorg.openrewrite.java.dependencies.UpgradeDependencyVersion
Upgrade Maven plugin version org.springframework.boot:spring-boot-maven-plugin:3.1.xorg.openrewrite.maven.UpgradePluginVersion
Upgrade Maven parent project version to org.springframework.boot:spring-boot-starter-parent:3.1.xorg.openrewrite.maven.UpgradeParentVersion
Update a Gradle plugin by id org.springframework.bootorg.openrewrite.gradle.plugins.UpgradePluginVersion
Migrate to Spring Security 6.1org.openrewrite.java.spring.security6.UpgradeSpringSecurity_6_1
Migrate Spring Boot properties to 3.1org.openrewrite.java.spring.boot3.SpringBootProperties_3_1
Replace RepositoryRestConfigurerAdapter with RepositoryRestConfigurerorg.openrewrite.java.spring.data.MigrateRepositoryRestConfigurerAdapter
Upgrade Gradle or Maven dependency versionsorg.openrewrite.java.dependencies.UpgradeDependencyVersion
Migrate to Hibernate 6.2.xorg.openrewrite.hibernate.MigrateToHibernate62
Mockito 4 to 5.x upgrade onlyorg.openrewrite.java.testing.mockito.Mockito4to5Only
Upgrade to SpringDoc 2.2org.openrewrite.java.springdoc.UpgradeSpringDoc_2_2

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