使用 QueryDSL 进行动态查询:QueryBase 类及其常用方法


文章目录
  • 使用 QueryDSL 进行动态查询:`QueryBase` 类及其常用方法
  • 常用方法概述
  • 1. select
  • 2. from
  • 3. where
  • 4. join / leftJoin / rightJoin / innerJoin
  • 5. groupBy
  • 6. having
  • 7. orderBy
  • 8. limit
  • 9. offset
  • 10. fetch / fetchOne / fetchFirst / fetchResults / fetchCount
  • 综合案例
  • 案例一:查询所有活跃的用户
  • 案例二:计算每个产品类别的平均价格
  • 案例三:分页查询订单记录
  • 总结



在现代应用开发中,构建动态查询是一个常见的需求。QueryDSL 是一个功能强大的库,它允许开发者使用类型安全的方式来构建动态查询。在 QueryDSL 中,

QueryBase 是一个重要的抽象基类,它提供了基本的查询功能。本文将介绍

QueryBase 及其子类的常用方法,并通过三个综合案例来展示如何在实际项目中使用这些方法。

常用方法概述

1. select

select 方法用于指定查询中要选择的字段或表达式。

query.select(QEntity.entity.field);
  • 1.



2. from

from 方法用于指定查询的数据来源,通常是一个或多个表或实体。

query.from(QEntity.entity);
  • 1.



3. where

where 方法用于添加查询的条件。

query.where(QEntity.entity.field.eq(value));
  • 1.



4. join / leftJoin / rightJoin / innerJoin

这些方法用于在查询中执行连接操作。

query.leftJoin(QEntity.entity.relatedEntity);
  • 1.



5. groupBy

groupBy 方法用于对查询结果进行分组。

query.groupBy(QEntity.entity.groupField);
  • 1.



6. having

having 方法用于在分组后的结果上设置条件。

query.having(QEntity.entity.aggregateField.gt(value));
  • 1.



7. orderBy

orderBy 方法用于对查询结果进行排序。

query.orderBy(QEntity.entity.field.asc());
  • 1.
8. limit

limit 方法用于限制查询结果的数量。

query.limit(10);
  • 1.



9. offset

offset 方法用于跳过查询结果的前几条记录。

query.offset(5);
  • 1.



10. fetch / fetchOne / fetchFirst / fetchResults / fetchCount

这些方法用于执行查询并获取结果。

List<Entity> results = query.fetch();
  • 1.



综合案例

案例一:查询所有活跃的用户

假设我们有一个用户实体 User,我们希望查询所有活跃的用户,并按注册日期排序。以下是代码示例:

// 创建一个新的 JPAQuery 对象,传入实体管理器
JPAQuery<User> query = new JPAQuery<>(entityManager);

// 获取 QUser 实体的元数据
QUser qUser = QUser.user;

// 构建查询:选择用户实体,从用户表中查询,条件是用户状态为 "ACTIVE",按注册日期降序排序
List<User> activeUsers = query
    .select(qUser) // 选择用户实体
    .from(qUser)   // 从用户表查询
    .where(qUser.status.eq("ACTIVE")) // 条件:用户状态为 "ACTIVE"
    .orderBy(qUser.registrationDate.desc()) // 按注册日期降序排序
    .fetch(); // 执行查询并获取结果列表
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.



案例二:计算每个产品类别的平均价格

在这个案例中,我们希望计算每个产品类别的平均价格,并筛选出平均价格大于100的类别。

// 创建一个新的 JPAQuery 对象,传入实体管理器
JPAQuery<Tuple> query = new JPAQuery<>(entityManager);

// 获取 QProduct 实体的元数据
QProduct qProduct = QProduct.product;

// 构建查询:选择类别和平均价格,从产品表中查询,按类别分组,条件是平均价格大于100
List<Tuple> result = query
    .select(qProduct.category, qProduct.price.avg()) // 选择类别和平均价格
    .from(qProduct) // 从产品表查询
    .groupBy(qProduct.category) // 按类别分组
    .having(qProduct.price.avg().gt(100)) // 条件:平均价格大于100
    .fetch(); // 执行查询并获取结果列表

// 遍历结果并输出每个类别的平均价格
for (Tuple tuple : result) {
    String category = tuple.get(qProduct.category); // 获取类别
    Double avgPrice = tuple.get(qProduct.price.avg()); // 获取平均价格
    System.out.println("Category: " + category + ", Average Price: " + avgPrice);
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.



案例三:分页查询订单记录

假设我们需要分页查询订单记录,每页显示10条数据,并按订单日期排序。以下是代码示例:

// 创建一个新的 JPAQuery 对象,传入实体管理器
JPAQuery<Order> query = new JPAQuery<>(entityManager);

// 获取 QOrder 实体的元数据
QOrder qOrder = QOrder.order;

// 构建查询:选择订单实体,从订单表中查询,按订单日期降序排序,限制结果数量为10,偏移量为0(第一页)
List<Order> orders = query
    .select(qOrder) // 选择订单实体
    .from(qOrder) // 从订单表查询
    .orderBy(qOrder.orderDate.desc()) // 按订单日期降序排序
    .limit(10) // 限制结果数量为10
    .offset(0) // 偏移量为0,即第一页
    .fetch(); // 执行查询并获取结果列表
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.



总结

通过 QueryDSL 提供的这些方法,我们可以轻松地构建复杂的动态查询。无论是简单的条件查询、分组聚合,还是分页查询,QueryDSL 都能以类型安全的方式帮助我们实现。希望本文介绍的内容和案例能够帮助你更好地理解和使用 QueryDSL。