Что такое Querydsl?

QueryDSL

QueryDSL — это фреймворк для построения типобезопасных SQL запросов программным образом на Java. Вместо написания строк SQL или HQL, разработчик использует fluent API для создания запросов, которые проверяются на этапе компиляции. Это мощный инструмент для построения динамических и сложных запросов.

Проблема, которую решает QueryDSL

Без QueryDSL - HQL строки:

// Неудобно и подвержено ошибкам
@Service
public class UserService {
    private final EntityManager em;
    
    public List<User> findUsers(String name, Integer minAge) {
        // Строка HQL - нет проверки на компиляции
        String hql = "SELECT u FROM User u WHERE u.name = :name AND u.age >= :minAge";
        
        return em.createQuery(hql, User.class)
            .setParameter("name", name)
            .setParameter("minAge", minAge)
            .getResultList();
    }
    
    // Типовые проблемы:
    // 1. Опечатка в названии поля: u.nam (не ловится на компиляции)
    // 2. Опечатка в параметре: :names вместо :name
    // 3. N+1 problem при забывчивости про JOIN
    // 4. Сложно добавлять условия динамически
}

С QueryDSL - типобезопасный API:

// Все проверяется на этапе компиляции
@Service
public class UserService {
    private final JPAQueryFactory queryFactory;
    
    public List<User> findUsers(String name, Integer minAge) {
        QUser qUser = QUser.user; // Сгенерированный Q-класс
        
        return queryFactory
            .selectFrom(qUser)
            .where(
                qUser.name.eq(name),
                qUser.age.goe(minAge) // goe = greater or equal
            )
            .fetch();
    }
}

Как работает QueryDSL

Шаг 1: Генерация Q-классов

QueryDSL использует annotation processor для генерации "Query" классов (Q-классов):

// Ваш класс сущности
@Entity
@Table(name = "users")
public class User {
    @Id
    private UUID id;
    
    @Column(name = "name")
    private String name;
    
    @Column(name = "email")
    private String email;
    
    @Column(name = "age")
    private Integer age;
    
    @ManyToOne
    @JoinColumn(name = "department_id")
    private Department department;
}

// QueryDSL автоматически генерирует Q-класс:
// QUser.java (сгенерированный)
public class QUser extends EntityPathBase<User> {
    public static final QUser user = new QUser("user");
    
    public final StringPath name = createString("name");
    public final StringPath email = createString("email");
    public final NumberPath<Integer> age = createNumber("age", Integer.class);
    public final EntityPathBase<Department> department = createEntity("department", Department.class);
}

Конфигурация в pom.xml

<dependencies>
    <!-- QueryDSL Core -->
    <dependency>
        <groupId>com.querydsl</groupId>
        <artifactId>querydsl-core</artifactId>
        <version>5.0.0</version>
    </dependency>
    
    <!-- QueryDSL для JPA -->
    <dependency>
        <groupId>com.querydsl</groupId>
        <artifactId>querydsl-jpa</artifactId>
        <version>5.0.0</version>
    </dependency>
    
    <!-- QueryDSL SQL для raw SQL -->
    <dependency>
        <groupId>com.querydsl</groupId>
        <artifactId>querydsl-sql</artifactId>
        <version>5.0.0</version>
    </dependency>
</dependencies>

<build>
    <plugins>
        <!-- Генерация Q-классов -->
        <plugin>
            <groupId>com.mysema.maven</groupId>
            <artifactId>apt-maven-plugin</artifactId>
            <version>1.1.3</version>
            <executions>
                <execution>
                    <goals>
                        <goal>process</goal>
                    </goals>
                    <configuration>
                        <outputDirectory>target/generated-sources/java</outputDirectory>
                        <processor>com.querydsl.apt.jpa.JPAAnnotationProcessor</processor>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

Примеры использования QueryDSL

1. Простые WHERE условия

@Repository
public class UserQueryRepository {
    private final JPAQueryFactory queryFactory;
    
    public List<User> findByName(String name) {
        QUser qUser = QUser.user;
        return queryFactory
            .selectFrom(qUser)
            .where(qUser.name.eq(name))
            .fetch();
    }
    
    public List<User> findAdults() {
        QUser qUser = QUser.user;
        return queryFactory
            .selectFrom(qUser)
            .where(qUser.age.goe(18)) // greater or equal
            .fetch();
    }
    
    public List<User> findByEmailDomain(String domain) {
        QUser qUser = QUser.user;
        return queryFactory
            .selectFrom(qUser)
            .where(qUser.email.endsWith(domain))
            .fetch();
    }
}

2. Динамические WHERE условия

public List<User> findUsers(String name, Integer minAge, String department) {
    QUser qUser = QUser.user;
    
    BooleanBuilder whereClause = new BooleanBuilder();
    
    if (name != null && !name.isEmpty()) {
        whereClause.and(qUser.name.like(name + "%"));
    }
    
    if (minAge != null) {
        whereClause.and(qUser.age.goe(minAge));
    }
    
    if (department != null && !department.isEmpty()) {
        whereClause.and(qUser.department.name.eq(department));
    }
    
    return queryFactory
        .selectFrom(qUser)
        .where(whereClause)
        .fetch();
}

3. JOINы и связанные сущности

public List<User> findUsersWithDepartment(String deptName) {
    QUser qUser = QUser.user;
    QDepartment qDept = QDepartment.department;
    
    return queryFactory
        .selectFrom(qUser)
        .join(qUser.department, qDept)
        .where(qDept.name.eq(deptName))
        .fetch();
}

// LEFT JOIN для опциональных отношений
public List<User> findUsersWithOptionalDepartment() {
    QUser qUser = QUser.user;
    QDepartment qDept = QDepartment.department;
    
    return queryFactory
        .selectFrom(qUser)
        .leftJoin(qUser.department, qDept)
        .fetch();
}

4. Агрегация и GROUP BY

public List<Tuple> getUserCountByDepartment() {
    QUser qUser = QUser.user;
    QDepartment qDept = QDepartment.department;
    
    return queryFactory
        .select(qDept.name, qUser.count())
        .from(qUser)
        .join(qUser.department, qDept)
        .groupBy(qDept.name)
        .fetch();
}

// Обработка результатов
for (Tuple tuple : results) {
    String departmentName = tuple.get(qDept.name);
    Long userCount = tuple.get(qUser.count());
    System.out.println(departmentName + ": " + userCount + " users");
}

5. Сортировка и Pagination

public Page<User> findUsersPageable(String searchTerm, Pageable pageable) {
    QUser qUser = QUser.user;
    
    List<User> content = queryFactory
        .selectFrom(qUser)
        .where(qUser.name.like("% " + searchTerm + "%"))
        .orderBy(qUser.name.asc())
        .offset(pageable.getOffset())
        .limit(pageable.getPageSize())
        .fetch();
    
    long total = queryFactory
        .select(qUser.count())
        .from(qUser)
        .where(qUser.name.like("%" + searchTerm + "%"))
        .fetchOne();
    
    return new PageImpl<>(content, pageable, total);
}

6. Сложные условия

public List<User> findComplexUsers(Integer minAge, Integer maxAge, 
                                   String namePattern, 
                                   List<String> departments) {
    QUser qUser = QUser.user;
    QDepartment qDept = QDepartment.department;
    
    return queryFactory
        .selectFrom(qUser)
        .join(qUser.department, qDept)
        .where(
            // AND условия
            qUser.age.between(minAge, maxAge),
            qUser.name.like(namePattern),
            // OR условия
            qDept.name.in(departments)
                .or(qUser.isAdmin.isTrue())
        )
        .distinct()
        .fetch();
}

QueryDSL vs Hibernate Criteria API

QueryDSL с Spring Data

// Spring Data QueryDSL расширение
public interface UserRepository extends JpaRepository<User, UUID>, QuerydslPredicateExecutor<User> {
}

// Использование
@Service
public class UserService {
    private final UserRepository userRepository;
    
    public List<User> search(String name, Integer minAge) {
        QUser qUser = QUser.user;
        
        Predicate predicate = qUser.name.like(name)
            .and(qUser.age.goe(minAge));
        
        return (List<User>) userRepository.findAll(predicate);
    }
}

Преимущества QueryDSL

1. Типобезопасность - ошибки ловятся на компиляции
2. IDE поддержка - автодополнение работает идеально
3. Легко рефакторить - если переименуешь поле в сущности, IDE подскажет ошибку
4. Динамические запросы - BooleanBuilder делает это простым
5. Читаемость - fluent API очень читаемый
6. Производительность - такая же как raw SQL

Недостатки QueryDSL

1. Генерация Q-классов - нужна конфигурация Maven/Gradle
2. Complexity - для простых запросов может быть overkill
3. Learning curve - нужно изучить API

Когда использовать QueryDSL

✓ Сложные динамические запросы ✓ Большие проекты с высокими требованиями к качеству ✓ Когда нужна максимальная типобезопасность ✓ Частые рефакторинги сущностей

✗ Простые CRUD операции ✗ Быстрые прототипы ✗ Маленькие проекты

Заключение

QueryDSL — это мощный инструмент для построения типобезопасных, динамических SQL запросов. Для разработчика, работающего с complexity запросами и большими проектами, это invaluable инструмент, который значительно снижает количество ошибок и облегчает рефакторинг.