Formations — 1 037 leçons en français

Accueil › Spring Boot › Spring WebFlux : contrôleurs réactifs

Spring WebFlux : contrôleurs réactifs

Programmation réactiveavance

Spring WebFlux est l'équivalent réactif de Spring MVC. Il s'active avec spring-boot-starter-webflux, qui embarque Netty comme serveur par défaut (au lieu de Tomcat). Les contrôleurs s'écrivent avec les mêmes annotations que Spring MVC, mais renvoient Mono/Flux :

@RestController
@RequestMapping("/commandes")
public class CommandeController {

    private final CommandeRepository repository;

    public CommandeController(CommandeRepository repository) {
        this.repository = repository;
    }

    @GetMapping("/{id}")
    public Mono<Commande> parId(@PathVariable Long id) {
        return repository.findById(id);
    }

    @GetMapping
    public Flux<Commande> toutes() {
        return repository.findAll();
    }
}

WebFlux s'abonne lui-même au Mono/Flux renvoyé : le développeur n'appelle jamais subscribe() ni block() dans un contrôleur. Il existe aussi un style fonctionnel, avec des RouterFunction, comme alternative aux annotations.

Pour appeler une API externe de façon réactive, WebClient remplace RestTemplate (en mode maintenance depuis Spring 5) :

Mono<Produit> produit = webClient.get()
        .uri("/produits/{id}", id)
        .retrieve()
        .bodyToMono(Produit.class);

Règle d'or : ne jamais bloquer le thread de l'event loop Netty — un appel JDBC classique, un Thread.sleep() ou un block() dedans dégrade toute l'application sous charge.

Les termes à connaître

spring-boot-starter-webflux

Starter qui embarque Spring WebFlux et, par défaut, Netty comme serveur embarqué (au lieu de Tomcat pour spring-boot-starter-web). Netty est asynchrone et non bloquant par nature, ce qui en fait le complément naturel de WebFlux.

Contrôleur annoté réactif

Un @RestController classique dont les méthodes renvoient Mono<T> ou Flux<T> au lieu de T ou List<T>. Spring WebFlux s'abonne lui-même au résultat : le développeur ne fait jamais block() ni subscribe() dans le contrôleur.

RouterFunction / HandlerFunction

Style fonctionnel de routage, alternative aux annotations : un RouterFunction associe des routes (méthode HTTP, chemin) à des HandlerFunction, des méthodes qui reçoivent une ServerRequest et renvoient un Mono<ServerResponse>.

WebClient

Client HTTP réactif et non bloquant de Spring, successeur de RestTemplate (désormais en mode maintenance). Chaque appel renvoie un Mono<T> ou Flux<T> qui ne déclenche la requête qu'à l'abonnement.

Server-Sent Events (SSE)

Protocole HTTP simple pour un flux d'événements du serveur vers le client, dans un sens (contrairement aux WebSockets). Un contrôleur WebFlux qui renvoie un Flux<T> avec MediaType.TEXT_EVENT_STREAM_VALUE produit un flux SSE nativement.

Event loop

Petit nombre de threads (généralement autant que de cœurs CPU) qui traitent toutes les requêtes de Netty en les enchaînant sans jamais attendre bloquant sur elles. Un appel bloquant exécuté sur ce thread gèle toutes les requêtes qu'il gère en parallèle.

Netty vs Tomcat

Tomcat (utilisé par Spring MVC) alloue un thread par requête et bloque dessus pendant les I/O. Netty (utilisé par WebFlux) traite les requêtes sur un petit pool de threads non bloquants, orchestré autour d'une boucle d'événements.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.