Сохранение List<String> в JPA: решение проблемы с PersistenceException

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

Для сохранения списка строк List<String> с помощью JPA используйте аннотацию @ElementCollection. Она позволяет создавать вспомогательную таблицу для хранения элементов списка, связанных с основной сущностью. Вот как это выглядит на примере:

@Entity
public class ExampleEntity {
  
  @Id
  private Long id;

  @ElementCollection
  private List<String> strings;
}

Выше приведенный код создаст отдельную таблицу, где каждая строка списка String будет ассоциирована с сущностью ExampleEntity посредством id. Механизм сохранения и извлечения данных включает все строки списка.

Если нужна детализация настройки таблицы, есть аннотации @CollectionTable и @Column, с помощью которых вы можете задать имя таблицы и настроить внешний ключ:

@ElementCollection
@CollectionTable(name = "table_for_strings", joinColumns = @JoinColumn(name = "example_entity_id"))
@Column(name = "string_field")
private List<String> strings;

Для сохранения списков со сложной структурой используйте AttributeConverter для сериализации и десериализации, добавив его с помощью аннотации @Convert:

@Convert(converter = ListOfStringsConverter.class)
private List<String> strings;

Коллекции элементов: детали и нюансы

Сущность @ElementCollection

Аннотация @ElementCollection подходит для хранения экземпляров базовых или встраиваемых типов в отдельной таблице. Для списка строк это предпочтительнее, чем использование Serializable, поскольку такой подход обеспечивает более чистый код и повышает производительность.

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

Выбор стратегии загрузки

Стратегия загрузки для @ElementCollection по умолчанию – ленивая (FetchType.LAZY), что снижает издержки при работе с большим объемом данных. Но возможно и использование "жадной" загрузки:

@ElementCollection(fetch = FetchType.EAGER)
private List<String> strings;

Вместе с тем, FetchType.EAGER может отрицательно сказаться на производительности, особенно при большом размере списка.

Отображение пары ключ-значение

Если элементы списка являются парами ключ-значение, можно использовать Map<Key, Value>:

@ElementCollection
@MapKeyColumn(name="config_key")
@Column(name="config_value")
private Map<String, String> configParameters;

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

Связь таблиц и первичный ключ

Таблица, хранящая список строк List<String>, должна иметь внешний ключ, связывающий ее с основной сущностью. Для автоматизации процессов создайте первичный ключ с помощью @GeneratedValue:

@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;

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

Представим, что у нас есть ожерелье из жемчуга (List<String>), которое необходимо аккуратно разложить в одной ювелирной коробке (сущность в JPA). Каждая жемчужина — это строка списка.

// Список строк (List<String>)
Жемчужины: ["Жемчужина1", "Жемчужина2", "Жемчужина3"]

// Сущность JPA
Ювелирная коробка: 🎁

Применяя @ElementCollection, мы получаем:

@ElementCollection                         
List<String> жемчужины; // Жемчужное ожерелье!

// После применения @ElementCollection
Ювелирная коробка: 🎁🔒["Жемчужина1", "Жемчужина2", "Жемчужина3"] // Сохранено надежно.

Таким образом, можно легко получить доступ к нужной жемчугине или добавить новую, не трогая остальное ожерелье.

Особенности, подводные камни и советы по использованию

"Нет провайдера постоянства"

Сообщение "Нет провайдера постоянства" указывает на ошибки в конфигурации. Проверьте файл persistence.xml и корректность объявлений аннотаций в сущностях.

Автоматическое управление схемами таблиц и операции DDL

Если используется автоматическое управление схемами (hibernate.hbm2ddl.auto), Hibernate сам создает нужные таблицы и отношения. Но стоит внимательно контролировать этот процесс, чтобы избежать нежелательных изменений.

Обработка исключений PersistenceException

PersistenceException может возникнуть при некорректном отображении сущностей или ошибочном управлении транзакциями. Знание аннотаций JPA и их правильное использование поможет избежать таких ошибок.

Выбор типа коллекции

List и Set отличаются тем, что первый сохраняет порядок элементов, а второй – их уникальность. Выбирайте тип коллекции в зависимости от ваших требований.

@ElementCollection(targetClass=String.class)
private Set<String> uniqueStrings;

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

1. Лучшие практики для ассоциаций многие-ко-многим с Hibernate и JPA
2. ElementCollection (Java(TM) EE 7 Specification APIs)
3. Руководство пользователя для Hibernate ORM 5.4.33.Final
4. Java Persistence/Embeddables – Wikibooks
5. Convert (Java(TM) EE 7 Specification APIs)