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 :
- Constructeur sans argument obligatoire (public ou protégé) : Hibernate l'utilise par réflexion.
- Un
recordne peut pas être une entité : un record est immuable et n'a pas de constructeur sans argument, deux propriétés incompatibles avec le fonctionnement d'Hibernate. @GeneratedValue(strategy = GenerationType.IDENTITY)délègue la génération de l'identifiant à l'auto-incrément de la base ;SEQUENCEutilise une séquence dédiée, souvent plus performante.- En développement,
spring.jpa.hibernate.ddl-auto=updatefait créer/adapter les tables automatiquement. Jamais en production.
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
@Idmarque l'attribut identifiant (clé primaire).@GeneratedValuedélègue la génération de sa valeur à la base de données ou à Hibernate, avec unestrategy:IDENTITY(auto-incrément géré par la base) ouSEQUENCE(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. Jamaisupdatenicreate*en production.- @Enumerated(EnumType.STRING)
Indique que les valeurs d'un
enumsont stockées sous forme de texte dans la base plutôt que d'entier (comportement par défautORDINAL, à éviter).
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.