Hibernate: игнорирование несопоставленных переменных экземпляра

Быстрый ответ

Для того, чтобы Hibernate проигнорировал определённые поля ваших сущностей, воспользуйтесь аннотацией @Transient. Эта аннотация указывает Hibernate, что нужно пропустить маппинг этого поля на столбец базы данных:

// "Hibernate, не обращай внимание на это поле..." 🕶️
@Transient
private String ignoredField; // Это поле не будет сохранено в БД

До применения удостоверьтесь, что аннотация @Transient импортирована из пакета javax.persistence. Также следует помнить, что аннотация @Column позволяет изменить имя соответствующего столбца в базе данных, но не отменяет маппинг поля.

Что делает аннотация @Transient

Hibernate по умолчанию сохраняет все поля сущности. Однако, перед ему можно "сказать" не сохранять отдельные поля, добавив к ним аннотацию @Transient.

Корректное использование @Transient

Следуйте этим правилам, чтобы избежать путаницы в коде:

• Добавьте геттеры и сеттеры ко всем приватным полям, включая поля с аннотацией @Transient.
• Не забывайте тестировать ваше решение после изменений, чтобы убедиться, что поля действительно игнорируются.
• Имейте ясное представление о бизнес-требованиях и возможных последствиях исключения полей с помощью @Transient.

Подробнее об этом расскажет наш спикер на видео

Как избежать ошибок при работе с @Transient

Учтите следующее:

• Всегда проверяйте, откуда вы импортируете аннотацию @Transient – использование одноимённой аннотации из неправильного пакета может вызвать ошибки маппинга.
• Проверяйте, какие поля Hibernate включает или исключает из сохранения после любых изменений.

Влияние на SQL-запросы

Убедитесь, что поля, отмеченные как @Transient, не участвуют в SQL-запросах, автоматически формируемых Hibernate. В противном случае могут возникнуть проблемы с производительностью и работоспособностью приложения.

Визуализация

Представьте Hibernate как библиотекаря 🧐, который расставляет книги 📚 по полкам официального каталога. Всё, что не включено в каталог, он игнорирует.

Библиотека Hibernate (📚💼🧐):
| Книга на полке | Статус полки |
| --------------- | ------------- |
|     @Entity     |       ✔️       |
|  Несопоставлено |       ❌       |

// Поля без маппинга не поступают на полки библиотеки

Использование аннотации @Transient подразумевает, что некоторых полей в каталоге просто нет. Hibernate их видеть не будет. Это необходимо для поддержания порядка, предотвращения возможных ошибок при работе с базой данных и корректного функционирования EntityManager.

Практические примеры применения

Управление временными данными

Если какие-то данные должны существовать только во время выполнения программы и не предназначены для сохранения в БД, они должны быть отмечены аннотацией @Transient.

Кастомное именование колонок

Примените @Column для установки непосредственного соответствия между полем и столбцом в БД, и дайте этому столбцу своё имя, если вас не устраивают автоматически создаваемые имена.

@Column(name = "custom_column_name") // "Я предпочитаю называть вещи своими именами."
private String mappedField;

Исключение полей из сохранения

Проверьте, что поля, которые вы хотите исключить из сохранения:

• Отмечены аннотацией @Transient, или
• Не содержат JPA-аннотаций (тогда Hibernate автоматически их проигнорирует).

Проверка совместимости версий

Удостоверьтесь, что версия пакета javax.persistence в вашем проекте соответствует актуальной, чтобы избежать ошибок выполнения.

Полезные материалы

1. Руководство пользователя Hibernate ORM — обстоятельная информация о маппинге сущностей в Hibernate.
2. Baeldung – Hibernate Annotations — подробное руководство по аннотациям маппинга в Hibernate.
3. Baeldung – JPA & Hibernate: The @Transient Attribute — процесс использования @Transient для исключения полей из сохранения в Hibernate.
4. Why does JPA have a @Transient annotation? – Stack Overflow — обсуждение целей и областей применения аннотации @Transient.
5. Максимальная производительность работы с базами данных на Java – Влад Михалча — основная книга по вопросам повышения производительности Hibernate и постоянства в Java.
6. Сопоставление отношений в JPA и Hibernate – DZone — руководство по базовому и внедрению сложного сопоставления отношений в JPA и Hibernate.