Java - JPA - анотація @Version

Як @Version анотація в JPA?

Я знайшов різні відповіді, витяг яких такий:

JPA використовує поле версії у ваших структурах для виявлення одночасних модифікацій одного запису сховища даних. Коли час виконання JPA виявляє спробу одночасно змінити один і той же запис, він видає виняток із транзакції, яка намагається зробити останню.

Але я все ще не впевнений, як це працює.

Також з наступних рядків:

Ви повинні вважати поля версій незмінними. Зміна значення поля має невизначені результати.

Чи означає це, що ми повинні оголосити поле своєї версії як final?

Але все ж я не впевнений, як це працює?

Скажімо, суб'єкт господарювання MyEntityмає versionвластивість, що позначається :

@Entity
public class MyEntity implements Serializable {    

    @Id
    @GeneratedValue
    private Long id;

    private String name;

    @Version
    private Long version;

    //...
}

Після оновлення поле, анотоване до, @Versionбуде нарощено та додане до WHEREпункту, приблизно так:

UPDATE MYENTITY SET ..., VERSION = VERSION + 1 WHERE ((ID = ?) AND (VERSION = ?))

Якщо WHEREпункт не відповідає запису (тому що той самий об'єкт уже оновлений іншим потоком), постачальник наполегливості викине OptimisticLockException.

Чи означає це, що ми повинні оголосити поле своєї версії остаточним

Ні, але ви можете розглянути можливість захисту сетера захищеним, оскільки ви не повинні його називати.

Хоча відповідь @Pascal цілком коректна, я вважаю, що код нижче корисний для оптимістичного блокування:

@Entity
public class MyEntity implements Serializable {    
    // ...

    @Version
    @Column(name = "optlock", columnDefinition = "integer DEFAULT 0", nullable = false)
    private long version = 0L;

    // ...
}

Чому? Тому що:

1. Оптимістичне блокування не працюватиме, якщо @Versionвипадково встановлено поле, на яке позначено анотаціюnull .
2. Оскільки це спеціальне поле не обов'язково є діловою версією об’єкта, щоб уникнути омани, я вважаю за краще називати таке поле чимось подібним, optlockа не version.

Перший пункт не має значення, чи програма використовує лише JPA для вставки даних у базу даних, оскільки постачальник JPA буде застосовувати 0для @versionполя під час створення. Але майже завжди звичайні оператори SQL також використовуються (принаймні під час тестування блоків та інтеграції).

Щоразу, коли сутність оновлюється в базі даних, поле версії збільшуватиметься на одиницю. Кожна операція, яка оновлює сутність у базі даних, буде додана WHERE version = VERSION_THAT_WAS_LOADED_FROM_DATABASEдо її запиту.

Перевіряючи порушені рядки вашої операції, фреймворк jpa може переконатися, що між завантаженням та збереженням вашої сутності не було одночасних змін, оскільки запит не знайде вашу сутність у базі даних, коли її номер версії збільшиться між завантаженням та збережеться.

Версія використовується для забезпечення лише одного оновлення за раз. Провайдер JPA перевірить версію, якщо очікувана версія вже збільшиться, тоді хтось уже оновить сутність, тому буде викинуто виняток.

Таким чином, оновлення вартості об'єкта було б більш безпечним і оптимістичним.

Якщо значення часто часте, ви можете не використовувати поле версії. Наприклад, "сутність, яка має лічильне поле, яке збільшуватиметься кожного разу, коли доступ до веб-сторінки"

Просто додайте трохи більше інформації.

JPA керує версією під кришкою для вас, однак це не робиться, коли ви оновлюєте свій запис за допомогою JPAUpdateClause, у таких випадках вам потрібно вручну додавати приріст версії до запиту.

Те саме можна сказати про оновлення через JPQL, тобто не просту зміну сутності, а команду оновлення бази даних, навіть якщо це робиться в сплячому режимі.

Педро