Formations — 1 037 leçons en français

Accueil › Spring Boot › Projections et DTO

Projections et DTO

JPA avancéintermediaire

Une projection renvoie directement une forme réduite ou recomposée des données, sans passer par l'entité complète. Deux approches principales.

Par interface — une interface dont les méthodes reprennent les noms des propriétés :

public interface ProduitResume {
    String getNom();
    double getPrix();
}

public interface ProduitRepository extends JpaRepository<Produit, Long> {
    List<ProduitResume> findByCategorie(String categorie);
}

Par classe ou record — Spring Data instancie directement le DTO avec les valeurs de la requête :

public record ProduitDto(String nom, double prix) { }

@Query("SELECT new com.exemple.boutique.ProduitDto(p.nom, p.prix) FROM Produit p WHERE p.categorie = :categorie")
List<ProduitDto> trouverDto(@Param("categorie") String categorie);

Pourquoi s'en donner la peine plutôt que de renvoyer l'entité Produit directement dans l'API ? Parce qu'une entité JPA porte des relations LAZY (risque de LazyInitializationException à la sérialisation), peut boucler à l'infini sur une relation bidirectionnelle, expose parfois des champs internes qui ne devraient jamais quitter le service, et lie le contrat de l'API au schéma de base — un changement de colonne casserait alors l'API. Un DTO découple les deux : c'est un contrat propre à l'API, écrit et fait évoluer indépendamment du modèle de persistance. Pour des mappings plus complexes ou répétés à plusieurs endroits, MapStruct génère ce mapping automatiquement à la compilation.

Les termes à connaître

Projection

Une vue partielle d'une entité (un sous-ensemble de ses champs, parfois recomposés), renvoyée directement par le repository au lieu de l'entité complète. Spring Data JPA sait générer une projection sans code de mapping manuel, par interface ou par classe.

Projection par interface

Une interface avec des méthodes getXxx() qui reprennent les noms des propriétés de l'entité. Spring Data génère un proxy à l'exécution qui les implémente. Fermée (chaque méthode correspond exactement à une propriété) : Spring Data peut alors restreindre les colonnes sélectionnées en SQL.

Projection ouverte

Variante de la projection par interface où une méthode utilise @Value("#{target.nom + ' ' + target.prenom}") pour combiner ou transformer des champs. L'objet entier doit alors être chargé : Spring Data ne peut plus restreindre les colonnes SQL comme pour une projection fermée.

Projection par classe (DTO)

Une classe ou un record dont le constructeur reprend, dans l'ordre, les noms des propriétés voulues. Spring Data l'instancie directement avec les valeurs issues de la requête, sans passer par un proxy.

Projection dynamique

Une méthode de repository générique (<T> List<T> findByCategorie(String categorie, Class<T> type)) où l'appelant choisit le type de projection au moment de l'appel, en passant sa classe cible.

Expression constructeur JPQL (new ...)

Dans une requête @Query, SELECT new com.exemple.ProduitDto(p.nom, p.prix) FROM Produit p construit directement des DTO depuis la requête, avec le nom qualifié complet de la classe. L'ordre et les types des expressions doivent correspondre exactement à un constructeur existant.

Pourquoi éviter d'exposer les entités JPA

Exposer une entité directement dans une API expose son cycle de chargement (relations LAZY, LazyInitializationException), risque des boucles de sérialisation sur des relations bidirectionnelles, peut fuiter des champs internes (mot de passe haché, champs d'audit) et couple étroitement le contrat de l'API au schéma de base de données.

MapStruct

Bibliothèque qui génère, à la compilation, le code de mapping entre entités et DTO à partir d'une interface annotée @Mapper. Évite d'écrire ce mapping à la main, sans le coût d'exécution de la réflexion (contrairement à certaines bibliothèques de mapping dynamique).

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.