Какие знаешь обязательные поля у сущности для использования в HibernateКакие знаешь обязательные поля у сущности для использования в Hibernate?

Обязательные поля сущности для Hibernate

Общие требования

Hibernate — это ORM (Object-Relational Mapping) фреймворк для Java, который требует соблюдения определённых условий при создании сущностей (entity классов). Рассмотрим обязательные и рекомендуемые элементы.

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

Помечает класс как сущность, которую Hibernate будет управлять.

import javax.persistence.Entity;
import javax.persistence.Table;

@Entity
@Table(name = "users")  // Опционально, если имя отличается от класса
public class User {
    // Содержимое класса
}

Обязательна: Да

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

Каждая сущность ДОЛЖНА иметь первичный ключ, помеченный аннотацией @Id.

@Entity
public class User {
    @Id
    private Long id;  // Обязательно!
    
    private String name;
}

Обязательна: Да

Типичные типы ID:

• Long — для больших таблиц
• Integer — для меньших таблиц
• String — для строковых ID (UUID)
• UUID — универсальные идентификаторы

3. Стратегия генерации ID (@GeneratedValue)

Обычно ID генерируется автоматически.

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;  // Auto-increment в БД
    
    private String name;
}

// Альтернативные стратегии
@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE)
private Long id;  // Использует SEQUENCE в БД

@Id
@GeneratedValue(strategy = GenerationType.TABLE)
private Long id;  // Использует служебную таблицу

@Id
@GeneratedValue(strategy = GenerationType.UUID)
private UUID id;  // UUID для уникальности

@Id
@GeneratedValue(generator = "uuid")
@GenericGenerator(name = "uuid", strategy = "uuid2")
private String id;  // Строка UUID

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

Обязателен конструктор без параметров (может быть private в современной Java).

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    private String name;
    private int age;
    
    // Обязательный конструктор по умолчанию
    public User() {}
    
    // Дополнительный конструктор с параметрами
    public User(String name, int age) {
        this.name = name;
        this.age = age;
    }
}

Почему? Hibernate использует reflection и создаёт объекты через конструктор без аргументов.

5. Поля (Columns)

Обычные поля класса, которые нужно сохранять.

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @Column(name = "user_name", nullable = false, length = 100)
    private String name;  // Обязательное поле
    
    @Column(name = "user_age")
    private Integer age;  // Опциональное поле
    
    @Column(unique = true)
    private String email;  // Уникальное поле
    
    @Transient  // Это поле НЕ сохраняется в БД
    private String tempField;
}

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

import javax.persistence.*;

@Entity
@Table(name = "users")  // Таблица в БД
public class User {
    // Обязательные элементы:
    
    @Id  // Первичный ключ (ОБЯЗАТЕЛЕН)
    @GeneratedValue(strategy = GenerationType.IDENTITY)  // Стратегия генерации
    private Long id;
    
    // Поля сущности
    @Column(nullable = false)
    private String name;
    
    @Column(unique = true)
    private String email;
    
    private int age;
    
    // Конструктор по умолчанию (ОБЯЗАТЕЛЕН)
    public User() {}
    
    // Параметризованный конструктор (рекомендуется)
    public User(String name, String email, int age) {
        this.name = name;
        this.email = email;
        this.age = age;
    }
    
    // Геттеры и сеттеры
    public Long getId() { return id; }
    
    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; }
    
    public int getAge() { return age; }
    public void setAge(int age) { this.age = age; }
}

7. Использование в Hibernate

// Создание сессии
SessionFactory sessionFactory = new Configuration()
    .addAnnotatedClass(User.class)
    .buildSessionFactory();

Session session = sessionFactory.openSession();
Transaction transaction = session.beginTransaction();

// Сохранение
User user = new User("John", "john@example.com", 30);
Long userId = (Long) session.save(user);

// Получение
User foundUser = session.get(User.class, userId);

// Обновление
foundUser.setAge(31);
session.update(foundUser);

// Удаление
session.delete(foundUser);

transaction.commit();
session.close();

8. С Spring Data JPA (рекомендуемый подход)

import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository<User, Long> {
}

// Использование в сервисе
@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;
    
    public User save(User user) {
        return userRepository.save(user);
    }
    
    public User findById(Long id) {
        return userRepository.findById(id).orElse(null);
    }
    
    public void delete(Long id) {
        userRepository.deleteById(id);
    }
}

Обязательные элементы - Чеклист

• ✓ Аннотация @Entity на классе
• ✓ Поле с аннотацией @Id (первичный ключ)
• ✓ Аннотация @GeneratedValue на ID
• ✓ Конструктор без параметров (даже если private)
• ✓ Поля класса для сохраняемых свойств
• ✓ Геттеры и сеттеры (для JPA спецификации)
• ✓ Не final класс (Hibernate создаёт proxies)

Рекомендации

• Используй Long для ID в большинстве случаев
• Используй @GeneratedValue(strategy = GenerationType.IDENTITY) для MySQL/PostgreSQL
• Всегда имеди конструктор без аргументов
• Используй @Column для явного определения колонок
• Используй @Transient для полей, которые не нужно сохранять