Open source

Migrate from Micronaut 3.x to 4.x

Recipe IDorg.openrewrite.java.micronaut.Micronaut3to4MigrationArtifactorg.openrewrite.recipe:rewrite-micronaut

This recipe will apply changes required for migrating from Micronaut 3 to Micronaut 4.

Composite recipeApache 2.0

Add to your build

Get a download tokenSign in with GitHub or Google, and your token replaces YOUR_DOWNLOAD_TOKEN below. Free for open source recipes like this one.

~/.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.micronaut.Micronaut3to4Migration")
}

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-micronaut:2.38.1")
}

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.micronaut.Micronaut3to4Migration

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

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

Definition

This recipe runs the following recipes in order.

Upgrade Java version 17org.openrewrite.java.migrate.UpgradeJavaVersion
Update Gradle wrapper 8.1.x-binorg.openrewrite.gradle.UpdateGradleWrapper
Update the Micronaut version to 4.xorg.openrewrite.java.micronaut.UpdateBuildToMicronaut4Version
Update to Micronaut 4.x platform BOMorg.openrewrite.java.micronaut.UpdateMicronautPlatformBom
Add Micronaut build plugins to 4.xorg.openrewrite.java.micronaut.UpdateBuildPlugins
Add snakeyaml dependency if neededorg.openrewrite.java.micronaut.AddSnakeYamlDependencyIfNeeded
Update jakarta annotations dependencyorg.openrewrite.java.micronaut.UpdateJakartaAnnotations
Migrate deprecated javax.persistence packages to jakarta.persistenceorg.openrewrite.java.migrate.jakarta.JavaxPersistenceToJakartaPersistence
Update to Micronaut Validation 4.xorg.openrewrite.java.micronaut.UpdateMicronautValidation
Update to Micronaut Email 2.xorg.openrewrite.java.micronaut.UpdateMicronautEmail
Update the Micronaut Websocket supportorg.openrewrite.java.micronaut.AddMicronautWebsocketDependencyIfNeeded
Update the Micronaut Session supportorg.openrewrite.java.micronaut.UpdateMicronautSession
Update the Micronaut Retry supportorg.openrewrite.java.micronaut.AddMicronautRetryDependencyIfNeeded
Update the Micronaut Security libraryorg.openrewrite.java.micronaut.UpdateMicronautSecurity
Update the Micronaut Data libraryorg.openrewrite.java.micronaut.UpdateMicronautData
Remove withJansi Logback configurationorg.openrewrite.java.micronaut.RemoveWithJansiLogbackConfiguration
Remove a Gradle or Maven dependencyorg.openrewrite.java.dependencies.RemoveDependency
Add HttpRequest type parameter for implemented interfacesorg.openrewrite.java.micronaut.AddHttpRequestTypeParameter
Update the version of core annotation processorsorg.openrewrite.java.micronaut.UpdateMavenAnnotationProcessors
Add micronaut-test-resources-client if neededorg.openrewrite.java.micronaut.AddTestResourcesClientDependencyIfNeeded

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