[One Day One Question]
Spring Data JPA에서 새로운 Entity인지 판단하는 방법은?
1. @Id 필드를 기준으로 판단
- JPA는 엔티티의 @Id 필드가 null이거나 기본값일 경우, 해당 엔티티를 새로운 엔티티로 간주합니다.
- 엔티티가 영속성 컨텍스트에 존재하지 않고 @Id 필드가 null인 경우, 새로운 엔티티로 판단합니다.
public boolean isNew(Entity entity) {
return entity.getId() == null; // ID가 null이면 새로운 엔티티로 간주
}
2. Persistable 인터페이스 구현
- @Id 필드가 null이 아닌 경우에도 새로운 엔티티로 취급해야 할 상황(예: ID가 수동으로 생성되는 경우)이 있을 수 있습니다.
- 이런 경우, 엔티티 클래스에 Persistable 인터페이스를 구현하여 직접 새로운 엔티티 여부를 판단할 수 있습니다.
- 새로운 엔티티로 간주해야 할 경우, setNew(true)를 호출하여 직접 상태를 설정할 수 있습니다.
import org.springframework.data.domain.Persistable;
@Entity
public class MyEntity implements Persistable<Long> {
@Id
private Long id;
@Transient // DB에 매핑되지 않도록 함
private boolean isNew = false;
@Override
public Long getId() {
return this.id;
}
@Override
public boolean isNew() {
return isNew;
}
public void setNew(boolean isNew) {
this.isNew = isNew;
}
}
3. 엔티티 관리 여부로 판단
- EntityManager를 활용하여 특정 엔티티가 영속성 컨텍스트에 포함되어 있는지 확인하여 새로운 엔티티 여부를 판단할 수 있습니다.
@PersistenceContext
private EntityManager entityManager;
public boolean isNew(Entity entity) {
return !entityManager.contains(entity); // 영속성 컨텍스트에 없으면 새로운 엔티티
}
새로운 Entity 판단이 중요한 이유
1. 데이터베이스 작업 방식을 결정하기 위해
- JPA는 엔티티가 새로운 엔티티인지 여부에 따라 persist(INSERT)와 merge(UPDATE)를 구분하여 호출합니다.
- 새로운 엔티티인 경우: persist 호출로 데이터베이스에 새로운 레코드를 삽입.
- 기존 엔티티인 경우: merge 호출로 데이터베이스에서 해당 엔티티를 업데이트.
잘못 판단할 경우의 문제:
- 새로운 엔티티를 기존 엔티티로 잘못 판단하면 데이터가 업데이트되지 않을 수 있음.
- 기존 엔티티를 새로운 엔티티로 잘못 판단하면 데이터베이스에서 중복 레코드가 생성될 수 있음.
2. 엔티티 상태 관리
- JPA는 엔티티 상태를 비영속(Transient), 영속(Persistent), 준영속(Detached), 삭제(Removed)의 4가지 상태로 관리합니다.
- 새로운 엔티티는 기본적으로 비영속 상태에 있으며, 이를 영속성 컨텍스트에 추가하는 작업(persist)이 필요합니다.
- 새로운 엔티티를 정확히 판단하면 올바르게 영속성 컨텍스트에 등록하거나 필요한 작업을 수행할 수 있습니다.
잘못 판단할 경우의 문제:
- 엔티티가 영속화되지 않은 상태에서 저장 작업이 누락되면, 데이터가 데이터베이스에 반영되지 않음.
- 잘못된 상태로 관리되면 예기치 못한 에러(예: EntityNotFoundException)가 발생할 수 있음.
3. ID 자동 생성 전략 관리
- 새로운 엔티티인지 여부는 ID 생성 전략(@GeneratedValue)과 밀접한 관련이 있습니다.
- 새로운 엔티티임에도 불구하고 기존 엔티티로 판단하면, ID가 자동으로 생성되지 않아 예외가 발생할 수 있습니다.
잘못 판단할 경우의 문제:
- ID 충돌 또는 중복된 데이터가 발생.
- ID가 없는 엔티티를 영속화하려다 오류 발생.
4. 데이터 무결성 보장
- 새로운 엔티티와 기존 엔티티를 올바르게 구분하면, 데이터가 중복되거나 의도치 않은 값으로 덮어쓰여지는 것을 방지할 수 있습니다.
- 특히 복잡한 비즈니스 로직에서는 중복 데이터 생성은 문제를 초래할 수 있습니다.