← All recipes
Moderne licensed

Replace @Nullable with @MonotonicNonNull on a lazily-initialized field

Recipe IDio.moderne.nullability.ReplaceNullableWithMonotonicNonNullOnLazyField
Artifactio.moderne.recipe:rewrite-nullability

Replaces the JSpecify @Nullable on a private, non-final reference field with the Checker Framework @org.checkerframework.checker.nullness.qual.MonotonicNonNull annotation when it is a lazily-initialized-non-null field, so NullAway treats reads of it as non-null and drops the requireNonNull noise a plain @Nullable forces at every read. A field qualifies only if it is private and non-final, declares exactly one reference-typed variable, every assignment has a provably-non-null right-hand side, at least one assignment is outside a constructor, and every null-observation of the field is a lazy-init guard (the condition of an if whose then-branch assigns the field). Because private bounds the analysis to the declaring class and no use handles null gracefully, the upgrade is behavior-preserving. Only Java sources are modified.

Single recipeProprietary

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.nullability.ReplaceNullableWithMonotonicNonNullOnLazyField

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

mod config recipes jar install io.moderne.recipe:rewrite-nullability:0.3.1

Data tables

Structured output this recipe can produce.

  • 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