Formations — 1 037 leçons en français

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 clause WHERE du UPDATE : 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 @Version ne 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 @Configuration qui 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 (ou Instant…), remplies automatiquement à la création (@CreatedDate) ou à chaque modification (@LastModifiedDate) de l'entité, sans code applicatif.

@CreatedBy, @LastModifiedBy et AuditorAware

@CreatedBy/@LastModifiedBy enregistrent qui a créé ou modifié l'entité. Ils ont besoin d'un bean AuditorAware<T> fourni par l'application, dont la méthode getCurrentAuditor() 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, @EnableJpaAuditing seul ne suffit pas, les champs @CreatedDate/@LastModifiedDate/@CreatedBy/@LastModifiedBy restent vides.

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.