Accueil › Spring Boot › Les relations entre entités
Les relations entre entités
Accéder aux données avec Spring Data JPAdebutant
Les entités se relient entre elles avec des annotations qui reflètent la cardinalité :
@Entity
public class Commande {
@Id @GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
@OneToMany(mappedBy = "commande", cascade = CascadeType.ALL, orphanRemoval = true)
private List<LigneCommande> lignes = new ArrayList<>();
public void ajouterLigne(LigneCommande ligne) {
lignes.add(ligne);
ligne.setCommande(this); // synchronise les deux côtés
}
}
@Entity
public class LigneCommande {
@Id @GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
@ManyToOne
@JoinColumn(name = "commande_id") // côté propriétaire : porte la clé étrangère
private Commande commande;
@ManyToOne
private Produit produit;
}
Points essentiels :
- Le côté propriétaire (celui qui porte
@JoinColumn, généralement le@ManyToOne) est celui dont les modifications sont réellement écrites en base. L'autre côté (mappedBy) doit être synchronisé manuellement, d'où l'intérêt d'une méthode utilitaire commeajouterLigne(...). - Fetch par défaut : EAGER pour
@ManyToOne/@OneToOne, LAZY pour@OneToMany/@ManyToMany. cascadepropage les opérations,orphanRemovalsupprime les enfants retirés de la collection.- Ne jamais renvoyer une entité directement en JSON dans une API : utiliser des DTO, pour éviter les boucles infinies de sérialisation et exposer trop de données.
Les termes à connaître
- @ManyToOne
Relation où plusieurs instances de l'entité portant l'annotation pointent vers une instance de l'entité cible. Exemple : plusieurs
LigneCommandepointent vers unProduit. C'est très souvent le côté propriétaire de la relation, avec@JoinColumnpour nommer la colonne de clé étrangère.- @OneToMany(mappedBy = ...)
Relation où une instance pointe vers plusieurs instances de l'autre entité.
mappedByindique que ce côté n'est pas propriétaire : la clé étrangère est gérée par l'autre côté (celui avec@ManyToOne).- @OneToOne
Relation où une instance pointe vers exactement une autre instance, et réciproquement. Le côté propriétaire porte
@JoinColumn; l'autre côté utilisemappedBy.- @ManyToMany
Relation où plusieurs instances de chaque côté peuvent se correspondre. Implémentée via une table d'association intermédiaire, déclarée avec
@JoinTabledu côté propriétaire.- @JoinColumn
Précise le nom de la colonne de clé étrangère, côté propriétaire d'une relation (
@ManyToOne,@OneToOnepropriétaire).- Côté propriétaire
Dans une relation bidirectionnelle, le côté qui possède la colonne de clé étrangère (ou la table d'association) et dont les modifications sont effectivement écrites en base. L'autre côté (
mappedBy) n'est qu'une vue en lecture de la relation, tant qu'on ne synchronise pas les deux côtés manuellement.- cascade et orphanRemoval
cascadepropage une opération (persist, remove…) de l'entité parente vers les entités liées.orphanRemoval = truesupprime automatiquement une entité enfant retirée de la collection parente, même sans suppression explicite.- LazyInitializationException
Exception levée quand on accède à une relation chargée en mode paresseux (
LAZY) après la fermeture de la session Hibernate (par exemple dans une vue, après le retour du service). Message typique : « failed to lazily initialize a collection of role... could not initialize proxy - no Session ».
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.