[241214] QueryDSL이란?

QueryDSL은 Java 기반의 타입 안전한 쿼리 작성 도구로, JPQL을 대체하거나 보완하여 더 가독성 높은 쿼리를 작성할 수 있도록 돕는다.

ORM 프레임워크인 JPA와 함께 주로 사용되며, 복잡한 동적 쿼리를 생성하는 데 유용하다.

 

   // QueryDRL을 사용하여, 동적 검색을 수행하는 메서드
    public List<Reservation> searchReservations(Long userId, Long itemId) {

        // QueryDRL에서 생성된 Q클래스 인스턴스를 선언하여 각 엔티티를 참조
        QReservation reservation = QReservation.reservation;
        QUser user = QUser.user;
        QItem item = QItem.item;

        // QueryDRL을 통해 동적 쿼리를 작성하고 실행
        return jpaQueryFactory
                .selectFrom(reservation)    // 예약데이터를 기준으로 쿼리 진행
                .leftJoin(reservation.user, user).fetchJoin() //user 데이터를 함께 로드 (fetchJoin으로 N+1 문제 방지)
                .leftJoin(reservation.item, item).fetchJoin() //item 데이터를 함께 로드 (fetchJoin으로 N+1 문제 방지)
                .where(
                        userId !=null ? reservation.user.id.eq(userId) : null,  // userId 조건 추가(존재할 경우)
                        itemId !=null ? reservation.item.id.eq(itemId) : null   // itemId 조건 추가(존재할 경우)
                )
                .fetch();

 

QueryDSL 주요 개념

1. Q 클래스

- QReservation, QUser, QItem 은 QueryDSL이 자동 생성한 클래스이다.

- 각 엔티티를 Java코드로 표현하여 쿼리 작성시 IDE의 코드 자동 완성과 타입 검사를 제공한다.

- QReservation.reservation은 Reservation 엔티티를 참조하는 Q 객체입니다.

- 필드에 접근할 때 reservation.user, reservation.id처럼 객체처럼 사용할 수 있습니다.

 

2. JPAQueryFactory

- QueryDSL의 핵심 도구로, 이를 통해 동적 쿼리를 작성하고 실행합니다.

- .selectFrom(),

         .leftJoin(),

           .where(),

             .fetch() 등의 메서드를 제공하여 쿼리를 구성합니다.

 

3. where() 조건

- 조건절을 동적으로 추가할 수 있다.

- reservation.user.id.eq(userId)는 userId와 일치하는 데이터를 필터링 한다.

- 조건을 null 체크와 함께 처리하여 동적 쿼리를 간단히 구성할 수 있다.

 

4. fetchJoin()

- JPA의 N+1 문제를 해결하기 위해 사용한다.

- 연관된 데이터를 한 번의 쿼리로 가져오며, 추가적인 데이터 로딩을 방지한다.