JPQL, SQL, JPA — Flux d'exécution et concepts

flowchart LR
    A[Spring Data JPA\nRepository] --> B[JPQL / @Query]
    B --> C[Hibernate\nORM Engine]
    C --> D[SQL natif\ndialecte-spécifique]
    D --> E[(Base de données\nPostgreSQL / MySQL...)]

@Entity // ✓ annotation JPA standard
@Table(name = "orders")
public class Order {

    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE)
    private Long id;

    @ManyToOne(fetch = FetchType.LAZY) // ✓ contrat JPA
    @JoinColumn(name = "customer_id")
    private Customer customer; // ⚠️ Hibernate charge en proxy — pas encore une vraie Customer

    @OneToMany(mappedBy = "order", cascade = CascadeType.ALL)
    private List<OrderLine> lines = new ArrayList<>();
}

// ✓ Spring Data génère ce JPQL depuis le nom de méthode
List<Order> findByStatusAndCustomerId(String status, Long customerId);

// ✓ JPQL explicite avec @Query — toujours sur entités, jamais sur tables
@Query("SELECT o FROM Order o WHERE o.status = :status ORDER BY o.createdAt DESC")
List<Order> findRecentByStatus(@Param("status") String status);

// ✓ SQL natif — nécessaire pour les window functions (non supportées en JPQL)
@Query(value = """
    SELECT *,
           ROW_NUMBER() OVER (PARTITION BY customer_id ORDER BY created_at DESC) AS rn
    FROM orders
    WHERE status = :status
    """, nativeQuery = true)
List<Object[]> findOrdersWithRank(@Param("status") String status);

logging:
  level:
    org.hibernate.SQL: DEBUG                # ✓ affiche les requêtes SQL générées
    org.hibernate.orm.jdbc.bind: TRACE      # ✓ affiche les paramètres bindés