Какие знаешь требования к Entity в JPA?

Требования к Entity в JPA

Entity — это класс, который представляет таблицу в базе данных. JPA (Java Persistence API) предъявляет к сущностям строгие требования для корректной работы ORM-фреймворков.

Обязательные требования

1. Аннотация @Entity

   • Класс должен быть помечен аннотацией @Entity
   • JPA будет управлять этим классом как сущностью

2. Конструктор без параметров

   • Требуется конструктор с модификатором public или protected
   • JPA использует рефлексию для создания экземпляров

   @Entity
   public class User {
       private Long id;
       private String name;
       
       public User() {}
       
       public User(String name) {
           this.name = name;
       }
   }
   

3. Уникальный идентификатор (Primary Key)

   • Поле должно быть помечено аннотацией @Id
   • Может быть простым (Long, String) или составным

   @Entity
   public class Product {
       @Id
       @GeneratedValue(strategy = GenerationType.IDENTITY)
       private Long id;
   }
   

4. Модификаторы доступа

   • Поля должны быть private или protected
   • Доступ осуществляется через getter/setter методы

5. Не может быть final

   • Класс не должен быть final
   • Методы-геттеры не должны быть final

Важные дополнительные требования

@Table аннотация

Определяет имя таблицы и схему:

@Entity
@Table(name = "users", schema = "public")
public class User {
    // code
}

Mapping полей

Поля класса должны соответствовать колонкам БД:

@Entity
public class Order {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @Column(name = "total_amount", nullable = false)
    private BigDecimal totalAmount;
    
    @Column(length = 255)
    private String description;
    
    @Temporal(TemporalType.TIMESTAMP)
    private Date createdAt;
}

Relationships

Для связей между сущностями:

• @OneToOne — один-к-одному
• @OneToMany — один-ко-многим
• @ManyToOne — много-к-одному
• @ManyToMany — много-ко-многим

Лучшие практики

1. Используйте surrogate keys (Long с автогенерацией)
2. Избегайте lazy loading проблем — явно указывайте fetch типы
3. Применяйте cascading операции осторожно
4. Избегайте циклических зависимостей между сущностями
5. Реализуйте Serializable интерфейс

Эти требования обеспечивают корректную работу JPA-провайдеров и гарантируют предсказуемое поведение при работе с БД.