Как используется ID в EntityManager

# Использование ID в EntityManager

ID (первичный ключ) играет ключевую роль в работе EntityManager и JPA. Он необходим для идентификации сущностей, отслеживания изменений и управления их состоянием в контексте persistence.

Основная роль ID

EntityManager использует ID для следующих операций:

1. Поиск сущности — по ID можно быстро получить объект из БД
2. Отслеживание состояния — узнать, управляется ли сущность контекстом
3. Обновление данных — знать, какую запись в БД изменять
4. Удаление сущности — по ID можно удалить запись
5. Кеширование — Identity Map использует ID для кеширования объектов

Аннотация @Id

Первичный ключ обозначается аннотацией @Id:

import javax.persistence.*;

@Entity
@Table(name = "users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    private String name;
    private String email;
    
    // Getters and setters
}

1. Поиск сущности по ID — find()

Это самый частый способ использования ID:

@Service
public class UserService {
    @Autowired
    private EntityManager entityManager;
    
    public User getUserById(Long id) {
        // EntityManager использует ID для поиска
        return entityManager.find(User.class, id);
    }
}

Что происходит:

1. EntityManager проверяет Identity Map (кеш) — есть ли уже такой объект?
2. Если есть — возвращает из кеша (без запроса к БД)
3. Если нет — выполняет SELECT * FROM users WHERE id = ?
4. Создает объект User и добавляет в контекст (managed state)
5. Возвращает объект

User user1 = entityManager.find(User.class, 1L);
User user2 = entityManager.find(User.class, 1L);

System.out.println(user1 == user2); // true! Один и тот же объект из кеша

2. Отслеживание состояния сущности — getReference()

Получить "ленивую" ссылку на сущность по ID, без загрузки данных:

public User getUserReference(Long id) {
    // Не выполняет SELECT
    // Возвращает прокси-объект с установленным ID
    return entityManager.getReference(User.class, id);
}

// Пример использования:
User user = entityManager.getReference(User.class, 1L);
// На этом моменте данные еще не загружены

System.out.println(user.getName()); // Здесь выполнится SELECT

3. Обновление сущности

ID используется для определения, какую запись обновлять:

public void updateUser(User user) {
    // EntityManager видит, что объект managed (ID существует)
    // При flush/commit выполнит UPDATE с условием WHERE id = ?
    user.setName("Новое имя");
    entityManager.flush();
}

SQL запрос:

UPDATE users SET name = 'Новое имя' WHERE id = 1

4. Удаление сущности

ID указывает, какую запись удалять:

public void deleteUser(User user) {
    User managed = entityManager.find(User.class, user.getId());
    entityManager.remove(managed);
    // При flush выполнится DELETE FROM users WHERE id = ?
}

5. Merge — присоединение detached сущности

Когда сущность находится вне контекста (detached), по ID она может быть снова присоединена:

@Transactional
public void updateDetachedUser(User user) {
    // user получена вне транзакции (detached)
    user.setName("Изменено");
    
    // merge использует ID для поиска managed версии
    User merged = entityManager.merge(user);
    entityManager.flush();
}

Процесс:

1. EntityManager смотрит на ID в detached объекте
2. Ищет managed версию с таким же ID
3. Копирует значения из detached в managed
4. Возвращает managed версию
5. При flush выполнит UPDATE

6. Identity Map и ID

EntityManager поддерживает Internal Identity Map — кеш объектов, индексированный по ID:

public void demonstrateIdentityMap() {
    User user1 = entityManager.find(User.class, 1L);
    User user2 = entityManager.find(User.class, 1L);
    
    // Разные переменные, но ОДИН объект в памяти
    System.out.println(user1 == user2); // true
    
    // Это работает благодаря ID
    // EntityManager отслеживает: {id: 1 -> User@12345}
}

7. Проблема: Отсутствие ID

Если сущность не имеет ID, EntityManager не может её управлять:

public class BadEntity {
    // Нет @Id!
    private String name;
}

// Ошибка: No identifier specified for entity
entityManager.find(BadEntity.class, 1L);

8. Составной первичный ключ (Composite Key)

Иногда ID состоит из нескольких полей:

@Embeddable
public class StudentCourseId implements Serializable {
    @Column(name = "student_id")
    private Long studentId;
    
    @Column(name = "course_id")
    private Long courseId;
    
    // Equals и HashCode обязательны!
}

@Entity
@Table(name = "student_courses")
public class StudentCourse {
    @EmbeddedId
    private StudentCourseId id;
    
    private Integer grade;
}

// Использование
StudentCourseId key = new StudentCourseId(1L, 2L);
StudentCourse enrollment = entityManager.find(StudentCourse.class, key);

9. Стратегии генерации ID

ID может генерироваться разными способами:

// IDENTITY — БД сама генерирует (AUTOINCREMENT)
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;

// SEQUENCE — используется sequence в БД
@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "user_seq")
@SequenceGenerator(name = "user_seq", sequenceName = "seq_user", allocationSize = 1)
private Long id;

// TABLE — генерация через вспомогательную таблицу
@Id
@GeneratedValue(strategy = GenerationType.TABLE, generator = "user_gen")
@TableGenerator(name = "user_gen", table = "id_gen", pkColumnName = "gen_name", valueColumnName = "gen_value")
private Long id;

// UUID — вручную генерируется UUID
@Id
private String id = UUID.randomUUID().toString();

10. Лучшие практики

✅ Всегда используй ID в сущностях — это обязательно для JPA

✅ Переопредели equals() и hashCode() на основе ID:

@Override
public boolean equals(Object o) {
    if (this == o) return true;
    if (o == null || getClass() != o.getClass()) return false;
    User user = (User) o;
    return Objects.equals(id, user.id);
}

@Override
public int hashCode() {
    return Objects.hash(id);
}

✅ Используй find() для поиска по ID — это самый эффективный способ

✅ Понимай состояния сущности:

• New — только создана, нет ID
• Managed — есть ID, управляется контекстом
• Detached — есть ID, не управляется контекстом
• Removed — помечена на удаление

❌ Не менял ID после создания — это может привести к несогласованности

❌ Не используй null ID для managed сущностей — ID должен быть установлен

Заключение

ID — это фундамент работы EntityManager. Он используется для идентификации, поиска, отслеживания и управления состоянием сущностей. Правильное использование ID критично для корректной работы ORM и обеспечения целостности данных.