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
@RestControllerclassique dont les méthodes renvoientMono<T>ouFlux<T>au lieu deTouList<T>. Spring WebFlux s'abonne lui-même au résultat : le développeur ne fait jamaisblock()nisubscribe()dans le contrôleur.- RouterFunction / HandlerFunction
Style fonctionnel de routage, alternative aux annotations : un
RouterFunctionassocie des routes (méthode HTTP, chemin) à desHandlerFunction, des méthodes qui reçoivent uneServerRequestet renvoient unMono<ServerResponse>.- WebClient
Client HTTP réactif et non bloquant de Spring, successeur de
RestTemplate(désormais en mode maintenance). Chaque appel renvoie unMono<T>ouFlux<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>avecMediaType.TEXT_EVENT_STREAM_VALUEproduit 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.
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.