Moderne licensed

Migrate to Spring Boot 4.0

Recipe IDio.moderne.java.spring.boot4.UpgradeSpringBoot_4_0

Artifactio.moderne.recipe:rewrite-spring

Migrate applications to the latest Spring Boot 4.0 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 4.0.

Composite recipespringbootProprietary

Usage

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

mod run . --recipe io.moderne.java.spring.boot4.UpgradeSpringBoot_4_0

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

mod config recipes jar install io.moderne.recipe:rewrite-spring:0.39.0

Definition

This recipe runs the following recipes in order.

Add managed Maven dependencyorg.openrewrite.maven.AddManagedDependency
Migrate to Spring Boot 3.5io.moderne.java.spring.boot3.UpgradeSpringBoot_3_5
Convert auto-configuration exclude to excludeNameorg.openrewrite.java.spring.ConvertAutoConfigurationExcludeToExcludeName
Migrate to Spring Cloud 2025.1org.openrewrite.java.spring.cloud2025.UpgradeSpringCloud_2025_1
Migrate from spring-cloud-contract-wiremock to wiremock-spring-bootio.moderne.java.spring.cloud.contract.MigrateWireMockToWireMockSpringBoot
Migrate to Spring Framework 7.0io.moderne.java.spring.framework7.UpgradeSpringFramework_7_0
Migrate to Spring Security 7.0org.openrewrite.java.spring.security7.UpgradeSpringSecurity_7_0
Migrate to Spring Batch 6.0 from 5.2org.openrewrite.java.spring.batch.SpringBatch5To6Migration
Use constructor injection for StoredProcedureItemReaderio.moderne.java.spring.batch.MigrateStoredProcedureItemReaderConstructor
Add comment to method invocationsorg.openrewrite.java.AddCommentToMethodInvocations
Add comment to method invocationsorg.openrewrite.java.AddCommentToMethodInvocations
Change typeorg.openrewrite.java.ChangeType
Change typeorg.openrewrite.java.ChangeType
Add setJobRegistry(..) to manually configured TaskExecutorJobOperatorio.moderne.java.spring.batch.AddJobRegistryToTaskExecutorJobOperator
Add @EnableJdbcJobRepository alongside @EnableBatchProcessingio.moderne.java.spring.batch.AddEnableJdbcJobRepository
Flag deprecated ChunkListener callbacks for manual migration to ChunkListener<I, O>io.moderne.java.spring.batch.FlagChunkListenerForManualMigration
Migrate Spring Boot properties to 4.0org.openrewrite.java.spring.boot4.SpringBootProperties_4_0
Replace @MockBean and @SpyBeanorg.openrewrite.java.spring.boot4.ReplaceMockBeanAndSpyBean
Migrate to Hibernate 7.2.xio.moderne.hibernate.MigrateToHibernate72
Migrate to testcontainers-java 2.xorg.openrewrite.java.testing.testcontainers.Testcontainers2Migration
Upgrade to SpringDoc 3.0org.openrewrite.java.springdoc.UpgradeSpringDoc_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 versionorg.openrewrite.maven.UpgradePluginVersion
Upgrade Maven parent project versionorg.openrewrite.maven.UpgradeParentVersion
Update a Gradle plugin by idorg.openrewrite.gradle.plugins.UpgradePluginVersion
Update Gradle wrapperorg.openrewrite.gradle.UpdateGradleWrapper
Update a Gradle plugin by idorg.openrewrite.gradle.plugins.UpgradePluginVersion
Upgrade Maven plugin versionorg.openrewrite.maven.UpgradePluginVersion
Upgrade Gradle or Maven dependency versionsorg.openrewrite.java.dependencies.UpgradeDependencyVersion
Migrate @AutoConfigureMockMvc HtmlUnit attributes to nested @HtmlUnitio.moderne.java.spring.boot4.MigrateAutoConfigureMockMvcHtmlUnit
Co-exclude UserDetailsServiceAutoConfiguration where SecurityAutoConfiguration is excludedio.moderne.java.spring.boot4.AddUserDetailsServiceAutoConfigurationExclusion
Migrate to Spring Boot 4.0 modular startersorg.openrewrite.java.spring.boot4.MigrateToModularStarters
Rename Spring Boot 4.0 starters with managed versionsorg.openrewrite.java.spring.boot4.RenameDeprecatedStartersManagedVersions
Change Gradle or Maven dependencyorg.openrewrite.java.dependencies.ChangeDependency
Change Gradle or Maven dependencyorg.openrewrite.java.dependencies.ChangeDependency
Change Gradle or Maven dependencyorg.openrewrite.java.dependencies.ChangeDependency
Change Gradle or Maven dependencyorg.openrewrite.java.dependencies.ChangeDependency
Change Gradle or Maven dependencyorg.openrewrite.java.dependencies.ChangeDependency
Remove a Gradle or Maven dependencyorg.openrewrite.java.dependencies.RemoveDependency
Change Gradle or Maven dependencyorg.openrewrite.java.dependencies.ChangeDependency
Upgrade Gradle or Maven dependency versionsorg.openrewrite.java.dependencies.UpgradeDependencyVersion
Upgrade Gradle or Maven dependency versionsorg.openrewrite.java.dependencies.UpgradeDependencyVersion
Change Gradle or Maven dependencyorg.openrewrite.java.dependencies.ChangeDependency
Upgrade Gradle or Maven dependency versionsorg.openrewrite.java.dependencies.UpgradeDependencyVersion
Add @AutoConfigureTestRestTemplate if necessaryorg.openrewrite.java.spring.boot4.AddAutoConfigureTestRestTemplate
Add @AutoConfigureWebTestClient if necessaryorg.openrewrite.java.spring.boot4.AddAutoConfigureWebTestClient
Spring Security 7 modularizationio.moderne.java.spring.security7.ModularizeSpringSecurity7
Sync Gradle ext properties with BOMorg.openrewrite.gradle.SyncGradleExtPropertiesWithBom
Migrate Spring Cloud properties to 2025.1io.moderne.java.spring.cloud20251.SpringCloudProperties_2025_1
Upgrade Gradle or Maven dependency versionsorg.openrewrite.java.dependencies.UpgradeDependencyVersion
Migrate Spring Cloud AWS (awspring) to 4.0io.moderne.java.spring.boot4.UpgradeAwspringCloud_4_0
Upgrade MyBatis to Spring Boot 4.0io.moderne.java.spring.boot4.UpgradeMyBatisToSpringBoot_4_0
Migrate Spring Retry to Spring Resilienceio.moderne.java.spring.boot4.MigrateSpringRetry
Add explicit version for REST Assuredio.moderne.java.spring.boot4.MigrateRestAssured
Upgrade Gradle or Maven dependency versionsorg.openrewrite.java.dependencies.UpgradeDependencyVersion
Change typeorg.openrewrite.java.ChangeType
Find and replaceorg.openrewrite.text.FindAndReplace
Change typeorg.openrewrite.java.ChangeType
Find and replaceorg.openrewrite.text.FindAndReplace
Change typeorg.openrewrite.java.ChangeType
Find and replaceorg.openrewrite.text.FindAndReplace
Change typeorg.openrewrite.java.ChangeType
Find and replaceorg.openrewrite.text.FindAndReplace
Change typeorg.openrewrite.java.ChangeType
Find and replaceorg.openrewrite.text.FindAndReplace
Change typeorg.openrewrite.java.ChangeType
Find and replaceorg.openrewrite.text.FindAndReplace
Change typeorg.openrewrite.java.ChangeType
Find and replaceorg.openrewrite.text.FindAndReplace
Upgrade to Java 21 when using jOOQio.moderne.java.spring.boot4.UpgradeToJava21WhenUsingJooq
Migrate to Jakarta EE 11org.openrewrite.java.migrate.jakarta.JakartaEE11
Migrate to JSpecifyorg.openrewrite.java.jspecify.MigrateToJSpecify
Change typeorg.openrewrite.java.ChangeType
Change typeorg.openrewrite.java.ChangeType
Migrate from Elasticsearch 8 to 9io.moderne.elastic.elastic9.MigrateToElasticsearch9
Migrate to Kafka 4.1io.moderne.kafka.MigrateToKafka41
Migrate DefaultResponseErrorHandler.handleError method signatureio.moderne.java.spring.framework.MigrateDefaultResponseErrorHandler
Migrate handleError method invocations to new signatureio.moderne.java.spring.framework.MigrateHandleErrorMethodInvocations
Remove path extension content negotiation methodsio.moderne.java.spring.framework.RemovePathExtensionContentNegotiation
Migrate deprecated path mapping optionsio.moderne.java.spring.framework.RemoveDeprecatedPathMappingOptions
Remove deprecated setPathMatcher() callsio.moderne.java.spring.framework.RemoveSetPathMatcherCall
Migrate HttpHeaders methods removed when MultiValueMap contract was droppedio.moderne.java.spring.framework.MigrateHttpHeadersMultiValueMapMethods
Add @MockitoSettings(strictness = Strictness.LENIENT) for @MockitoBean testsio.moderne.java.spring.boot4.AddLenientMockitoSettings
Add @AutoConfigureMockMvc to @SpringBootTest classes using MockMvcio.moderne.java.spring.boot4.AddAutoConfigureMockMvc
Add MongoDB representation properties for UUID and BigDecimalio.moderne.java.spring.boot4.AddMongoDbRepresentationProperties
Replace deprecated org.springframework.boot.autoconfigure.mongo APIio.moderne.java.spring.boot4.ReplaceDeprecatedAutoconfigureMongoApi
Replace deprecated DockerApiio.moderne.java.spring.boot4.ReplaceDeprecatedDockerApi
Replace deprecated RequestMatcherProvider with new APIio.moderne.java.spring.boot4.ReplaceDeprecatedRequestMatcherProvider
Replace deprecated ThreadPoolTaskSchedulerBuilder constructorio.moderne.java.spring.boot4.ReplaceDeprecatedThreadPoolTaskSchedulerBuilderApi
Replace removed RedisCacheConfiguration.getTtl()io.moderne.java.spring.boot4.ReplaceRedisCacheConfigurationGetTtl
Remove HttpMessageConvertersAutoConfiguration referencesio.moderne.java.spring.boot4.RemoveHttpMessageConvertersAutoConfigurationReferences
Migrate PropertyMapper API for Spring Boot 4.0io.moderne.java.spring.boot4.MigratePropertyMapper
Add useDefaultJaasConfig=true to MSSQL Kerberos JDBC URLsio.moderne.java.spring.boot4.AddMssqlKerberosJaasConfig
Replace Kotlin property assignment with setter callio.moderne.java.spring.kotlin.ReplaceKotlinPropertyAssignmentWithSetterCall
Replace Kotlin property assignment with setter callio.moderne.java.spring.kotlin.ReplaceKotlinPropertyAssignmentWithSetterCall
Replace Kotlin property assignment with setter callio.moderne.java.spring.kotlin.ReplaceKotlinPropertyAssignmentWithSetterCall
Replace Kotlin property assignment with setter callio.moderne.java.spring.kotlin.ReplaceKotlinPropertyAssignmentWithSetterCall
Replace Kotlin property assignment with setter callio.moderne.java.spring.kotlin.ReplaceKotlinPropertyAssignmentWithSetterCall
Replace Kotlin property assignment with setter callio.moderne.java.spring.kotlin.ReplaceKotlinPropertyAssignmentWithSetterCall
Replace Kotlin property assignment with setter callio.moderne.java.spring.kotlin.ReplaceKotlinPropertyAssignmentWithSetterCall
Replace Kotlin property assignment with setter callio.moderne.java.spring.kotlin.ReplaceKotlinPropertyAssignmentWithSetterCall
Replace Kotlin property assignment with setter callio.moderne.java.spring.kotlin.ReplaceKotlinPropertyAssignmentWithSetterCall
Change typeorg.openrewrite.java.ChangeType
Find and replaceorg.openrewrite.text.FindAndReplace
Change typeorg.openrewrite.java.ChangeType
Change typeorg.openrewrite.java.ChangeType
Flag deprecated ReactorNettyHttpClientMapper for migrationio.moderne.java.spring.boot4.FlagDeprecatedReactorNettyHttpClientMapper
Change typeorg.openrewrite.java.ChangeType
Change typeorg.openrewrite.java.ChangeType
Change typeorg.openrewrite.java.ChangeType
Change typeorg.openrewrite.java.ChangeType
Change typeorg.openrewrite.java.ChangeType
Change typeorg.openrewrite.java.ChangeType
Change typeorg.openrewrite.java.ChangeType
Change typeorg.openrewrite.java.ChangeType
Change typeorg.openrewrite.java.ChangeType
Rename Maven property keyorg.openrewrite.maven.RenamePropertyKey
Change a Gradle plugin version by idorg.openrewrite.gradle.plugins.ChangePluginVersion
Rename package nameorg.openrewrite.java.ChangePackage
Rename package nameorg.openrewrite.java.ChangePackage
Change typeorg.openrewrite.java.ChangeType
Change typeorg.openrewrite.java.ChangeType
Add spring-boot-starter-validation dependencyio.moderne.java.spring.boot4.AddValidationStarterDependency
Add Jackson2 for Jersey using JSONio.moderne.java.spring.boot4.AddJackson2ForJerseyJson
Adopt Jackson 3io.moderne.java.spring.boot4.AdoptJackson3
Migrate JsonFactoryDecorator to TokenStreamFactoryBuilderDecoratorio.moderne.java.spring.boot4.MigrateJsonFactoryDecorator
Remove ContentNegotiationConfigurer.favorPathExtension() callsio.moderne.java.spring.boot4.RemoveContentNegotiationFavorPathExtension
Migrate Spring Session Hazelcast to Hazelcast Spring Sessionio.moderne.java.spring.boot4.MigrateHazelcastSpringSession
Remove Spring Pulsar Reactive supportio.moderne.java.spring.boot4.RemoveSpringPulsarReactive
Remove ZipkinAutoConfigurationio.moderne.java.spring.boot4.RemoveZipkinAutoConfigurationExclude
Remove SslBundles parameter from KafkaProperties build methodsio.moderne.java.spring.boot4.RemoveKafkaPropertiesSslBundlesParameter
Migrate to Spring Boot 4.0 modular startersio.moderne.java.spring.boot4.MigrateToModularStarters
Remove redundant explicit dependencies and versionsorg.openrewrite.gradle.RemoveRedundantDependencyVersions
Remove redundant explicit dependency and plugin versionsorg.openrewrite.maven.RemoveRedundantDependencyVersions
Remove loaderImplementation from Gradleio.moderne.java.spring.boot4.RemoveGradleUberJarLoaderImplementationConfig
Remove XML tagorg.openrewrite.xml.RemoveXmlTag

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