[QueryDSL] 8. 실전 패턴과 면접 대비

시리즈의 마지막 편이다. 지금까지 배운 내용을 종합하여 실무에서 자주 쓰는 패턴을 정리하고, 면접에서 나올 수 있는 질문을 다룬다.

검색 조건 클래스 설계

동적 쿼리 편에서 잠깐 다뤘던 검색 조건 객체를 실무 수준으로 설계한다.

record로 불변 설계

public record FeedSearchCondition(
        String title,
        String region,
        Long userId,
        Instant cursorCreatedAt,
        Long cursorId,
        int size
) {
    public FeedSearchCondition {
        if (size <= 0 || size > 100) {
            size = 20;  // 기본값과 상한선
        }
    }
}

검색 조건은 불변이어야 한다. 한번 생성된 뒤 값이 바뀌면 안 된다. record 클래스를 사용하면 불변이 보장되고, 컴팩트 생성자에서 기본값과 유효성 검증을 처리할 수 있다.

조건 메서드를 Repository에 배치

조건 메서드는 Repository 구현체의 private 메서드로 둔다.

@RequiredArgsConstructor
public class FeedRepositoryImpl implements FeedRepositoryCustom {

    private final JPAQueryFactory queryFactory;

    @Override
    public List<Feed> search(FeedSearchCondition condition) {
        return queryFactory
                .selectFrom(feed)
                .join(feed.user, user).fetchJoin()
                .where(
                        titleContains(condition.title()),
                        regionEq(condition.region()),
                        userIdEq(condition.userId()),
                        cursorCondition(condition.cursorCreatedAt(), condition.cursorId())
                )
                .orderBy(feed.createdAt.desc(), feed.id.desc())
                .limit(condition.size() + 1)
                .fetch();
    }

    private BooleanExpression titleContains(String title) {
        return title != null ? feed.title.contains(title) : null;
    }

    private BooleanExpression regionEq(String region) {
        return region != null ? feed.region.eq(region) : null;
    }

    private BooleanExpression userIdEq(Long userId) {
        return userId != null ? feed.user.id.eq(userId) : null;
    }

    private BooleanExpression cursorCondition(Instant cursorCreatedAt, Long cursorId) {
        if (cursorCreatedAt == null || cursorId == null) {
            return null;
        }
        return feed.createdAt.lt(cursorCreatedAt)
                .or(feed.createdAt.eq(cursorCreatedAt).and(feed.id.lt(cursorId)));
    }
}

limit(condition.size() + 1)에서 1을 더하는 이유는, 다음 페이지가 있는지 확인하기 위함이다. size + 1개를 가져왔으면 다음 페이지가 존재하고, 그 이하면 마지막 페이지다. 이 패턴은 QueryDSL 커서 조회 구현에서 자세히 다룬다.

커서 기반 페이지네이션 패턴

offset 페이징 대신 마지막으로 조회한 데이터의 위치를 기준으로 다음 페이지를 가져오는 방식이다.

단일 정렬 기준

정렬 기준이 유니크하면 구현이 단순하다.

private BooleanExpression cursorCondition(Long cursorId) {
    return cursorId != null ? feed.id.lt(cursorId) : null;
}

ID 내림차순 정렬에서, 마지막으로 본 ID보다 작은 것만 가져오면 된다.

복합 정렬 기준

정렬 기준이 유니크하지 않으면, 보조 정렬 기준이 필요하다. 예를 들어 createdAt 내림차순으로 정렬하는데, 같은 시간에 여러 건이 생성될 수 있다면 ID를 보조 기준으로 쓴다.

private BooleanExpression cursorCondition(Instant cursorCreatedAt, Long cursorId) {
    if (cursorCreatedAt == null || cursorId == null) {
        return null;
    }
    // createdAt이 커서보다 이전이거나,
    // createdAt이 같으면 id가 커서보다 작은 것
    return feed.createdAt.lt(cursorCreatedAt)
            .or(feed.createdAt.eq(cursorCreatedAt).and(feed.id.lt(cursorId)));
}

이 조건은 SQL의 (createdAt, id) < (cursorCreatedAt, cursorId)와 동일한 효과다. 커서 기반 페이지네이션의 설계와 구현에 대한 자세한 내용은 커서 기반 페이지네이션 시리즈를 참고한다.

동적 정렬 처리

API에서 정렬 기준을 파라미터로 받아야 할 때가 있다. Spring의 Sort나 Pageable에서 넘어온 정렬 조건을 QueryDSL의 OrderSpecifier로 변환해야 한다.

private OrderSpecifier<?>[] getOrderSpecifiers(Sort sort) {
    return sort.stream()
            .map(order -> {
                Order direction = order.isAscending() ? Order.ASC : Order.DESC;
                return switch (order.getProperty()) {
                    case "createdAt" -> new OrderSpecifier<>(direction, feed.createdAt);
                    case "title" -> new OrderSpecifier<>(direction, feed.title);
                    case "viewCount" -> new OrderSpecifier<>(direction, feed.viewCount);
                    default -> new OrderSpecifier<>(Order.DESC, feed.createdAt);
                };
            })
            .toArray(OrderSpecifier[]::new);
}

이 메서드를 orderBy에 전달한다.

queryFactory
        .selectFrom(feed)
        .orderBy(getOrderSpecifiers(pageable.getSort()))
        .offset(pageable.getOffset())
        .limit(pageable.getPageSize())
        .fetch();

면접 Q&A

---