Dexie.js 中如何分步构建查询语句

在使用 Dexie.js 进行 IndexedDB 操作时，开发者经常需要构建复杂的查询语句。与传统的 SQL 查询类似，有时我们需要分步构建查询条件，而不是将所有操作写在一行中。本文将详细介绍如何在 Dexie.js 中实现这一需求。

基本查询模式

Dexie.js 最常见的查询方式是链式调用，例如：

db.friends
  .where('age').above(25)
  .orderBy('name')
  .toArray()

这种写法简洁明了，但在需要动态构建查询条件时可能不够灵活。

分步构建查询

当我们需要根据运行时条件动态构建查询时，可以按照以下模式操作：

1. 首先获取基础 Collection 对象
2. 逐步添加查询条件
3. 最后执行查询

function executePaginatedQuery(
  table: Dexie.Table,
  params: {
    start: number,
    length: number,
    filter?: (x: object) => boolean,
    order: {name: string, dir: 'asc' | 'desc'}
  }
) {
  // 1. 获取基础 Collection
  let collection = table;
  
  // 2. 添加排序条件
  collection = collection.orderBy(params.order.name);
  
  // 3. 处理排序方向
  if (params.order.dir === 'desc') {
    collection = collection.reverse();
  }
  
  // 4. 添加过滤条件
  if (params.filter) {
    collection = collection.filter(params.filter);
  }
  
  // 5. 添加分页参数
  collection = collection
    .offset(params.start)
    .limit(params.length);
  
  // 6. 执行查询
  return collection.toArray();
}

注意事项

1. 执行顺序很重要：过滤条件应放在排序之前，而分页参数应放在最后。这与 SQL 查询中的 WHERE、ORDER BY 和 LIMIT 顺序类似。

2. 索引要求：使用 orderBy() 方法时，排序字段必须是已建立索引的字段。

3. 性能考虑：对于大数据集，先过滤再排序和分页可以获得更好的性能。

4. 类型安全：在 TypeScript 中使用时，可以明确指定表类型和返回类型，以获得更好的类型提示。

实际应用示例

假设我们需要实现一个带排序和分页的朋友列表查询：

async function getFriends(params) {
  const query = db.friends;
  
  // 动态添加排序
  if (params.sortField) {
    query.orderBy(params.sortField);
    if (params.sortDesc) {
      query.reverse();
    }
  }
  
  // 动态添加过滤
  if (params.ageFilter) {
    query.filter(friend => friend.age >= params.ageFilter);
  }
  
  // 添加分页
  return query
    .offset(params.page * params.pageSize)
    .limit(params.pageSize)
    .toArray();
}

通过这种分步构建的方式，我们可以更灵活地处理各种动态查询需求，使代码更易于维护和扩展。