ORM, entités et mapping de base

Votre API Spring Boot stocke ses données dans une Map en mémoire : tout disparaît au redémarrage. Il faut une base de données relationnelle (PostgreSQL, MySQL…). Écrire le SQL à la main pour chaque objet est long et répétitif : un ORM (Object-Relational Mapping) fait le lien entre vos classes Java et les tables.

• JPA (Jakarta Persistence, package jakarta.persistence) est la spécification standard : des annotations et des interfaces.
• Hibernate est l’implémentation la plus utilisée, et celle que Spring Boot configure par défaut. Ce cours utilise Spring Boot 4.1 avec Java 25 : Hibernate 7 y implémente Jakarta Persistence 3.2.
• Spring Data JPA ajoute par-dessus des repositories générés automatiquement (leçon 2).

Configuration

Ajoutez spring-boot-starter-data-jpa, son starter de test spring-boot-starter-data-jpa-test (scope test, pour @DataJpaTest, leçon 5) et le pilote de votre base (org.postgresql:postgresql, ou com.h2database:h2 pour une base en mémoire de test). Spring Initializr ajoute ces dépendances quand on choisit Spring Data JPA et H2 (-d dependencies=web,data-jpa,h2). Puis, dans application.properties :

spring.datasource.url=jdbc:postgresql://localhost:5432/boutique
spring.datasource.username=boutique
spring.datasource.password=${DB_PASSWORD}
spring.jpa.hibernate.ddl-auto=update     # create-drop, update, validate, none
spring.jpa.show-sql=true                 # affiche le SQL généré (développement)
spring.jpa.open-in-view=false            # recommandé, voir leçon 4

ddl-auto contrôle la génération du schéma : create-drop (recréé à chaque démarrage), update (ajoute ce qui manque), validate (vérifie sans modifier), none. En production, on utilise validate ou none et des migrations versionnées (leçon 5).

Une première entité

package fr.boutique.produit;

import jakarta.persistence.*;
import java.math.BigDecimal;
import java.time.LocalDateTime;

@Entity                                  // classe persistante
@Table(name = "produit")                 // facultatif : nom de table explicite
public class Produit {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY) // id généré par la base
    private Long id;

    @Column(nullable = false, length = 100)
    private String nom;

    @Column(nullable = false, precision = 10, scale = 2)
    private BigDecimal prix;             // jamais de double pour de l'argent

    @Enumerated(EnumType.STRING)         // stocke "ACTIF", pas 0
    private StatutProduit statut = StatutProduit.ACTIF;

    private LocalDateTime dateCreation;  // colonne date_creation

    protected Produit() { }              // exigé par JPA

    public Produit(String nom, BigDecimal prix) {
        this.nom = nom;
        this.prix = prix;
        this.dateCreation = LocalDateTime.now();
    }

    public Long getId() { return id; }
    public String getNom() { return nom; }
    public void setNom(String nom) { this.nom = nom; }
    // autres getters / setters...
}

enum StatutProduit { ACTIF, ARCHIVE }

Points essentiels :

• JPA exige un constructeur sans argument (au moins protected) et une classe non final : Hibernate instancie l’objet puis remplit les champs, et crée des proxys pour le chargement paresseux. C’est pourquoi un record ne peut pas être une entité ; il reste idéal pour les DTO.
• L’identifiant est un type objet (Long) : null signifie « pas encore enregistré ».
• @Enumerated(EnumType.STRING) est indispensable : avec la valeur par défaut ORDINAL, insérer une valeur au milieu de l’énumération corromprait silencieusement les données existantes.

Nommage et types

Spring Boot configure une stratégie de nommage qui convertit le camelCase en snake_case : dateCreation devient date_creation, la classe LigneCommande la table ligne_commande. Les types Java sont associés aux types SQL : Long → bigint, String → varchar(255) par défaut, BigDecimal → numeric, LocalDate → date, LocalDateTime → timestamp, boolean → boolean. Les types primitifs (int, boolean) produisent des colonnes not null.

Avec show-sql=true, observez au démarrage le create table généré : c’est le meilleur moyen de vérifier votre mapping.