<a href="/_slides/java/hibernate/relations.html#/" class="doc-only slide" target="_blank">🎬 Passer en mode présentation</a>
# Hibernate — Relations, Mapping et Fetch

---

## 1. Les relations entre deux tables

Règle de la spécification JPA (respectée par Hibernate) :

- Les associations **vers une seule entité** (to-one) sont **EAGER** par défaut
- Les **collections** (to-many) sont **LAZY** par défaut

Il faut éviter autant que possible les relations bidirectionnelles

### Tableau des relations (annotations JPA / balises HBM)

---

## 2. @OneToOne inverse

C'est la limitation structurelle la plus importante. 
Avec `constrained="false"` (ou `mappedBy` côté JPA), Hibernate **ne sait pas a priori si la ligne associée existe** en base. 
Pour créer un proxy, Hibernate est obligé d'émettre une requête immédiate pour le vérifier.

Hibernate :
> *"Note that if `constrained="false"`, proxying is impossible and Hibernate will eagerly fetch the association."*

La seule solution pour forcer le LAZY sur ce cas est d'activer le **Bytecode Enhancement** :

```xml
<enableLazyInitialization>true</enableLazyInitialization>
```

### un proxy hibernate 
Un proxy hibernate est un objet qui encapsule l'objet réel et qui permet de retarder le chargement de l'objet.

L'objet proxy est l'objet lui-même mais il ne contient que son identifiant.

Sans identifiant, il ne peut donc créer un proxy

Il a donc besoin de savoir si l'objet existe en base de données avant de pouvoir le charger.

---

## 3. Valeurs de l'attribut lazy en HBM

Pour `<many-to-one>` et `<one-to-one constrained="true">` :

Pour les collections (`<set>`, `<list>`, …) :

---

## 4. Bonnes pratiques sur le Fetch

Recommandation officielle Hibernate :

> *"Marquer **toutes les associations en LAZY statiquement**, puis définir les stratégies de chargement **dynamiquement** selon les besoins via JPQL `JOIN FETCH` ou `@EntityGraph`.*

Eviter EAGER par défaut

Exemple :

```java
// ❌ À éviter : EAGER statique
@ManyToOne(fetch = FetchType.EAGER)
private Customer customer;

// ✅ Recommandé : LAZY statique 
@ManyToOne(fetch = FetchType.LAZY)
private Customer customer;

// JOIN FETCH dynamique
"SELECT o FROM Order o JOIN FETCH o.customer WHERE o.id = :id"
```

---

## 5. Références

| Ressource | URL |
| :-- | :-- |
| Hibernate 5.3 User Guide — Associations | `https://docs.hibernate.org/orm/5.3/userguide/html_single/#associations` |
| Hibernate 5.3 User Guide — Fetching | `https://docs.hibernate.org/orm/5.3/userguide/html_single/#fetching` |
| Hibernate 3.3 Reference — Basic O/R Mapping (HBM) | `https://docs.hibernate.org/orm/3.3/reference/en/html/mapping.html` |
| Hibernate 3.3 Reference — Collections (lazy HBM) | `https://docs.hibernate.org/orm/3.3/reference/en/html/collections.html` |
| FetchType Lazy/Eager — Thorben Janssen | `https://thorben-janssen.com/entity-mappings-introduction-jpa-fetchtypes/` |
| Mapping Definitions JPA/Hibernate (Annotations vs XML) — Thorben Janssen | `https://thorben-janssen.com/mapping-definitions-jpa-hibernate-annotations-xml/` |
| A beginner's guide to Hibernate fetching strategies — Vlad Mihalcea | `https://vladmihalcea.com/hibernate-facts-the-importance-of-fetch-strategy/` |

---
# <a href="javascript:window.close();" class="slide-only">Terminé </a>