Query 对象

对于简单的查询,我们可以直接传递 Id 字段或者 Guid 字段的值获取数据,不过对于复杂查询我们通常需要构建 Query 对象,设置条件及排序等规则进行查询。

Query 对象可以作为参数传递给 Repository 数据仓库的 GetAsync、GetAllAsync 以及 ExistsAsync方法。

我们可以使用静态类 Q 快速创建 Query 对象,例如:

var query = Q.NewQuery();
if (!string.IsNullOrEmpty(keyword))
{
    query.WhereLike(`Title`, $"%{keyword}%");
}
if (!string.IsNullOrEmpty(order))
{
    query.OrderByDesc(order);
}
1
2
3
4
5
6
7
8
9

或者也可以直接设置条件快速创建 Query 对象,例如:

var query = Q.Where(Title, "标题");
1

Where 筛选

Datory 提供了许多有用的方法来使编写 Where 条件变得容易。

所有 Where 方法都带有 NOT 和 OR 运算符的重载,可以使用 OrWhereNull 来应用布尔 OR 运算符和 WhereNotNull 或 OrWhereNotNull 来否定条件。

Where 方法第一个参数是字段名,第二个参数是可选的,默认为 = 操作。

var query = Q.Where("Id", 10);
// 等同于
var query = Q.Where("Id", "=", 10);
1
2
3

我们可以采用链式操作组合多个 Where 条件,条件之间是 AND 关系:

var query = Q.Where("Score", ">", 10).WhereDate("LastActivityDate", ">=", dateTime);
1

我们可以通过 NOT 和 OR 运算符实现非及或操作:

var query = Q.WhereNot(GroupId, groupId).OrWhere("Title", "标题");
1

要将条件分组,只需将它们包装在另一个 Where 块中。

var query = Q.Where("Title", "标题").Where(q =>
    q.Where("Taxis" ">", 0).OrWhere("Count", 0)
);
1
2
3

系统将解析为以下 SQL 查询条件:

WHERE Title = '标题' AND (Taxis > 0 OR Count = 0)
1

Order 排序

可以使用 OrderBy 以及 OrderByDesc 对数据列表进行排序,例如:

var repository = new Repository<DataModel>(settingsManager.Database, settingsManager.Redis);
var query = Q.OrderBy("CreatedDate").OrderByDesc("Name");
var list = await repository.GetAllAsync(query);
1
2
3

系统将解析为以下 SQL 排序:

ORDER BY CreatedDate, Name DESC
1

数目限制

可以使用 Limit 以及 Offset 限制从数据库返回的结果数量。

var query = Q.OrderByDesc("Id").Limit(10);
1

以上代码将返回前10条数据。

var query = Q.OrderByDesc("Id").Offset(10).Limit(20);
1

以上代码将跳过前10条数据并返回后20条数据。

除了通过 Limit 以及 Offset 限制数量,我们也可以使用 ForPage 方法快速对数据进行分页:

var query = Q.OrderByDesc("Id").ForPage(page, pageSize);
1

参数 page 代表获取第几页, pageSize 代表一页返回多少行,如果不传 pageSize 参数,默认将返回15行每页,可以通过将整数作为第二个参数传递来覆盖此值。

字符串操作

Query 查询提供 WhereStarts,WhereEnds,WhereContains 和 WhereLike 方法来处理类似类型的字符串。

var query = Q.WhereLike("Title", "%中国%");
1

以上代码将查询所有标题包含 中国 的数据,和 SQL LIKE 语句一样,我们使用 WhereLike 方法时,必须手动添加通配符 %。

日期操作

Query 查询提供 WhereDate,WhereTime 和 WhereDatePart 方法来处理日期列。

var query = Q.WhereDate("CreatedDate", "2021-01-01");
1

以上代码将查询日期时间列的日期部分。