[JPA] 고급 주제 - 예외 처리

JPA 표준 예외 처리

JPA의 표준 예외들은 javax.persistence.PersistenceException의 자식 클래스다. 그리고 이 예외 클래스는 RuntimeException의 자식이다.

JPA 표준 예외는 크게 보면 2가지로 나눌 수 있다.

• 트랜잭션 롤백을 표시하는 예외
• 트랜잭션 예외를 표시하지 않는 예외

 

트랙잭션 롤백을 표시하는 예외는 심각한 예외이므로 복구해서는 안된다. 이 예외가 발생하면 트랜잭션을 강제로 커밋해도 트랜잭션이 커밋되지 않고 대신에 javax.persistence.RollbackException 예외가 발생한다. 반면에 트랜잭션 롤백을 표시하지 않는 예외는 심각한 예외가 아니다. 따라서 개발자가 트랜잭션을 커밋할지 롤백할지를 판단한다. 

 

 

 

아래는 두 가지 분류의 예외를 표로 정리한 것이다.

 

트랜잭션 롤백을 표시하는 예외	설명
javax.persistence.EntityExistException	em.persist 호출 시 이미 같은 엔티티가 있으면 발생한다.
javax.persistence.EntityNotFoundException	em.getReference를 호출한 후 실제 사용하는 시점에 엔티티가 존재하지 않으면 발생. refresh와 lock에서도 발생한다.
javax.persistence.OptimisticLockException	낙관적 락 충돌 시 발생한다.
javax.persistence.PessimisticLockException	비관적 락 충돌 시 발생한다.
javax.persistence.RollbackException	EntityTransaction.commit() 실패 시 발생, 롤백이 표시되어 있는 트랜잭션 커밋 시에도 발생한다.
javax.persistence.TransactionRequiredException	트랜잭션이 필요할 때 트랜잭션이 없으면 발생한다. 트랜잭션 없이 엔티티를 변경할때 자주 발생한다.

 

 

트랜잭션 롤백을 표시하지 않는 예외	설명
javax.persistence.NoResultException	Query.getSingleResult() 호출 시 결과가 하나도 없을 때 발생한다.
javax.persistence.NonUniqueResultException	Query,getSingleResult() 호출 시 결과가 둘 이상이면 발생한다.
javax.persistence.LockTimeoutException	비관적 락에서 시간 초과 시 발생한다.
javax.persistence.QueryTimeoutException	쿼리 실행 시간 초과 시 발생한다.

 

 

 

---

 

스프링 프레임워크의 JPA 예외 변환

서비스 계층에서 구현 기술에 직접 의존하는 것은 좋은 설계라 할 수 없다. 이것은 예외도 마찬가지이다. 예를 들어 서비스 계층에서 JPA의 예외를 직접 사용하면 JPA에 의존하게 된다. 스프링 프레임워크는 이런 문제를 해결하기 위해서 데이터  접근 계층에 대한 예외를 추상화해서 개발자에게 제공한다. 아래는 JPA예외가 스프링 예외로 변환되는 종류를 정리한 것이다.

 

JPA 예외	스프링 변환 예외
javax.persistence.PersistenceException	org.springframework.orm.jpa.JpaSystemException
javax.persistence.NoResultException	org.springframework.dao.EmptyResultDataAcessException
javax.persistence.NonUniqueResultException	org.springframework.dao.IncorrectResultSizeDataAceessException
javax.persistence.LockTimeoutException	org.springframework.dao.CannotAcquireLockException
javax.persistence.QueryTimeoutException	org.springframework.dao.QueryTimeoutException
javax.persistence.EntityExistException	org.springframework.dao.DataIntegrityViolationException
javax.persistence.EntityNotFoundException	org.springframework.orm.jpa.JpaObjectRetrievalFailureException
javax.persistence.OptimisticLockException	org.springframework.orm.jpa.JpaOptimisticLockingFailureException
javax.persistence.PessimisticLockException	org.springframework.dao.PessimisticLockingFailureException
javax.persistence.RollbackException	org.springframework.dao.InvalidDataAceessApiUsageException
javax.persistence.TransactionRequiredException	org.springframework.transaction.TransactionSystemException

 

그리고 이렇게 JPA 예외를 스프링 프레임워크가 제공하는 추상화된 예외로 변경해주는 역할은 PersistenceExceptionTranslationPostProcessor이다. 

이것은 @Repository 어노테이션을 사용한 곳에 예외 변환 AOP를 적용해서 JPA예외를 스프링 프레임워크가 추상화한 예외로 변환해준다. 

 

 

 

---

 

만약 예외를 반환하고 싶지 않다면

throws절에 그대로 반환할 JPA 예외나 JPA 예외의 부모 클래스를 직접 명시하면 된다. 예를 들어 아래처럼 예외를 명시하면 해당 예외를 그대로 반환한다. 참고로 java.lang.Exception을 선언하면 모든 예외의 부모이므로 예외를 변환하지 않는다.

@Repository
public class NoResultExceptionTestService {

	@PersistenceContext EntityManager em;
    
    public Member findMember() throws javax.persistence.NoResultException{
    	~~~
    }
}

 

 

 

 

---

 

트랜잭션 롤백 시 주의사항

트랜잭션을 롤백하는 것은 데이터베이스의 반영사항만 롤백하는 것이지 수정한 자바 객체까지 원상태로 복구해주지는 않는다. 예를 들어 엔티티를 조회해서 수정하는 중에 문제가 있어서 트랜잭션을 롤백하면 데이터베이스의 데이터는 원래대로 복구되지만 객체는 수정된 상태로 영속성 컨텍스트에 남아있다. 따라서 트랜잭션이 롤백된 영속성 컨텍스트를 그대로 사용하는 것은 위험하다.

새로운 영속성 컨텍스트를 사용하거나 EntityManager.clear()를 호출해서 영속성 컨텍스트르르 초기화한 다음에 사용해야 한다.

스프링 프레임워크는 이런 문제를 해결하기 위해 영속성 컨텍스트의 범위에 따라 다른 방법을 사용한다.

 

기본 전략인 트랜잭션당 영속성 컨텍스트 전략은 문제가 발생하면 트랜잭션 AOP 종료 시점에 트랜잭션을 롤백하면서 영속성 컨텍스트도 함께 종료하므로 문제가 발생하지 않는다.

 

그러나 문제는 OSIV처럼 영속성 컨텍스트의 범위를 트랜잭션 범위보다 넓게 사용해서 여러 트랜잭션이 하나의 영속성 컨텍스트를 사용할 때 발생한다. 이때는 트랜잭션을 롤백해서 영속성 컨텍스트에 이상이 발생해도 다른 트랜잭션에서 해당 영속성 컨텍스트를 그대로 사용하는 문제가 있다.

스프링 프레임워크는 영속성 컨텍스트의 범위를 트랜잭션의 범위보다 넓게 설정하면 트랜잭션 롤백시 영속성 컨텍스르틀 초기화해서 잘못된 영속성 컨텍스트를 사용하는 문제를 예방한다

 

 

 

 

 

📔 Reference

[자바 ORM 표준 JPA 프로그래밍]