自动失效

有这样一个场景，当用户点开 todo 列表中的某一项，进入 todo 详情页并对它执行了编辑，此时我们希望上一页中的 todo 列表数据也更新为编辑后的内容，通常的做法是通过事件来触发上一页的内容更新，这样增加了维护成本。而alova提供了 3 种方式，可以很优雅地达到这个目的：

1. 使用useFetcher立即重新请求最新的数据，它将在数据拉取章节中讲解；
2. 更新缓存，这种方式将在后面的缓存设置与查询章节中详细讲解；
3. 让这个响应缓存失效，当再次请求时将会因缓存失效而重新请求数据。这也是这个章节要讲解的内容。

自动失效缓存是在目标缓存中设置失效源规则，只要匹配规则都可以让目标缓存自动失效，这在很多时候省去了手动清除缓存的麻烦。

使用场景

当目标缓存与失效源是一对一或一对多时，设置自动失效规则会很方便。

设置自动失效规则

设置这个规则很简单，你可以在创建一个带缓存的 Method 实例时，为它设置hitSource参数即可。

失效源设置为 method 实例

以一个固定的 method 实例作为失效源，只要此 method 实例或它的克隆实例请求成功，目标缓存将被自动清除。

alova.Get('/todo/1', {
  // ...
  hitSource: alova.Post('/todo', {})
});

通过 method 名称匹配失效源

和 method 匹配器一样，你可以在 hitSource 中指定 method 的名称来匹配失效源，多个失效源可以设置为同一个名称，带有这个名称的 method 实例请求成功时，目标缓存将被自动清除。

const methodSubmitTodo = data =>
  alova.Post('/todo', data, {
    name: 'submitTodo'
  });

alova.Get('/todo/1', {
  // ...
  // 匹配method实例名称为submitTodo的失效源
  hitSource: 'submitTodo'
});

通过 method 名称正则表达式匹配失效源

如果 method 实例名称不固定时，你可以在 hitSource 中指定一个正则表达式来匹配 method 名称，被匹配的 method 实例在请求成功时，目标缓存将被自动清除。

const methodSubmitTodo = data =>
  alova.Post('/todo', data, {
    name: 'prefix-submitTodo'
  });

alova.Get('/todo/1', {
  // ...
  // 匹配method实例名称为prefix开头的所有实例
  hitSource: /^prefix/
});

组合设置失效源

如果你希望使用以上的多种规则匹配失效源，可以将 hitSource 指定为一个数组，数组项为以上 3 种规则的任意一种，满足数组任意一项规则的 method 实例将被匹配。

alova.Get('/todo/1', {
  // ...
  // 满足数组中任意一项匹配规则的method实例请求成功时，此缓存将失效
  hitSource: [alova.Post('/todo', {}), 'submitTodo', /^prefix/]
});

hitSource 数据类型

type hitSource = string | RegExp | Method | (string | RegExp | Method)[];