Phone icon Зв'язатись з нами

Програмування

Що таке сутність 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<>();
}
Анотації @Entity, @Id, @Column, @ManyToOne і @OneToMany.

Часті запитання

Чому поля зв’язку краще робити LAZY?

Жадібне завантаження (EAGER) підтягує пов’язані дані щоразу, навіть коли вони не потрібні, і може спричинити зайві запити. LAZY завантажує їх лише при зверненні, а потрібні дані підвантажують явно через JOIN FETCH.

Що робить mappedBy?

Вказує, що зв’язок належить іншій стороні, де є зовнішній ключ. Без нього Hibernate може створити зайву проміжну таблицю для зв’язку один-до-багатьох.

Чи можна використовувати record як сутність?

Ні. Сутність JPA має бути змінюваною, мати конструктор без параметрів і не бути final, а record цим вимогам не відповідає. Record добре підходять для DTO.

Навчання програмуванню в OWU

Опануйте професію в IT на практичних курсах із менторами та реальними проєктами.

Обрати курс