Post

JPA Native Query Dto Mapping

JPA Native Query Dto Mapping

JPA Native Query Dto Mapping

JPA Native Query

1
2
@Query(value = "SELECT u.username, u.email FROM users u WHERE u.active = true", nativeQuery = true)
List<Object[]> findActiveUsers();

이런식으로 @Query 어노테이션의 nativeQuery = true 속성을 이용해서 네이티브 쿼리를 사용할 수 있다.

Dto Mapping

하지만 조회까지는 가능하지만 해당 조회된 항목을 Dto로 매핑하는데는 어려움이 존재한다. 대부분의 예시에서는 @Entity로 정의된 클래스에 @NamedNativeQuery와 @SqlResultSetMapping을 정의하고 @Query에서 실행시킨다.
하지만 이 방법은 Entity 클래스가 지저분해지고 엔티티에 특정 repository에 종속적인 항목이 추가된다.

해당 방법을 쓰지 않으면 Object나 Obejct[] 객체로 데이터를 조회하고 해당 데이터 형태에 맞게 형변환을 해서 매핑해주는 방법을 AI가 주로 추천해준다.
이렇게 코드를 작성하면 더러워질 뿐더라 대상을 조회하는 순서가 중요해지고, 어떤 항목을 조회하는지 알기 어렵다는 단점이 있다.

그래서 사용한 방법이 조회된 데이터를 interface로 매핑하는 것이다.
위의 쿼리에서 Object[]가 아닌 아래의 인터페이스 타입으로 조회한다면 해당 인터페이스 메서드를 통해 원하는 속성을 조회할 수 있게 된다.

1
2
3
4
5
6
7
public interface UserProjection {
    String getUsername();
    String getEmail();
}

@Query(value = "SELECT u.username, u.email FROM users u WHERE u.active = true", nativeQuery = true)
List<UserProjection> findActiveUsers();

해당 기능이 가능한 이유는 인터페이스 기반 Projection 덕분인데 해당 과정이 동작하는 과정은 다음과 같다.

  • 먼저 Spring Data JPA는 네이티브 쿼리 결과를 ResultSet으로 받아온다.
  • 프로젝션 인터페이스(UserProjection)의 메서드 이름을 보고, 쿼리 결과의 컬럼 이름을 통해 값 매핑을 수행한다.
  • 런타임 시 동적으로 Proxy 객체를 생성하여, 메서드를 호출할 때 적절한 값을 반환하도록 처리한다.

해당 방법을 통해 쿼리 결과를 Dto로 쉽고 깔끔하게 매핑할 수 있게 된다.

This post is licensed under CC BY 4.0 by the author.

Trending Tags