2 - JPA Avancé et Optimisation

Séance 2 (4h)

Contexte : fil rouge e-commerce

• Maîtriser les associations bidirectionnelles et leurs pièges
• Comprendre et résoudre les problèmes N+1
• Utiliser l'héritage JPA à bon escient
• Optimiser les requêtes avec fetch strategies et projections

Points d'attention :

• Choix du côté propriétaire (mappedBy)
• Cascade types appropriés
• Orphan removal
• Lazy vs Eager loading

// Contraintes métier à implémenter
- Un Order doit toujours avoir au moins 1 OrderItem
- Suppression d'un Order → suppression des OrderItems
- totalAmount calculé automatiquement
- Gestion du stock produit lors de la création

Tests attendus :

• Création d'une commande avec items
• Calcul automatique du total
• Mise à jour du stock
• Suppression en cascade

Pour recréer à moindre coût une relation (sans charger complètement l'instance depuis le repository)

val user = entityManager.getReference(User::class.java, userId);

À implémenter et comparer :

Exercices :

1. Optimiser /users/{id}/orders avec JOIN FETCH
2. Créer une projection pour /products (liste)
3. Comparer les performances avant/après

À explorer (au choix ou comparaison) :

// Option 1 : SINGLE_TABLE (par défaut)
@Inheritance(strategy = InheritanceType.SINGLE_TABLE)
@DiscriminatorColumn(name = "product_type")

// Option 2 : JOINED
@Inheritance(strategy = InheritanceType.JOINED)

// Option 3 : TABLE_PER_CLASS
@Inheritance(strategy = InheritanceType.TABLE_PER_CLASS)

Exercice comparatif :

• Schéma base de données généré
• Requêtes SQL produites
• Avantages/inconvénients de chaque stratégie

// Repository
List<Product> findAll(); // Tous types confondus
List<PhysicalProduct> findPhysicalProducts();

// Nouveaux endpoints
GET /products?type=PHYSICAL
GET /products?type=DIGITAL

<dependency>
    <groupId>io.hypersistence</groupId>
    <artifactId>hypersistence-utils-hibernate-63</artifactId>
    <version>3.7.0</version>
</dependency>

# application.properties - Ajout pour Hypersistence

# Détection des problèmes N+1
logging.level.io.hypersistence.utils=DEBUG

# Limites d'alerte (optionnel)
hypersistence.query.fail.on.pagination.over.collection.fetch=false

// Configuration globale (classe @Configuration)
@Configuration
public class HypersistenceConfiguration {
    
    @Bean
    public QueryStackTraceLogger queryStackTraceLogger() {
        return new QueryStackTraceLogger();
    }
    
    @EventListener
    public void onApplicationEvent(ApplicationReadyEvent event) {
        // Active la détection des problèmes N+1
        QueryStackTraceLogger.INSTANCE.setThreshold(10); // Alerte si > 10 requêtes
    }
}

Exercice :

• Activer le logger sur l'endpoint /users/{id}/orders
• Observer les alertes automatiques
• Corriger les problèmes détectés

@Entity
@Table(name = "products")
public class Product {
    // ... attributs existants
    
    @Type(JsonType.class)
    @Column(columnDefinition = "json")
    private Map<String, Object> attributes;
    
    // Pour PhysicalProduct : {"weight": 2.5, "dimensions": "30x20x10"}
    // Pour DigitalProduct : {"fileSize": "1.2GB", "format": "PDF"}
}

{
  "id": "550e8400-e29b-41d4-a716-446655440020",
  "name": "iPhone 15 Pro",
  "price": 1199.99,
  "stock": 25,
  "categoryId": "550e8400-e29b-41d4-a716-446655440010",
  "attributes": {
    "color": "Titanium Blue",
    "storage": "256GB",
    "warranty": "2 years"
  }
}

Exercice :

• Ajouter le champ attributes à Product
• Créer un endpoint GET /products/{id}/attributes
• Filtrer les produits par attribut : GET /products?attr.color=Blue

// Avant (UUID)
@Id
@GeneratedValue(strategy = GenerationType.UUID)
private UUID id;

// Après (Tsid) - Pour nouvelles entités
@Id
@TsidGenerator
private Long id;

Exercice optionnel :

• Créer une nouvelle entité Review avec Tsid
• Comparer les performances d'insertion (benchmark)

@Configuration
public class DataSourceProxyConfiguration {
    
    @Bean
    public DataSourceProxyBeanPostProcessor dataSourceProxyBeanPostProcessor() {
        return new DataSourceProxyBeanPostProcessor() {
            @Override
            protected DataSourceProxy createDataSourceProxy(DataSource dataSource) {
                return new DataSourceProxy(dataSource, new QueryCountHolder());
            }
        };
    }
}

Exercice :

• Mettre en place le monitoring
• Créer un test d'intégration qui vérifie le nombre exact de requêtes
• Exemple : assertQueryCount(3) après un appel API

# application.properties - Configuration complète Séance 2

# H2 Database
spring.datasource.url=jdbc:h2:file:./data/ecommerce
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=

# H2 Console
spring.h2.console.enabled=true
spring.h2.console.path=/h2-console

# JPA/Hibernate
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true
spring.jpa.properties.hibernate.use_sql_comments=true
spring.jpa.properties.hibernate.generate_statistics=true

# Logging SQL et statistiques
logging.level.org.hibernate.SQL=DEBUG
logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE
logging.level.org.hibernate.stat=DEBUG
logging.level.org.hibernate.orm.jdbc.bind=TRACE

# Hypersistence Utils
logging.level.io.hypersistence.utils=DEBUG

• Hibernate Performance Best Practices
• Hypersistence Utils GitHub
• Documentation officielle Hypersistence
• Spring Data JPA Query Methods