Queries 设计模式：提升 Angular 应用开发效率与可维护性

在 Angular 应用开发过程中，如何高效管理数据并实现流畅的用户界面，始终是开发者关注的核心议题。尤其是在处理从后端获取数据或根据用户交互动态更新的查询操作时，设计模式的选择直接决定了代码的可维护性。本文将重点介绍的 Queries 设计模式，正是为此而生。接下来，我们将深入拆解其核心逻辑，并探讨如何在 Angular 中落地实践。

什么是 Queries？核心概念与工作机制

简而言之，Queries 是一个类的属性，由 QueryService.create 工厂方法生成。其结构十分清晰：一个返回数据的函数（通常是对某个连接器的调用），再加上一个选项对象，用于定义何时重新加载、何时重置状态。

protected titleQuery: Query = this.query.create(
  () => this.userProfileConnector.getTitles(),
  {
    reloadOn: [LanguageSetEvent],
  }
);

上述代码创建了一个名为 titleQuery 的查询实例，通过 userProfileConnector.getTitles() 获取标题数据，并指定了重新加载的触发事件——LanguageSetEvent。换句话说，只要用户切换语言，数据就会自动刷新。

触发机制详解：reloadOn 与 resetOn

Queries 模式的一大亮点在于，它能够依据特定的 Observable 流或事件，自动触发数据的重新加载或重置。这两个触发条件分别由 reloadOn 和 resetOn 参数来定义，它们可以接受事件或 Observable 作为参数。每当对应的 Observable 发出新值时，相应的操作便会执行。

两者的关键区别在于：reset 会立即清除查询状态，将数据重置为 undefined；而 reload 则不会立即清除旧数据，只在加载新数据时更新状态。简单来说，reset 是“先清空再重新获取”，reload 是“后台静默更新”。

Reload 触发条件的应用场景

reload 触发条件特别适合处理语言切换、货币变更这类事件。想象一下，用户正在浏览页面，突然切换了语言——你当然不希望界面闪烁或出现加载指示器。使用 reload，查询会在后台静默加载新语言的数据，当前值仍然显示旧内容，直到 API 返回新响应，UI 才统一更新。整个过程流畅自然，用户体验极佳。

举个例子，一个多语言电商应用中，用户随时可能切换语言设置。一旦触发 LanguageSetEvent，reload 机制就会自动在后台拉取新语言的内容，用户的操作完全不受影响。

Reset 触发条件的应用场景

reset 触发条件更适合后端状态发生重大变化的场景。比如 OrderPlacedEvent 表示购物车已下单完成，当前购物车变为空。这种情况下，旧的购物车状态已经完全失效，最稳妥的做法是将其重置为 undefined，然后重新从 API 加载最新状态（很可能就是一个空购物车）。

此外，可组合的商店前端可以通过显示加载指示器来响应这种重置，让用户感知到数据正在刷新，避免困惑。

实际应用场景与代码示例

理论讲完，接下来看具体应用。假设我们正在开发一个电商应用，用户能够浏览商品、添加购物车、下单并查看详情——这正是 Queries 模式的理想应用场景。

一、产品列表查询

我们需要创建一个查询来获取产品列表，当用户浏览不同类别时自动刷新数据。

protected productListQuery: Query = this.query.create(
  () => this.productService.getProducts(),
  {
    reloadOn: [CategoryChangeEvent],
  }
);

在此示例中，一旦 CategoryChangeEvent 事件触发，产品列表便会自动重新加载，确保页面实时展示最新商品。

二、购物车查询

购物车是一个较为特殊的场景，它可能在多个事件中发生变化。使用 reset 触发条件来处理更为合适。

protected shoppingCartQuery: Query = this.query.create(
  () => this.cartService.getShoppingCart(),
  {
    resetOn: [OrderPlacedEvent, CartClearedEvent],
  }
);

当 OrderPlacedEvent 或 CartClearedEvent 发生时，购物车查询会被立即重置，状态回归 undefined，然后从 API 获取最新数据。这样用户看到的始终是最准确的购物车状态。