Какую аннотацию использовать с ID для генерации внутри базы данных?

Аннотации JPA для генерации ID внутри базы данных

Это важный вопрос о стратегиях генерации первичных ключей в JPA/Hibernate. Давайте разберёмся во всех подходах.

Основная аннотация: @GeneratedValue

import javax.persistence.*;

@Entity
@Table(name = "users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @Column(nullable = false)
    private String email;
}

Аннотация @GeneratedValue определяет стратегию генерации ID.

Стратегии генерации (@GeneratedValue)

1. GenerationType.IDENTITY — AUTO INCREMENT (ЛУЧШИЙ ВЫБОР)

Данные генерируются базой данных (при INSERT):

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    private String name;
}

// SQL в PostgreSQL/MySQL
CREATE TABLE users (
    id BIGSERIAL PRIMARY KEY,  -- AUTO_INCREMENT
    name VARCHAR(255)
);

Использование:

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;
    
    public User createUser(String name) {
        User user = new User();
        user.setName(name);
        return userRepository.save(user);  // ID генерируется БД
        // user.getId() вернёт значение из БД
    }
}

Особенности:

• ✓ Просто и надёжно
• ✓ Работает почти со всеми СУБД (MySQL, PostgreSQL, H2, SQLite)
• ✓ Не требует настройки последовательности
• ✓ Контроль за ID в БД
• ✗ При batch inserts может быть медленнее
• ✗ Сложнее масштабировать на несколько БД (шардирование)

Когда использовать:

• Стандартный выбор для большинства приложений
• Если нет специальных требований к ID

2. GenerationType.SEQUENCE — Последовательность БД

Использует SEQUENCE (рекомендуется в Oracle, PostgreSQL):

@Entity
@SequenceGenerator(
    name = "user_seq_generator",
    sequenceName = "user_seq",
    initialValue = 1,
    allocationSize = 1
)
public class User {
    @Id
    @GeneratedValue(
        strategy = GenerationType.SEQUENCE,
        generator = "user_seq_generator"
    )
    private Long id;
    
    private String name;
}

// SQL
CREATE SEQUENCE user_seq START WITH 1 INCREMENT BY 1;

Параметры @SequenceGenerator:

@SequenceGenerator(
    name = "user_seq_generator",      // имя для @GeneratedValue
    sequenceName = "user_seq",        // имя sequence в БД
    initialValue = 1,                 // начальное значение
    allocationSize = 1                // размер прироста
)

allocationSize важен для производительности:

// allocationSize = 1 — медленнее, один запрос на ID
@SequenceGenerator(name = "user_seq", allocationSize = 1)

// allocationSize = 50 — быстрее, 50 ID за раз
@SequenceGenerator(name = "user_seq", allocationSize = 50)

Когда использовать:

• В Oracle, PostgreSQL, DB2
• Когда нужна лучшая производительность с batch inserts
• Когда нужна более гибкая настройка

3. GenerationType.TABLE — Таблица для счётчика

Использует отдельную таблицу для хранения счётчика:

@Entity
@TableGenerator(
    name = "user_table_gen",
    table = "id_generator",
    pkColumnName = "entity_name",
    valueColumnName = "id_value",
    pkColumnValue = "user_id",
    initialValue = 1,
    allocationSize = 50
)
public class User {
    @Id
    @GeneratedValue(
        strategy = GenerationType.TABLE,
        generator = "user_table_gen"
    )
    private Long id;
    
    private String name;
}

// SQL — таблица должна существовать
CREATE TABLE id_generator (
    entity_name VARCHAR(100) PRIMARY KEY,
    id_value BIGINT
);

INSERT INTO id_generator (entity_name, id_value) 
VALUES ('user_id', 1);

Особенности:

• ✓ Работает со всеми СУБД
• ✓ Портативность
• ✗ Медленнее (нужно обновлять таблицу)
• ✗ Создаёт бутылочное горлышко при высокой конкурентности

Когда использовать:

• Редко, в старых проектах
• Когда нельзя использовать SEQUENCE или IDENTITY

4. GenerationType.AUTO — Автоматический выбор

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)  // Hibernate выберет сам
    private Long id;
    
    private String name;
}

Hibernate сам выбирает стратегию в зависимости от СУБД:

• PostgreSQL → SEQUENCE
• MySQL → IDENTITY
• Oracle → SEQUENCE
• H2 → TABLE

Когда использовать:

• Когда хочешь быть независимым от СУБД
• Хотя лучше явно указывать стратегию

5. GenerationType.UUID — UUID генерация

Это НЕ аннотация, а подход с UUID:

import java.util.UUID;

@Entity
public class User {
    @Id
    @Column(columnDefinition = "CHAR(36)")
    private String id;
    
    @PrePersist
    public void generateId() {
        if (this.id == null) {
            this.id = UUID.randomUUID().toString();
        }
    }
    
    private String name;
}

// Или с @GeneratedValue в Hibernate 6.2+
@Id
@GeneratedValue(strategy = GenerationType.UUID)
private UUID id;

Преимущества UUID:

• ✓ Глобально уникален
• ✓ Генерируется на клиенте (не нужна БД)
• ✓ Идеален для распределённых систем
• ✗ Больше памяти (16 байт vs 8 для Long)
• ✗ Медленнее индексирование
• ✗ Не очень читаемо

Сравнение стратегий

Практические примеры

Пример 1: Стандартное приложение (IDENTITY)

@Entity
@Table(name = "users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @Column(nullable = false, unique = true)
    private String email;
    
    private String name;
    
    @Column(name = "created_at")
    private LocalDateTime createdAt = LocalDateTime.now();
}

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

// Service
@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;
    
    public User createUser(String email, String name) {
        User user = new User();
        user.setEmail(email);
        user.setName(name);
        return userRepository.save(user);
        // ID автоматически сгенерируется БД
    }
}

Пример 2: Микросервисная архитектура (UUID)

@Entity
@Table(name = "orders")
public class Order {
    @Id
    @GeneratedValue(strategy = GenerationType.UUID)  // Hibernate 6.2+
    private UUID id;
    
    @Column(nullable = false)
    private UUID userId;  // ссылка на пользователя из другого сервиса
    
    private BigDecimal totalPrice;
    private LocalDateTime createdAt = LocalDateTime.now();
}

Почему UUID для микросервисов:

• ID генерируется внутри сервиса (не зависит от БД)
• Легко синхронизировать между системами
• Не требует координации ID

Пример 3: High-throughput система (SEQUENCE с allocationSize)

@Entity
@SequenceGenerator(
    name = "event_seq",
    sequenceName = "event_sequence",
    initialValue = 1,
    allocationSize = 100  // Важно для batch inserts
)
public class Event {
    @Id
    @GeneratedValue(
        strategy = GenerationType.SEQUENCE,
        generator = "event_seq"
    )
    private Long id;
    
    private String eventType;
    private LocalDateTime timestamp;
}

Кастомная генерация

Если стандартных не хватает, используй @GeneratedValue с custom generator:

// Custom генератор
public class PrefixedIdGenerator extends IdentifierGenerator {
    @Override
    public Serializable generate(SessionImplementor session, Object object) 
            throws HibernateException {
        String prefix = "USR_";
        Long nextId = // получаем следующий ID
        return prefix + nextId;
    }
}

// Применение
@Entity
public class User {
    @Id
    @GeneratedValue(generator = "prefixed-id-gen")
    @GenericGenerator(name = "prefixed-id-gen", strategy = 
        "com.example.PrefixedIdGenerator")
    private String id;
}

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

Выбор стратегии:

Локальное приложение
├─ Простая БД (MySQL) → @GeneratedValue(GenerationType.IDENTITY)
├─ Сложная БД (Oracle) → @GeneratedValue(GenerationType.SEQUENCE)
└─ Batch inserts → SEQUENCE с allocationSize = 50-100

Микросервисная архитектура
└─ @GeneratedValue(GenerationType.UUID)

Распределённая система
├─ Много инстансов → UUID
└─ Или Snowflake ID (собственная реализация)

Легаси код
└─ @GeneratedValue(GenerationType.TABLE) — ИЗБЕГАТЬ

Итоговые рекомендации

1. Основной выбор: @GeneratedValue(strategy = GenerationType.IDENTITY)
2. Для Oracle/PostgreSQL: GenerationType.SEQUENCE с allocationSize
3. Для микросервисов: GenerationType.UUID
4. Переносимость: GenerationType.AUTO (но явная лучше)
5. Избегать: GenerationType.TABLE

Для большинства Java приложений IDENTITY или SEQUENCE — идеальный выбор.