Formations — 1 037 leçons en français

Accueil › Spring Boot › Les entités JPA

Les entités JPA

Accéder aux données avec Spring Data JPAdebutant

JPA (Jakarta Persistence API) est une spécification pour mapper des objets Java à des tables de base de données. Hibernate est l'implémentation utilisée par défaut dans Spring Boot. Spring Data JPA ajoute une couche par-dessus pour générer les repositories automatiquement (leçon suivante).

Une entité est une classe annotée @Entity, avec un identifiant @Id :

@Entity
public class Produit {

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

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

    private double prix;

    protected Produit() { } // requis par Hibernate

    public Produit(String nom, double prix) {
        this.nom = nom;
        this.prix = prix;
    }

    // getters...
}

Points essentiels :

Les termes à connaître

JPA

Jakarta Persistence API : une spécification Java qui définit comment mapper des objets Java à des tables de base de données (ORM, Object-Relational Mapping). JPA ne fait rien par elle-même : il faut une implémentation.

Hibernate

L'implémentation de JPA utilisée par défaut dans Spring Boot. C'est Hibernate qui génère le SQL, gère le cache et traduit les entités en lignes de table.

Spring Data JPA

Une couche au-dessus de JPA/Hibernate, fournie par Spring, qui génère automatiquement les repositories (voir la leçon suivante) à partir d'interfaces. Elle ne remplace pas JPA, elle simplifie son usage.

@Entity

Annotation qui marque une classe comme entité JPA : chaque instance correspond à une ligne d'une table. La classe doit avoir un constructeur sans argument (public ou protégé) et ne peut pas être final.

@Id et @GeneratedValue

@Id marque l'attribut identifiant (clé primaire). @GeneratedValue délègue la génération de sa valeur à la base de données ou à Hibernate, avec une strategy : IDENTITY (auto-incrément géré par la base) ou SEQUENCE (séquence, plus performante en insertions groupées).

@Table et @Column

@Table(name = "...") précise le nom de la table si elle diffère du nom de la classe. @Column(name = "...", nullable = false, length = 100) précise le nom, la nullabilité ou la taille d'une colonne. Sans ces annotations, Hibernate déduit les noms depuis les noms Java.

spring.jpa.hibernate.ddl-auto

Propriété qui contrôle si Hibernate modifie le schéma de la base au démarrage. Valeurs : none, validate, update, create, create-drop. Jamais update ni create* en production.

@Enumerated(EnumType.STRING)

Indique que les valeurs d'un enum sont stockées sous forme de texte dans la base plutôt que d'entier (comportement par défaut ORDINAL, à éviter).

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.