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
recorddont 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 pconstruit 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).
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.