Использование настройки orphanRemoval для автоматического удаления из БД строк, когда соответствующие им объекты удаляются из поля-коллекции родительского объекта в Hibernate

При создании двунаправленной связи между двумя классами-сущностями мы должны самостоятельно управлять жизненными циклами объектов каждого класса. Однако, если объекты дочернего класса используются только в полях типа Collection родительского класса, то с помощью настройки orphanRemoval можно указать Hibernate’у удалять из БД строки с данными дочернего класса, при удалении объектов из этой коллекции.

Например, если в классе Person есть поле List и между классами Person и Address установлена двунаправленная связь, то можно настроить автоматическое удаление строк из таблицы Address при удалении соответствующих объектов из List.

Подготовка

Создадим минимальное Spring Boot приложение с поддержкой JPA/Hibernate.

Код

Создадим двунаправленную связь между двумя классами-сущностями. Для этого сперва создадим класс предметной области следующего содержания:

А затем следующий класс-сущность:

Подробное описание аннотаций и их параметров, используемых при создании двунаправленной связи, см. в соответствующей статье.

Мы передаём в параметр cascade аннотации @OneToMany значение CascadeType.PERSIST, указывая Hibernate’у автоматически сохранять в БД данные списка addresses при сохранении объекта Person. См. подробней о CascadeType.PERSIST. Без этой настройки автоматическое удаление строк из БД при удалении объектов из списка работать не будет.

Затем мы устанавливаем значение параметра orphanRemoval равным true, указывая Hibernate’у удалять соответствующую строку из таблицы ADDRESS, когда объект будет удаляться из списка addresses.

Создадим репозиторий для класса Address:

Далее создадим репозиторий для класса Person:

Напишем тестовый метод, который продемонстрирует работу настроек:

В данном методе мы создаём объект irina Типа Person и список из двух объектов Address. Мы устанавливаем ссылки объектов друг на друга. У каждого объекта Address поле person заполняется ссылкой на объект irina в конструкторе. Затем список Address устанавливается в поле addresses объекта irina через сеттер: irina.setAddresses(irinasAddresses).

Затем мы сохраняем только объект irina. Этого достаточно, так как благодаря настройке CascadeType.PERSIST данные объектов irinasHomeAddress и irinasSummerHouseAddress сохранятся при сохранении объекта irina.

Затем мы извлекаем из БД как данные объекта irina, так и два её адреса. Утверждение assertTrue(addressesInDb.containsAll(irinasAddresses)) доказывает, что оба адреса были успешно сохранены и извлечены.

Затем мы удаляем адрес irinasSummerHouseAddress из списка addresses объекта irinaInDb и сохраняем его состояние.

Снова извлекаем адреса из БД. Утверждение assertFalse(addressesInDb.contains(irinasSummerHouseAddress)) доказывает, что адрес irinasSummerHouseAddress был удалён также и из БД. хотя мы только удалили его из списка addresses конкретного объекта. Мы ни разу не вызвали addressRepository.delete(irinasSummerHouseAddress). Такое поведение и обусловлено настройкой orphanRemoval = true.

Обратим внимание, что, во-первых, данные объектов Address будут удаляться из БД по одной строке. Таким образом, если их достаточно много, это может сказаться на производительности. Во-вторых, поскольку класс Address объявлен сущностью, в общем случае у его объектов и данных собственный жизненный цикл, который управляется специально созданным для этого репозиторием. Автоматическое удаление данных может привести к тому, что где-то в коде ещё будут оставаться ссылки на удалённые из БД объекты, что приведёт к несогласованности состояния БД и кода.