Accueil › Spring Boot › Verrouillage optimiste et audit
Verrouillage optimiste et audit
JPA avancéintermediaire
Verrouillage optimiste : un champ @Version détecte les écritures concurrentes sans jamais bloquer personne.
@Entity
public class Commande {
@Id @GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
@Version
private Long version; // incrémenté à chaque UPDATE
private StatutCommande statut;
}
Hibernate inclut la version dans la clause WHERE de chaque UPDATE. Si elle a changé entre la lecture et l'écriture, aucune ligne ne correspond : Hibernate lève une ObjectOptimisticLockingFailureException. C'est le comportement recherché dans la majorité des applications web : pas de verrou tenu pendant la réflexion de l'utilisateur, juste une détection de conflit au moment d'écrire.
Audit automatique : remplir dateCreation, derniereModification, etc. sans code applicatif.
@Configuration
@EnableJpaAuditing
public class JpaAuditingConfig { }
@Entity
@EntityListeners(AuditingEntityListener.class)
public class Commande {
@CreatedDate
private LocalDateTime dateCreation;
@LastModifiedDate
private LocalDateTime derniereModification;
}
Les deux ingrédients sont nécessaires : @EnableJpaAuditing active le mécanisme au niveau de l'application, @EntityListeners(AuditingEntityListener.class) le déclenche pour cette entité précise. Pour savoir qui a créé/modifié une ligne (@CreatedBy/@LastModifiedBy), il faut en plus fournir un bean AuditorAware<T>.
Les termes à connaître
- @Version
Champ ajouté à une entité (
Long,Integer,Short…) pour activer le verrouillage optimiste. Hibernate l'incrémente à chaque mise à jour et l'inclut dans la clauseWHEREduUPDATE: si la version en base a changé depuis la lecture, aucune ligne n'est mise à jour et Hibernate détecte le conflit.- ObjectOptimisticLockingFailureException
Exception levée quand une mise à jour avec
@Versionne trouve aucune ligne correspondante (version obsolète) : quelqu'un d'autre a modifié la ligne entre la lecture et l'écriture. Signale un conflit d'écriture concurrente, pas une erreur de code.- @Lock(LockModeType.PESSIMISTIC_WRITE)
Sur une méthode de repository, force un verrouillage pessimiste : la requête SQL sous-jacente verrouille les lignes lues (typiquement
SELECT ... FOR UPDATE), empêchant toute autre transaction de les modifier — voire de les lire selon le mode — jusqu'à la fin de la transaction en cours.- @EnableJpaAuditing
Annotation posée sur une classe
@Configurationqui active l'infrastructure d'audit de Spring Data JPA : c'est elle qui déclenche le remplissage automatique des champs@CreatedDate,@LastModifiedDate,@CreatedBy,@LastModifiedBy.- @CreatedDate et @LastModifiedDate
Posées sur un champ de type
LocalDateTime(ouInstant…), remplies automatiquement à la création (@CreatedDate) ou à chaque modification (@LastModifiedDate) de l'entité, sans code applicatif.- @CreatedBy, @LastModifiedBy et AuditorAware
@CreatedBy/@LastModifiedByenregistrent qui a créé ou modifié l'entité. Ils ont besoin d'un beanAuditorAware<T>fourni par l'application, dont la méthodegetCurrentAuditor()renvoie l'utilisateur courant (souvent déduit du contexte de sécurité).- @EntityListeners(AuditingEntityListener.class)
Annotation à poser sur chaque entité (ou une classe de base commune) pour que les champs d'audit soient réellement renseignés : sans elle,
@EnableJpaAuditingseul ne suffit pas, les champs@CreatedDate/@LastModifiedDate/@CreatedBy/@LastModifiedByrestent vides.
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.