Колекція карт JPA Enum

Чи існує спосіб у JPA зіставити колекцію Enums у класі Entity? Або єдине рішення - обернути Enum іншим класом домену та використовувати його для зіставлення колекції?

@Entity
public class Person {
    public enum InterestsEnum {Books, Sport, etc...  }
    //@???
    Collection<InterestsEnum> interests;
}

Я використовую реалізацію Hibernate JPA, але, звичайно, віддаю перевагу агностичному рішенню реалізації.

за допомогою Hibernate ви можете зробити

@CollectionOfElements(targetElement = InterestsEnum.class)
@JoinTable(name = "tblInterests", joinColumns = @JoinColumn(name = "personID"))
@Column(name = "interest", nullable = false)
@Enumerated(EnumType.STRING)
Collection<InterestsEnum> interests;

Посилання у відповіді Енді є чудовою відправною точкою для зіставлення колекцій "несуб'єктних" об'єктів у JPA 2, але не зовсім повне, коли йдеться про картографічні переліки. Ось те, що я придумав замість цього.

@Entity
public class Person {
    @ElementCollection(targetClass=InterestsEnum.class)
    @Enumerated(EnumType.STRING) // Possibly optional (I'm not sure) but defaults to ORDINAL.
    @CollectionTable(name="person_interest")
    @Column(name="interest") // Column name in person_interest
    Collection<InterestsEnum> interests;
}

Я зміг зробити це таким простим способом:

@ElementCollection(fetch = FetchType.EAGER)
Collection<InterestsEnum> interests;

Необхідне напружене завантаження, щоб уникнути помилки ініціалізації лінивого завантаження, як пояснено тут .

Я використовую невелику модифікацію java.util.RegularEnumSet, щоб мати стійкий EnumSet:

@MappedSuperclass
@Access(AccessType.FIELD)
public class PersistentEnumSet<E extends Enum<E>> 
    extends AbstractSet<E> {
  private long elements;

  @Transient
  private final Class<E> elementType;

  @Transient
  private final E[] universe;

  public PersistentEnumSet(final Class<E> elementType) {
    this.elementType = elementType;
    try {
      this.universe = (E[]) elementType.getMethod("values").invoke(null);
    } catch (final ReflectiveOperationException e) {
      throw new IllegalArgumentException("Not an enum type: " + elementType, e);
    }
    if (this.universe.length > 64) {
      throw new IllegalArgumentException("More than 64 enum elements are not allowed");
    }
  }

  // Copy everything else from java.util.RegularEnumSet
  // ...
}

Цей клас зараз є базою для всіх моїх наборів перерахування:

@Embeddable
public class InterestsSet extends PersistentEnumSet<InterestsEnum> {
  public InterestsSet() {
    super(InterestsEnum.class);
  }
}

І цей набір я можу використовувати у своїй сутності:

@Entity
public class MyEntity {
  // ...
  @Embedded
  @AttributeOverride(name="elements", column=@Column(name="interests"))
  private InterestsSet interests = new InterestsSet();
}

Переваги:

• Робота з типом безпечного та продуктивного переліку, встановленого у вашому коді (див. java.util.EnumSetОпис)
• Набір - це лише один числовий стовпець у базі даних
• все просто JPA (немає спеціальних типів постачальника )
• легке (і коротке) оголошення нових полів того ж типу, порівняно з іншими рішеннями

Недоліки:

• Дублювання коду ( RegularEnumSetіPersistentEnumSet майже однакове)
  • Ви можете обернути результат EnumSet.noneOf(enumType)у своєму PersistenEnumSet, оголосити AccessType.PROPERTYта надати два методи доступу, які використовують відображення для читання та запису elementsполя
• Додатковий клас набору необхідний для кожного класу переліку, який слід зберігати у постійному наборі
  • Якщо ваш провайдер підтримує збереження embeddables без публічного конструктора, можна додати @Embeddableдо PersistentEnumSetі знизити додатковий клас ( ... interests = new PersistentEnumSet<>(InterestsEnum.class);)
• Ви повинні використовувати знак @AttributeOverride, як вказано в моєму прикладі, якщо у вас більше одногоPersistentEnumSet (інакше обидва вони зберігатимуться в одному і тому ж стовпці "елементи")
• Доступ до values()з відображенням у конструкторі не є оптимальним (особливо якщо дивитись на продуктивність), але два інших варіанти також мають свої недоліки:
  • Реалізація типу EnumSet.getUniverse()використовує sun.miscклас
  • Надання масиву значень як параметра має ризик того, що задані значення не є правильними
• Підтримуються лише переліки із значеннями до 64 (це насправді недолік?)
  • Замість цього ви можете використовувати BigInteger
• Використовувати поле елементів у запиті критеріїв або JPQL непросто
  • Ви можете використовувати двійкові оператори або стовпчик бітової маски з відповідними функціями, якщо ваша база даних це підтримує

tl; dr Коротким рішенням буде наступне:

@ElementCollection(targetClass = InterestsEnum.class)
@CollectionTable
@Enumerated(EnumType.STRING)
Collection<InterestsEnum> interests;

Довга відповідь полягає в тому, що за допомогою цих анотацій JPA створить одну таблицю, яка міститиме список InterestsEnum, що вказує на ідентифікатор основного класу (в даному випадку Person.class).

@ElementCollections вказує, де JPA може знайти інформацію про Enum

@CollectionTable створює таблицю, яка містить зв'язок від Person до InterestsEnum

@Enumerated (EnumType.STRING) каже JPA зберігати Enum як String, може бути EnumType.ORDINAL

Колекції в JPA стосуються відносин "один до багатьох" або "багато до багатьох", і вони можуть містити лише інші сутності. Вибачте, але вам потрібно було б обернути ці переліки в сутності. Якщо ви задумаєтесь, вам все одно знадобиться якесь поле ідентифікатора та зовнішній ключ, щоб зберегти цю інформацію. Тобто, якщо ви не зробите чогось божевільного, наприклад, зберігаєте список, відокремлений комами, у рядку (не робіть цього!).