Spring WebFlux pour Java : Guide complet de la programmation réactive

1. Qu'est-ce que Spring WebFlux et pourquoi l'utiliser ?

Spring WebFlux est un framework web réactif intégré à l'écosystème Spring Framework 5+, offrant une alternative au traditionnel Spring MVC. Contrairement à l'approche bloquante (blocking) où chaque requête HTTP est traitée par un thread dédié, WebFlux repose sur un modèle d'entrée-sortie asynchrone et non-bloquant (non-blocking). Cela permet de gérer des milliers de connexions simultanées avec un nombre minimal de threads, un atout crucial pour les systèmes à forte charge, les microservices et les applications temps réel.

Pourquoi utiliser Spring WebFlux ? Dans le monde actuel, où le nombre d'utilisateurs et d'appareils croît de manière exponentielle, les conteneurs servlets traditionnels (Tomcat, Jetty) rencontrent le problème "C10K" (gestion de 10 000 connexions simultanées). Chaque thread consomme de la mémoire (environ 1 Mo par pile), et avec 10 000 threads, cela représente 10 Go de RAM rien que pour les piles. WebFlux résout ce problème en utilisant le modèle des flux réactifs (Reactive Streams), où un seul thread peut traiter plusieurs requêtes en basculant entre elles dès que les données sont prêtes.

WebFlux prend en charge deux types de serveurs : Netty (recommandé, non-bloquant) et Servlet 3.1+ (Tomcat, Jetty, Undertow). Il s'intègre parfaitement avec le projet Reactor (Mono et Flux) et permet d'utiliser un style de routage fonctionnel (Router Functions) en complément des annotations @Controller. Cela en fait le choix idéal pour créer des API hautes performances, des serveurs d'événements (SSE), des applications WebSocket et des microservices avec des bases de données réactives (MongoDB Reactive, R2DBC).

2. Installation

Spring WebFlux ne s'installe pas via pip ou npm, car il s'agit d'une bibliothèque Java. Pour l'utiliser, ajoutez simplement la dépendance à votre projet. Voici les commandes exactes pour Maven et Gradle.

Maven (pom.xml)

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-webflux</artifactId>
    <version>3.2.0</version> <!-- Utilisez la version la plus récente -->
</dependency>

Gradle (build.gradle)

implementation 'org.springframework.boot:spring-boot-starter-webflux:3.2.0'

Si vous utilisez Spring Initializr (start.spring.io), sélectionnez simplement "Spring Reactive Web" dans la section des dépendances. Pour un accès non-bloquant aux bases de données, ajoutez également :

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-mongodb-reactive</artifactId>
</dependency>

3. Démarrage rapide — exemple minimal fonctionnel

Créez un contrôleur REST réactif simple qui renvoie un message de bienvenue. Cet exemple illustre la configuration de base de WebFlux avec les annotations.

// MainApplication.java
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class MainApplication {
    public static void main(String[] args) {
        SpringApplication.run(MainApplication.class, args);
    }
}

// GreetingController.java
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import reactor.core.publisher.Mono;

@RestController
public class GreetingController {

    @GetMapping("/hello")
    public Mono<String> sayHello() {
        return Mono.just("Bonjour depuis Spring WebFlux !");
    }
}

Lancez l'application et ouvrez http://localhost:8080/hello. Vous verrez le message "Bonjour depuis Spring WebFlux !". Notez que la méthode retourne un Mono<String>, et non une simple