querydsl-ktxNull-safe Kotlin Extensions for QueryDSL

Dynamic queries without BooleanBuilder or if-checks

Get Started

View on GitHub

🛡️

Null-safe by Design

All extensions return null when receiver or argument is null. Nulls propagate safely without exceptions.

⚡

Infix & Declarative

Write queries with Kotlin infix functions like path eq value and path contains text.

🔒

Type-safe & Scoped

Extensions are scoped inside QuerydslRepository. No namespace pollution, no misuse outside query context.

📄

Pagination Built-in

page(), slice(), exactSlice() with SortSpec for type-safe dynamic sorting. Count queries handled automatically.

🔧

Spring Boot Auto-configuration

Add the starter and JPAQueryFactory bean is registered automatically. GraalVM native image supported.

🔀

Case/When DSL

Type-safe CASE expressions with null-branch pruning. Searched and simple CASE both supported.

Before vs After

Before: Plain QueryDSLAfter: querydsl-ktx

kotlin

val builder = BooleanBuilder()
if (name != null) {
    builder.and(member.name.contains(name))
}
if (status != null) {
    builder.and(member.status.eq(status))
}
return queryFactory
    .selectFrom(member)
    .where(builder)
    .fetch()