[ Querydsl ] 프로젝션(Projections)과 결과반환 (프로퍼티접근, 필드직접접근, 생성자 사용)

프로젝션 (Projections) ?

Querydsl을 이용해 entity전체를 가져오는 것이 아니라 조회 대상을 지정해 원하는 값만 조회하는 것을 말한다.

---

기본

1. 프로젝션 대상이 하나일 때

List<String> result = queryFactory
            .select(member.username)
            .from(member)
            .fetch();

프로젝션 대상이 하나일경우 위처럼 타입을 명확하게 지정하면 된다.

2. 프로젝션 대상이 두개 이상일 경우

 List<Tuple> result = queryFactory
            .select(member.username, member.age)
            .from(member)
            .fetch();

   for (Tuple tuple : result) {
      String username = tuple.get(member.username);
      Integer age = tuple.get(member.age);
      System.out.println("username=" + username);
      System.out.println("age=" + age);
}

프로젝션 대상이 두개 이상일 경우 명확한 타입을 지정할 수 없기 때문에 튜플이나 DTO로 값을 조회할 수 있다.
하지만 튜플로 값을 가져오는 경우는 Querydsl에 종속적이고, Model 객체를 로직에서 사용하는 것과 같은 문제를 가지고 있기에 최대한 사용을 피하고 Repository에서만 사용하는 것이 좋다. 만약 Repository 바깥으로 나갈 땐 DTO로 변환하는 것을 권장한다.

---

DTO 조회

1. 순수 JPA에서 DTO 조회

 

MemberDto

package study.querydsl.dto;
import lombok.Data;
  
  @Data
  public class MemberDto {
      private String username;
      private int age;
      
      public MemberDto() {
      }
      
      public MemberDto(String username, int age) {
          this.username = username;
          this.age = age;
	}
}

 

순수 JPA에서 DTO 조회 코드

List<MemberDto> result = em.createQuery(           
			"select new study.querydsl.dto.MemberDto(m.username, m.age)" +
                  	"from Member m", MemberDto.class)
          			.getResultList();

순수 JPA에서 DTO를 조회할 때는 new 명령어를 사용하는데 이 경우 생성자 방식만 지원하며, DTO의 package이름을 다 적어줘야하기 때문에 코드가 지저분하다.

 

이를 극복하기 위해 Querydsl로 결과를 반환받는 방법을 사용한다.

---

Querydsl 빈 생성(Bean population) 

 

결과를 DTO로 반환할 때 사용하며,

1) 프로퍼티 접근  2) 필드 직접 접근 3) 생성자 사용 의 세 가지 방식이 있다.

 

 

 1. 프로퍼티 접근

List<MemberDto> result = queryFactory
          .select(Projections.bean(MemberDto.class,
                  member.username,
                  member.age))
          .from(member)
          .fetch();

Projections.bean
setter(bean)를 통해 데이터를 인젝션 해주며 기본 생성자가 무조건 필요하다.
(Constructor 만들어주거나 롬복쓰면 @NoArgsContructor 사용하세요 !)

 

 2. 필드 직접 접근 

List<MemberDto> result = queryFactory
          .select(Projections.fields(MemberDto.class,
                  member.username,
                  member.age))
          .from(member)
          .fetch();

Projections.fields
필드에 값을 딱 꽂아주기 때문에 setter와 기본생성자가 필요없습니다.

 

2-1. 별칭이 다를 때

package study.querydsl.dto;
import lombok.Data;

@Data
public class UserDto {
    private String name;
    private int age;
}

List<UserDto> fetch = queryFactory
              .select(Projections.fields(UserDto.class,
                member.username.as("name"),
                ExpressionUtils.as(
    			)
             ).from(member)
             .fetch();

프로퍼티나 필드 접근 생성 방식에서 이름이 다를 때 아래와 같은 방법으로 해결할 수 있다.

1) ExpressionUtils.as(sourse, alias) :  필드,  서브 쿼리에 별칭 적용
2) username.as("memberName") : 필드에 별칭 적용

대부분은 가독성때문에 as를 쓰는데 서브쿼리의 경우 무조건 ExpressionUtils.as 를 써야한다.

3. 생성자 사용

List<MemberDto> result = queryFactory
          .select(Projections.constructor(MemberDto.class,
                  member.username,
                  member.age))
          .from(member)
          .fetch()
 }

Projections.constructor

값을 넘길 때생성자와 순서가 맞아야 데이터를 불러오며, @AllArgsConstructor 필요, setter가 필요 없다.


생성자 방식은 @QueryProjection까지 지원해준다.

@QueryProjection 활용

List<MemberDto> result = queryFactory
          .select(new QMemberDto(member.username, member.age))
          .from(member)
          .fetch();

@QueryProjection 어노테이션을 달아주고, compileQuerydsl을 실행해주면 DTO도 Q파일로 생성을 해준다.

Contructor는 컴파일 오류를 잡지 못하고 런타임 오류가 일어나기에 유저가 코드를 실행하는 순간 문제를 발견할 수 있지만,

QueryProjection은 컴파일러로 타입을 체크할 수 있으므로 가장 안전한 방법이다.

 

하지만 DTO에 QueryDSL 어노테이션을 유지해야 하기에 QueryDSL에 종속적인 점과 DTO까지 Q파일을 생성해야 하는 단점이 있다.

 

---

 

정리

• Property: setter 사용, 기본 생성자 사용
• Field: setter 필요 없음, 기본 생성자 필요 없음, 필드와 매핑
• Constructor: @AllArgsConstructor 필요, setter 필요 없음

---

Querydsl - 레퍼런스 문서