Какие условия должны быть выполнены чтобы класс стал сущностью

# Условия для создания JPA сущности

Для того чтобы класс стал сущностью в контексте JPA (Java Persistence API) и фреймворков вроде Hibernate, необходимо выполнить следующие условия:

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

Класс должен быть отмечен аннотацией @Entity:

import javax.persistence.Entity;

@Entity
public class User {
    // класс становится сущностью
}

Эта аннотация указывает ORM-фреймворку, что данный класс должен быть сохранен в базе данных как таблица.

2. Конструктор по умолчанию

В классе должен быть конструктор без параметров (может быть private или protected):

@Entity
public class User {
    public User() {} // или protected User() {}
    
    public User(String name) {
        this.name = name;
    }
}

Это необходимо ORM для создания экземпляров класса через рефлексию.

3. Первичный ключ (@Id)

Класс должен содержать поле, обозначенное аннотацией @Id:

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.UUID)
    private UUID id;
    
    // другие поля
}

Первичный ключ уникально идентифицирует каждый объект в таблице.

4. Поля с геттерами и сеттерами

Все персистентные поля должны иметь публичные геттеры и сеттеры (или методы доступа):

@Entity
public class User {
    @Id
    private UUID id;
    
    private String name;
    private String email;
    
    // Геттеры и сеттеры
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    
    public String getEmail() { return email; }
    public void setEmail(String email) { this.email = email; }
}

5. Класс не должен быть final

Класс не может быть объявлен как final, так как ORM-фреймворкам нужна возможность создавать динамические прокси:

// ❌ Неправильно
@Entity
public final class User { }

// ✅ Правильно
@Entity
public class User { }

6. Пустая или минимальная таблица

По умолчанию таблица в БД автоматически создается на основе имени класса. Можно переопределить через аннотацию:

@Entity
@Table(name = "users")
public class User {
    // таблица будет называться "users"
}

Полный пример правильной сущности:

import javax.persistence.*;
import java.util.UUID;

@Entity
@Table(name = "users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.UUID)
    private UUID id;
    
    @Column(nullable = false, unique = true)
    private String email;
    
    @Column(nullable = false)
    private String name;
    
    private String phone;
    
    // Конструктор без параметров
    public User() {}
    
    // Конструктор с параметрами
    public User(String email, String name) {
        this.email = email;
        this.name = name;
    }
    
    // Геттеры и сеттеры
    public UUID getId() { return id; }
    public String getEmail() { return email; }
    public void setEmail(String email) { this.email = email; }
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public String getPhone() { return phone; }
    public void setPhone(String phone) { this.phone = phone; }
}

Дополнительные аннотации:

• @Column — настройка свойств колонки (nullable, unique, length и т.д.)
• @Transient — поле, которое не должно быть сохранено в БД
• @OneToMany, @ManyToOne, @ManyToMany — отношения между сущностями
• @Version — для оптимистичной блокировки

Выполнение всех этих условий делает класс полноценной JPA сущностью, которую можно сохранять в базу данных через ORM-фреймворк.