GeezerVison

Sourced from io.projectreactor:reactor-core's releases.

v3.8.0

Reactor Core 3.8.0 is part of 2025.0.0 Release Train.

3.8.0 Highlights

Enhanced Null Safety using JSpecify

🦺 Reactor Core 3.8.0 introduces JSpecify annotations for comprehensive null safety, replacing the legacy JSR 305-based annotations with a modern, properly specified standard that prevents NullPointerExceptions through build-time checks. This upgrade provides enhanced IDE support, seamless Kotlin integration with automatic translation to Kotlin's null safety system, and more precise nullability declarations including support for arrays, varargs, and generic types — making Reactor APIs safer and more developer-friendly across the entire ecosystem.

⚠️ Nullability annotations from reactor.util.annotation have been deprecated in favour of JSpecify annotations.

📖 Check the refreshed reference documentation section on Null Safety.

⚠️ Note for Kotlin users: While this change is backwards compatible in the Java ecosystem and does not dictate a new generation of Reactor Core, we do appreciate it can appear as breaking changes for Kotlin codebases. The benefits are well defined nullness of the Reactor API and reduction of the ceremony that was required prior to the introduction of JSpecify annotations.

Repeat Spec

Repeat functionality from Reactor Addons has been ported to Reactor Core under the RepeatSpec class and can be used in conjunction with the Flux#repeatWhen() and Mono#repeatWhen() operators. Make sure to check out the Javadoc.

Reactor Core Micrometer version aligned with Reactor Core version

The reactor-core-micrometer library, which is part of the reactor-core repository is always released together with reactor-core, hence we decided to align their versions starting from 3.8.0 (the previous line was 1.2.x corresponding with 3.7.x of reactor-core).

What's Changed

⚠️ Update considerations and deprecations

• Introduce JSpecify for nullability annotations by @​chemicL in reactor/reactor-core#4091

✨ New features and improvements

• Bump byteBuddy from 1.17.7 to 1.17.8 by @​dependabot[bot] in reactor/reactor-core#4113
• Bump io.projectreactor.tools:blockhound from 1.0.14.RELEASE to 1.0.15.RELEASE by @​dependabot[bot] in reactor/reactor-core#4120
• Bump Micrometer to 1.16.0 by @​chemicL in fedfdd2549fe1190ec5e1b14a13ddf24a1f1b75f
• Bump Context Propagation to 1.2.0 by @​chemicL in fedfdd2549fe1190ec5e1b14a13ddf24a1f1b75f
• Repeat specification for use with repeatWhen operator by @​kwondh5217 in reactor/reactor-core#4027 and refinement by @​chemicL in b313f5781b919a30bd8b7316438610fbe02b38b7
• Add Hooks#isAutomaticContextPropagationEnabled by @​sdeleuze in reactor/reactor-core#4090
• Adjust reactor.util.Logger vararg nullability by @​chemicL in reactor/reactor-core#4098
• Adjust Mono methods: fromCallable and fromSupplier nullability by @​chemicL in reactor/reactor-core#4116
• Address NullAway warnings and refine StepVerifier nullability by @​chemicL in reactor/reactor-core#4126
• Nullaway jspecify mode fixes by @​chemicL in reactor/reactor-core#4127
• Refine StepVerifier nullability reflecting non-null Publisher values by @​chemicL in reactor/reactor-core#4132
• Unify reactor-core-micrometer version with reactor-core by @​chemicL in reactor/reactor-core#4136

🐞 Bug fixes

• Fix RetryBackoffSpec multiplier handling of fractional values by @​chemicL in reactor/reactor-core#4048
• Adjust Flux#map mapper to disallow null return values by @​chemicL in reactor/reactor-core#4103

📖 Documentation

• [docs] Add Null Safety documentation by @​chemicL in reactor/reactor-core#4137
• Add more description on tap operator by @​ttddyy in reactor/reactor-core#4009
• fix doc title displayed as untitled by @​dev-jonghoonpark in reactor/reactor-core#4008

New Contributors

... (truncated)

• fedfdd2 [release] Prepare and release 3.8.0
• fe9d705 [docs] Add Null Safety documentation (#4137)
• 56c2a33 Merge-ignore release 3.7.13 into 3.8.0
• 4ab91b1 [release] Next development version 3.7.14-SNAPSHOT
• dbbb82f [release] Prepare and release 3.7.13
• f96f1d4 Unify reactor-core-micrometer version with reactor-core (#4136)
• 68c5e2c Merge #4129 into 3.8.0
• f4a8e99 Bump ruby/setup-ruby from 1.263.0 to 1.267.0 in /.github/workflows (#4129)
• c7c3b4e Merge #4120 into 3.8.0
• 135bcb1 Bump io.projectreactor.tools:blockhound from 1.0.14.RELEASE to 1.0.15.RELEASE...
• Additional commits viewable in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)