Программирование
Что такое сущность 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 на практических курсах с менторами и реальными проектами.
Выбрать курс