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

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

基本查询模式

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

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

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

分步构建查询

在实际开发中，我们可能需要根据不同的条件动态构建查询。以下是一个典型的分页查询示例：

function executePaginatedQuery(table, params) {
  // 初始化查询集合
  let collection = table;
  
  // 应用排序条件
  if (params.order) {
    collection = collection.orderBy(params.order.name);
    if (params.order.dir === 'desc') {
      collection = collection.reverse();
    }
  }
  
  // 应用过滤条件
  if (params.filter) {
    collection = collection.filter(params.filter);
  }
  
  // 最后应用分页
  return collection
    .offset(params.start)
    .limit(params.length)
    .toArray();
}

关键注意事项

1. 执行顺序很重要：过滤条件应该先于分页条件应用，排序条件也应该在分页前完成。

2. 变量赋值：每次操作后需要将结果重新赋值给变量，因为每个操作都会返回一个新的 Collection 实例。

3. 索引要求：使用 orderBy() 方法时，对应的属性必须已建立索引。

实际应用示例

假设我们需要实现一个带有多重排序和过滤的分页查询：

async function getFilteredFriends(params) {
  let query = db.friends;
  
  // 动态添加过滤条件
  if (params.minAge) {
    query = query.where('age').above(params.minAge);
  }
  
  if (params.nameContains) {
    query = query.filter(friend => 
      friend.name.includes(params.nameContains)
    );
  }
  
  // 动态添加排序
  params.sorts.forEach(sort => {
    query = query.orderBy(sort.field);
    if (sort.direction === 'desc') {
      query = query.reverse();
    }
  });
  
  // 最后应用分页
  return query
    .offset(params.offset)
    .limit(params.limit)
    .toArray();
}

通过这种方式，我们可以灵活地构建复杂的查询逻辑，满足各种业务场景的需求。