@NaturalId в Hibernate
Аннотация @NaturalId помечает естественный (бизнес-идентификатор) поля сущности, который не является техническим первичным ключом (@Id), но обладает уникальностью и часто используется для поиска.
Пакет: org.hibernate.annotations
Применяется к: полям или свойствам сущности (String, Integer, UUID и др.).
Особенности:
Ускоряет поиск по "естественному" ключу (Hibernate кеширует NaturalId → ID).
Может быть изменяемым (mutable) или неизменяемым (immutable).
Параметры и настройки
mutable: Если true — NaturalId можно изменить (по умолчанию false).
Примеры
Жизненный цикл и обработка
Как работает @NaturalId?
При сохранении:
Hibernate проверяет уникальность NaturalId (если нет @UniqueConstraint).
Добавляет запись в кеш NaturalId → ID.
При поиске:
session.bySimpleNaturalId(User.class).load("test@mail.com") — использует кеш.
Генерирует SQL: SELECT id FROM users WHERE email = ?.
При изменении (если mutable=true):
Обновляет кеш (старое значение удаляется, новое добавляется).
Кеширование
Уровень L1 (сессия): Кешируется в рамках текущей сессии.
Уровень L2 (глобальный): Требует включенного кеша второго уровня.
Примеры использования
Пример 1: Неизменяемый NaturalId
Пример 2: Поиск по NaturalId
Ограничения
Производительность при mutable=true:
Частые изменения NaturalId требуют обновления кеша.
Отсутствие JPA-стандарта:
@NaturalId — это фича Hibernate (не работает в EclipseLink).
Когда использовать?
Для часто используемых бизнес-идентификаторов (email, ISBN, серийные номера).
Вместо @Id, если первичный ключ — суррогатный (автоинкремент).
#Java #Training #Hard #Spring #Hibernate #NaturalId
Аннотация @NaturalId помечает естественный (бизнес-идентификатор) поля сущности, который не является техническим первичным ключом (@Id), но обладает уникальностью и часто используется для поиска.
Пакет: org.hibernate.annotations
Применяется к: полям или свойствам сущности (String, Integer, UUID и др.).
Особенности:
Ускоряет поиск по "естественному" ключу (Hibernate кеширует NaturalId → ID).
Может быть изменяемым (mutable) или неизменяемым (immutable).
Параметры и настройки
mutable: Если true — NaturalId можно изменить (по умолчанию false).
Примеры
@Entity
public class User {
@Id
private Long id;
@NaturalId(mutable = false) // Неизменяемый (оптимизирует кеширование)
private String email;
@NaturalId(mutable = true) // Изменяемый (редкий случай)
private String passportNumber;
}
Жизненный цикл и обработка
Как работает @NaturalId?
При сохранении:
Hibernate проверяет уникальность NaturalId (если нет @UniqueConstraint).
Добавляет запись в кеш NaturalId → ID.
При поиске:
session.bySimpleNaturalId(User.class).load("test@mail.com") — использует кеш.
Генерирует SQL: SELECT id FROM users WHERE email = ?.
При изменении (если mutable=true):
Обновляет кеш (старое значение удаляется, новое добавляется).
Кеширование
Уровень L1 (сессия): Кешируется в рамках текущей сессии.
Уровень L2 (глобальный): Требует включенного кеша второго уровня.
Примеры использования
Пример 1: Неизменяемый NaturalId
@Entity
@Table(uniqueConstraints = @UniqueConstraint(columnNames = "isbn"))
public class Book {
@Id
private Long id;
@NaturalId // immutable=false по умолчанию
private String isbn;
}
Пример 2: Поиск по NaturalId
Book book = session.bySimpleNaturalId(Book.class)
.load("978-3-16-148410-0");
Ограничения
Производительность при mutable=true:
Частые изменения NaturalId требуют обновления кеша.
Отсутствие JPA-стандарта:
@NaturalId — это фича Hibernate (не работает в EclipseLink).
Когда использовать?
Для часто используемых бизнес-идентификаторов (email, ISBN, серийные номера).
Вместо @Id, если первичный ключ — суррогатный (автоинкремент).
#Java #Training #Hard #Spring #Hibernate #NaturalId