Formations — 1 037 leçons en français

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 :

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 LigneCommande pointent vers un Produit. C'est très souvent le côté propriétaire de la relation, avec @JoinColumn pour nommer la colonne de clé étrangère.

@OneToMany(mappedBy = ...)

Relation où une instance pointe vers plusieurs instances de l'autre entité. mappedBy indique 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é utilise mappedBy.

@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 @JoinTable du côté propriétaire.

@JoinColumn

Précise le nom de la colonne de clé étrangère, côté propriétaire d'une relation (@ManyToOne, @OneToOne proprié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

cascade propage une opération (persist, remove…) de l'entité parente vers les entités liées. orphanRemoval = true supprime 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 ».

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.