[백엔드] QueryDSL

QueryDSL이란?

QueryDSL은 Java 애플리케이션에서 타입 세이프(Typed-Safe)한 SQL을 작성할 수 있도록 도와주는 프레임워크입니다. 주로 JPA(Java Persistence API)와 함께 사용되며, 동적 쿼리를 작성하거나 복잡한 쿼리를 생성할 때 코드의 가독성과 유지보수를 크게 향상시킵니다. SQL을 문자열로 작성하지 않고, Java 코드로 작성하여 컴파일 시점에 오류를 감지할 수 있는 것이 큰 특징입니다.

---

QueryDSL을 왜 써야 하는가?

1. 동적 쿼리의 복잡성 해결

일반적인 JPA(특히 JPQL)로 동적 쿼리를 작성하려면 코드가 복잡해지고 오류가 발생하기 쉽습니다. QueryDSL은 이를 해결하기 위해 체계적이고 직관적인 API를 제공합니다.

 

기존 JPQL 동적 쿼리 예시:

String query = "SELECT p FROM Product p WHERE p.name = :name";
if (price != null) {
    query += " AND p.price = :price";
}
TypedQuery<Product> typedQuery = entityManager.createQuery(query, Product.class);
typedQuery.setParameter("name", name);
if (price != null) {
    typedQuery.setParameter("price", price);
}

 

위 코드는 조건이 많아질수록 복잡해집니다.

 

QueryDSL 동적 쿼리 예시:

JPAQuery<Product> query = new JPAQuery<>(entityManager);
QProduct product = QProduct.product;

BooleanBuilder builder = new BooleanBuilder();
builder.and(product.name.eq(name));
if (price != null) {
    builder.and(product.price.eq(price));
}

List<Product> products = query.select(product)
                              .from(product)
                              .where(builder)
                              .fetch();

 

QueryDSL을 사용하면 동적 조건 추가가 훨씬 간단하고 가독성이 높습니다.

 

---

2. 타입 안정성

QueryDSL은 쿼리를 작성할 때 컴파일 타임에 오류를 감지합니다. 문자열 기반 JPQL은 런타임에만 오류를 감지할 수 있기 때문에, QueryDSL은 안정적인 코드를 작성하는 데 매우 유용합니다.

 

• JPQL 예시:
• String jpql = "SELECT p FROM Product p WHERE p.nam = :name";

위 오류는 실행 시점에만 확인 가능합니다.

• QueryDSL 예시:
• QProduct product = QProduct.product; query.select(product).from(product).where(product.name.eq("item"));

타입 기반이기 때문에 name 필드가 없는 경우 컴파일 시점에 오류가 발생합니다.

 

3. 코드 가독성과 재사용성

QueryDSL은 도메인 모델에 기반하여 메서드 체이닝을 사용하기 때문에 SQL 문법과 유사하게 작성 가능합니다. 복잡한 쿼리를 작성할 때도 코드를 읽기 쉽고 재사용하기 용이합니다.

 

QueryDSL 쿼리 가독성:

query.select(product)
     .from(product)
     .where(product.name.eq("item").and(product.price.gt(1000)))
     .orderBy(product.createdDate.desc())
     .fetch();

---

QueryDSL을 쓰면 좋은 점

 

• 생산성 향상
  • 쿼리 작성 시간이 줄어들고, 간결한 코드로 작업을 완료할 수 있습니다.
• 유지보수 용이
  • 코드의 가독성과 이해도가 높아지고, 조건이 추가되거나 변경될 때도 쉽게 수정할 수 있습니다.
• 런타임 오류 감소
  • 타입 세이프한 방식 덕분에 쿼리 작성 시 발생할 수 있는 오류를 컴파일 시점에 미리 확인합니다.
• 동적 쿼리 작성의 편리성
  • 조건에 따라 동적으로 SQL 구문을 생성하는 것이 매우 간단합니다.
• SQL과의 유사성
  • QueryDSL의 문법은 SQL과 유사하여 기존 SQL 지식이 있는 개발자들이 쉽게 적응할 수 있습니다.
• 다양한 데이터베이스 지원
  • JPA뿐만 아니라 MongoDB, SQL, Hibernate 등 다양한 데이터베이스 및 ORM 프레임워크와 호환됩니다.

 

---

QueryDSL과 N+1 문제

N+1 문제란?

N+1 문제는 JPA에서 연관 관계를 가진 엔티티를 조회할 때 발생합니다.
예를 들어, 부모 엔티티를 조회한 후 각 부모와 연관된 자식 엔티티를 개별 쿼리로 조회하는 경우를 말합니다.

• 1개의 부모 엔티티를 조회하는 쿼리(1)와
• N개의 자식 엔티티를 조회하기 위한 추가 쿼리(N)가 실행되어 성능 문제가 발생합니다.

 

---

N+1 문제를 해결하는 QueryDSL

QueryDSL은 조인을 명시적으로 처리할 수 있어 N+1 문제를 예방하거나 해결할 수 있습니다.

• 잘못된 N+1 발생 예시 (JPA 기본 사용):

List<Parent> parents = parentRepository.findAll();
for (Parent parent : parents) {
    System.out.println(parent.getChildren()); // 각 부모마다 자식 쿼리가 실행됨
}

 

• QueryDSL로 해결:

QParent parent = QParent.parent;
QChild child = QChild.child;

List<Parent> parents = new JPAQuery<>(entityManager)
        .select(parent)
        .from(parent)
        .leftJoin(parent.children, child).fetchJoin() // 조인을 명시적으로 수행
        .fetch();

 

• fetchJoin()을 사용하여 부모-자식 데이터를 한 번의 쿼리로 조회.
• 불필요한 추가 쿼리를 방지하고 성능을 개선합니다.

 

---

QueryDSL로 N+1 문제를 해결한 결과

1. 효율적인 데이터 조회
   필요한 데이터만 한 번에 가져와 불필요한 쿼리 실행을 방지합니다.
2. 명시적 조인 처리
   QueryDSL은 조인을 명시적으로 설정하기 때문에 데이터베이스 접근 로직을 직관적으로 이해할 수 있습니다.
3. 성능 최적화
   대규모 데이터 조회 시 성능 병목을 해결하는 데 도움을 줍니다.

 

---

결론

QueryDSL은 단순한 SQL 작성 도구를 넘어 JPA 애플리케이션의 동적 쿼리 작성과 N+1 문제 해결에 강력한 도구입니다.
특히 복잡한 쿼리를 자주 다뤄야 하거나, 대규모 데이터 처리 시 성능 문제가 중요한 프로젝트에서 QueryDSL은 코드 품질과 유지보수성을 크게 향상시킵니다.

• 타입 안전성과 가독성, 그리고 성능 최적화를 동시에 잡을 수 있는 QueryDSL은 JPA 애플리케이션의 필수적인 선택지가 될 수 있습니다.