Formations — 1 037 leçons en français

Accueil › Spring Boot › Accès aux données réactif avec R2DBC

Accès aux données réactif avec R2DBC

Programmation réactiveavance

R2DBC (Reactive Relational Database Connectivity) est une spécification d'accès aux bases relationnelles pensée pour Reactive Streams : aucune méthode ne bloque le thread appelant. C'est la contrepartie réactive de JDBC — et donc de JPA, qui repose sur JDBC et ne peut pas devenir réactif par un simple changement de configuration.

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-r2dbc</artifactId>
</dependency>
<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>r2dbc-postgresql</artifactId>
</dependency>

Les repositories ressemblent beaucoup à Spring Data JPA, avec des types réactifs :

public interface ClientRepository extends ReactiveCrudRepository<Client, Long> {
    Flux<Client> findByVille(String ville);   // requête dérivée, comme en JPA

    @Query("SELECT * FROM client WHERE actif = true")
    Flux<Client> trouverActifs();
}

Différence majeure avec JPA : pas de chargement paresseux ni de relations automatiques. Chaque relation (Client → ses Commande) se charge par une requête séparée, composée explicitement avec flatMap :

Mono<ClientAvecCommandes> fiche = clientRepository.findById(id)
        .flatMap(client -> commandeRepository.findByClientId(client.getId())
                .collectList()
                .map(commandes -> new ClientAvecCommandes(client, commandes)));

Les termes à connaître

R2DBC

Reactive Relational Database Connectivity : spécification d'accès aux bases de données relationnelles non bloquante, basée sur Reactive Streams. Contrairement à JDBC, aucune méthode ne bloque le thread appelant en attendant la base.

spring-boot-starter-data-r2dbc

Starter qui apporte Spring Data R2DBC. Nécessite en plus un driver R2DBC spécifique à la base utilisée (r2dbc-postgresql, r2dbc-h2, r2dbc-mysql…), l'équivalent réactif d'un driver JDBC.

ReactiveCrudRepository

Interface Spring Data équivalente à CrudRepository, mais dont toutes les méthodes renvoient Mono ou Flux (Mono<T> findById(ID id), Flux<T> findAll(), Mono<T> save(T entity)…). Les requêtes dérivées par nom de méthode fonctionnent comme en JPA.

DatabaseClient

Client bas niveau de Spring Data R2DBC pour exécuter du SQL directement, avec liaison de paramètres et mapping du résultat — l'équivalent réactif de JdbcTemplate. Utile quand @Query ou les méthodes dérivées ne suffisent pas.

TransactionalOperator

Façon d'exécuter une séquence réactive dans une transaction sans bloquer : transactionalOperator.transactional(monoOuFlux). Alternative programmatique à @Transactional, utilisable notamment quand la transaction doit englober plusieurs appels indépendants.

Absence de chargement paresseux (no lazy loading)

R2DBC ne connaît pas les relations entre entités comme JPA (pas de @OneToMany, pas de proxy, pas de session de persistance). Chaque relation doit être chargée explicitement, par une requête séparée composée avec flatMap.

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.