Програмування
Що таке сутність JPA?
Сутність JPA (entity) — це Java-клас, позначений анотацією @Entity, об’єкти якого зберігаються в таблиці реляційної бази даних. Кожен об’єкт сутності відповідає одному рядку таблиці, а поля класу — стовпцям.
Сутність обов’язково має первинний ключ, позначений @Id, — зазвичай із автоматичною генерацією через @GeneratedValue. Назву таблиці й стовпців, обмеження на кшталт nullable і unique задають анотаціями @Table і @Column, а перелічувані типи — через @Enumerated.
Зв’язки між сутностями описують анотаціями @OneToOne, @OneToMany, @ManyToOne і @ManyToMany. Для них налаштовують спосіб завантаження (LAZY чи EAGER), каскадні операції й сторону, що володіє зв’язком (mappedBy). Сутність має мати конструктор без параметрів і не повинна бути final.
Де застосовується
Сутності — модель даних будь-якого Java-бекенду з базою даних: користувачі, курси, уроки, замовлення, платежі. З них Spring Data JPA будує репозиторії, а Hibernate генерує SQL-запити.
Хороша практика — не повертати сутності напряму з REST API, а перетворювати їх на DTO. Так API не залежить від структури бази, не розкриває зайвих полів і не потрапляє в пастки лінивого завантаження.
Приклад
Сутність курсу зі стовпцями, переліком і зв’язками.
@Entity
@Table(name = "courses")
@Getter @Setter
@NoArgsConstructor
public class Course {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
@Column(nullable = false, unique = true, length = 100)
private String title;
private int price;
@Enumerated(EnumType.STRING)
private Level level;
@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "mentor_id")
private Mentor mentor;
@OneToMany(mappedBy = "course", cascade = CascadeType.ALL, orphanRemoval = true)
private List<Lesson> lessons = new ArrayList<>();
}
Часті запитання
Чому поля зв’язку краще робити LAZY?
Жадібне завантаження (EAGER) підтягує пов’язані дані щоразу, навіть коли вони не потрібні, і може спричинити зайві запити. LAZY завантажує їх лише при зверненні, а потрібні дані підвантажують явно через JOIN FETCH.
Що робить mappedBy?
Вказує, що зв’язок належить іншій стороні, де є зовнішній ключ. Без нього Hibernate може створити зайву проміжну таблицю для зв’язку один-до-багатьох.
Чи можна використовувати record як сутність?
Ні. Сутність JPA має бути змінюваною, мати конструктор без параметрів і не бути final, а record цим вимогам не відповідає. Record добре підходять для DTO.
Навчання програмуванню в OWU
Опануйте професію в IT на практичних курсах із менторами та реальними проєктами.
Обрати курс