JarCastingReactor Project
Starting from 3.0, Reactor is now organized into multiple projects:
A set of compatible versions for all these projects is curated under a BOM ("Bill of Materials").
Using the BOM with Maven
In Maven, you need to import the bom first:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>io.projectreactor</groupId>
<artifactId>reactor-bom</artifactId>
<version>2020.0.2</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
Notice we use the <dependencyManagement> section and the import scope.
Next, add your dependencies to the relevant reactor projects as usual, except without a <version>:
<dependencies>
<dependency>
<groupId>io.projectreactor</groupId>
<artifactId>reactor-core</artifactId>
</dependency>
<dependency>
<groupId>io.projectreactor</groupId>
<artifactId>reactor-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
Using the BOM with Gradle
Gradle 5.0+
Use the platform keyword to import the Maven BOM within the dependencies block, then add dependencies to your project without a version number.
dependencies {
// import BOM
implementation platform('io.projectreactor:reactor-bom:2020.0.2')
// add dependencies without a version number
implementation 'io.projectreactor:reactor-core'
}
Gradle 4.x and earlier
Gradle versions prior to 5.0 have no core support for Maven BOMs, but you can use Spring's gradle-dependency-management plugin.
First, apply the plugin from Gradle Plugin Portal (check and change the version if a new one has been released):
plugins {
id "io.spring.dependency-management" version "1.0.6.RELEASE"
}
Then use it to import the BOM:
dependencyManagement {
imports {
mavenBom "io.projectreactor:reactor-bom:2020.0.2"
}
}
Then add a dependency to your project without a version number:
dependencies {
compile 'io.projectreactor:reactor-core'
}
BOM Versioning Scheme
The BOM can be imported in Maven, which will provide a set of default artifact versions to use whenever the corresponding dependency is added to a pom without an explicitly provided version.
As the different artifacts versions are not necessarily aligned, the BOM represents a release train with an heterogeneous range of versions that are curated to work together. The artifact version follows the YYYY.MINOR.MICRO-QUALIFIER scheme since Europium, where:
YYYYis the year of the first GA release in a given release cycle (like 3.4.0 for 3.4.x).MINORis a 0-based number incrementing with each new release cycle ** in the case of the BOM it allows discerning between release cycles in case two get first released the same year.PATCHis a 0-based number incrementing with each service release-QUALIFIERis a textual qualifier, which is omitted in the case of GA releases (see below)
On top of the artifact version, each release train has an associated codename, a chemical name from the Periodic Table of Elements in growing alphabetical order, for reference in discussions.
So far, the release trains code names are:
Aluminiumfor the3.0.xgeneration of Reactor-Core (💡 )Bismuthfor the3.1.xgeneration (💡 )Californiumfor the3.2.xgeneration (💡 )Dysprosiumfor the3.3.xgeneration (💡 )Europium(2020.0) for the3.4.xgeneration (💡 )
NOTE: Up until Dysprosium, the BOM was versioned using a release train scheme with a codename followed by a qualifier, and the qualifiers were slightly different. For example: Aluminium-RELEASE (first GA release, would now be something like YYYY.0.0), Bismuth-M1, Californium-SR1 (service release would now be something like YYYY.0.1), Dysprosium-RC1, Dysprosium-BUILD-SNAPSHOT (after each patch, we'd go back to the same snapshot version. would now be something like YYYY.0.X-SNAPSHOT so we get 1 snapshot per PATCH).
Enrolling
Join the initiative, fork, discuss and PR anytime. Roadmap is collaborative and we do enjoy new ideas, simplifications, doc, feedback, and, did we mention feedback already ;) ? As any other open source project, you are the hero, Reactor is only useful because of you and we can't wait to see your pull request mate !
Documentation
Community / Support
Detail of Projects
Reactor Core
Reactive foundations for apps and frameworks and reactive extensions inspired API with Mono (1 element) and Flux (n elements) types
- API documentation: /docs/core/release/api
Reactor Netty
TCP and HTTP client and server.
- API documentation: /docs/netty/release/api
Reactor Addons
Extra projects adding features to reactor:
reactor-adapter: adapt to/from various libraries, mainly RxJava 2.- API documentation: /docs/adapter/release/api
reactor-extra: Retry utils, Math utils, ...- API documentation: /docs/test/release/api
reactor-logback:logbackadapter for Flux/Monolog()feature.
Snapshot Artifacts
While Stable Releases are synchronized with Maven Central, fresh snapshot and milestone artifacts are provided in the repo.spring.io repositories.
To add this repo to your Maven build, add it to the <repositories> section like the following:
<repositories>
<repository>
<id>spring-snapshot</id>
<name>Spring Snapshot Repository</name>
<url>https://repo.spring.io/snapshot</url>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
To add it to your Gradle build, use the repositories configuration like this:
repositories {
maven { url 'https://repo.spring.io/libs-snapshot' }
mavenCentral()
}
You should then be able to import a -SNAPSHOT version of the BOM, like 2020.0.2-SNAPSHOT for the snapshot of the second service release of 2020.0 (Europium).
Reactive Streams Commons
In a continuous mission to design the most efficient concurrency operators for Reactive Streams, a common effort -codename Reactive Streams Commons- has begun. Reactor is fully aligned with RSC design and is directly inlining RSC within its stable API contract scoped under reactor-core. Reactive Streams Commons is a research effort shared with everyone and is demanding of efficient stream processing challengers, therefore it is naturally decoupled of any framework noise.
Sponsored by Pivotal
