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, то есть не о простом изменении объекта, а о команде обновления базы данных, даже если это выполняется с помощью спящего режима.

Pedro