QueryDsl 소개

QueryDsl은  자바 언어를 사용하여 타입 안전성을 제공하는 SQL과 같은 쿼리를 생성할 수 있게 해주는 프레임워크입니다. 복잡한 쿼리를 작성할 때 SQL 문자열을 직접 작성하는 대신, QueryDsl은 메서드 체인 방식을 사용하여 쿼리를 구성합니다. 이로 인해 컴파일 시점에 타입 체크가 가능해져, 쿼리 관련 버그를 사전에 방지할 수 있게 됩니다. QueryDsl은 JPA, SQL, MongoDB 등 다양한 저장소 기술에 대한 지원을 제공합니다.

 

JPQL의 한계

JPQL은 JPA의 일부로, 데이터베이스가 아닌 엔티티 객체를 대상으로 쿼리를 작성합니다. SQL과 유사한 문법을 사용하지만, 문자열 기반으로 쿼리를 작성해야 하기 때문에 여런 단점이 있습니다.

• 타입 안정성 부족 : 문자열로 쿼리를 작상하기 때문에, 오타나 잘못된 필드명으로 인한 오류를 컴파일 시점에서 발견하기 어렵습니다.
• 동적 쿼리 생성의 복잡성 : 복잡한 조건에 따라 쿼리를 동적으로 생성하려면 문자열 조작이 필요하며, 이는 코드를 복잡하게 만들고 오류를 발생시킬 수 있습니다.

 

QueryDsl의 장점

QueryDsl은 이러한 문제를 해결해줍니다. QueryDsl의 주요 장점은 다음과 같습니다.

• 타입 안정성 : 메서드 체인 방식으로 쿼리를 작성하며, 엔티티 필드르 직접 참조하기 때문에 타입 안정성이 보장됩니다.
• 동적 쿼리의 용이성 : 조건에 따라 쿼리를 유연하게 변경할 수 있으며, 코드의 가독성도 높습니다. QueryDsl은 복잡한 쿼리도 간결하게 표현할 수 있습니다.
• 풍부한 기능 지원 : QueryDsl은 다양한 쿼리 작성 기능을 지원하여, 개발자가 필요로 하는 대부분의 쿼리를 간단하고 효율적으로 작성할 수 있게 해줍니다.

 

실제 예시로 보는 차이점

회원의 이름으로 회원 정보를 조회하는 간단한 쿼리를 JPQL과 QueryDsl을 사용하여 작성해 보겠습니다.

 

JPQL 사용예시

Member member = em.createQuery(
                "select m " +
                "  from Member m " +
                " where m.username = :username" +
                "   and m.age = 10", Member.class
        )
        .setParameter("username", "member1")
        .getSingleResult();

 

QueryDsl 사용예시

String username = "member1";

Member result = queryFactory
        .selectFrom(member)
        .where(
                member.username.eq(username),
                member.age.eq(10)
        ).fetchOne();

 

위 예시에서 볼 수 있듯이  QueryDsl은 타입 안전성과 가독성 면에서 JPQL 보다 우수합니다.

중요한 점은 QueryDsl은 동적쿼리에 매우 유용합니다. 아래는 동적 쿼리 예시입니다.

 

JPQL 동적쿼리 예시

String usernameParam = "member1"; // 검색 조건
Integer ageParam = 30; // 검색 조건

StringBuilder jpql = new StringBuilder("select m from Member m where 1=1");
if (usernameParam != null) {
    jpql.append(" and m.username = :username");
}
if (ageParam != null) {
    jpql.append(" and m.age = :age");
}

Query query = entityManager.createQuery(jpql.toString());
if (usernameParam != null) {
    query.setParameter("username", usernameParam);
}
if (ageParam != null) {
    query.setParameter("age", ageParam);
}

List<Member> result = query.getResultList();

 

QueryDsl 동적쿼리 예시

@Test
void 동적_쿼리_테스트() {

    String username = "member1";

    List<Member> result = queryFactory
            .selectFrom(member)
            .where(
                    usernameEq(username)
            ).fetch();

    assertThat(result.get(0).getUsername()).isEqualTo(username);
}

private BooleanExpression usernameEq(String username) {
    return hasText(username) ? member.username.eq(username) : null;
}

 

QueryDsl의 .where 메소드는 null 값을 무시하기 때문에 조건이 null인 경우 해당 조건은 쿼리에 포함되지 않습니다. 이는 동적 쿼리를 생성할 때 매우 유용합니다. 동적 쿼리를 처리함에 있어 QueryDsl은 JPQL보다 휠씬 강력하고 유연한 접근 방식을 제공합니다. 코드의 가독성과 유지보수성이 크게 향상되며, 타입 안전성을 통해 개발 과정에서 발생할 수 있는 오류를 최소화합니다.