垃圾回收和缓存驱逐

Apollo 客户端 3 允许您选择移除不再有用的缓存数据。默认垃圾回收策略的 gc 方法适用于大多数应用程序，但 evict 方法为需要更精细控制的提供了更多的控制。

cache.gc()

该方法从标准化的缓存中移除所有不可达的对象：

1
cache.gc();

为了确定一个对象是否可行，缓存从所有已知的根对象（通常为Query和/或Mutation）开始，并使用跟踪策略递归访问所有可用的子引用。在过程中未访问的任何标准化对象将被移除。该方法cache.gc()返回被移除对象的ID列表。

除了修剪你的GraphQL数据外，cache.gc还可以释放缓存为保留之前缓存结果中未更改部分而使用的内存：

1
cache.gc({ resetResultCache: true })

暂时释放此内存会减慢缓存读取，因为这些读取没有从任何以前的读取工作中受益。

如果您正在使用canonizeResults: true选项，cache.gc还可以重置用于查找规范结果对象的内存：

1
cache.gc({
2
  resetResultCache: true,
3
  resetResultIdentities: true,
4
})

这些额外的cache.gc选项对于调查内存使用模式或泄漏非常有用。在获取堆快照或记录分配时间线之前，使用浏览器的开发工具强制进行JavaScript垃圾回收是一个好主意，以确保缓存释放的内存已完全收集并返回到堆中。

配置垃圾回收

您可以使用retain方法防止对象（及其子对象）被垃圾回收，即使对象不可达：

1
cache.retain('my-object-id');

如果您以后想使一个保留的对象进行垃圾回收，请使用release方法：

1
cache.release('my-object-id');

如果对象不可达，它将在下一次调用gc时被垃圾回收。

cache.evict()

您可以使用evict方法从缓存中移除任何标准化对象：

1
cache.evict({ id: 'my-object-id' })

您还可以通过提供要删除的字段的名称来从缓存对象中删除一个单个字段：

1
cache.evict({ id: 'my-object-id', fieldName: 'yearOfFounding' });

删除对象通常会使得其他缓存对象不可达。因此，在从缓存中删除一个或多个对象后，您应调用cache.gc。

悬挂引用

当一个对象从缓存中删除时，对该对象的引用可能仍然存在于其他缓存对象中。Apollo Client默认保留这些悬挂引用，因为所引用的对象可能在稍后写回缓存。这意味着引用可能仍然有用。

您可以自定义悬挂引用的行为，通过为可能包含一个悬挂引用的任何 read 函数定义自定义函数。此函数可以在字段引用的对象缺失时执行必要的清理工作。例如，read函数可能：

• 从可用对象列表中过滤出引用对象
• 将字段的值设置为 null
• 返回特定的默认值

每个 read函数都传入一个 canRead函数，该函数有助于其检测 field当前是否包含悬挂引用。

以下代码定义了两个 read函数（一个用于 Query.ruler，另一个用于 Deity.offspring），它们都使用 canRead：

1
new InMemoryCache({
2
  typePolicies: {
3
    Query: {
4
      fields: {
5
        ruler(existingRuler, { canRead, toReference }) {
6
          // If there is no existing ruler, Apollo becomes the ruling deity
7
          return canRead(existingRuler) ? existingRuler : toReference({
8
            __typename: "Deity",
9
            name: "Apollo",
10
          });
11
        },
12
      },
13
    },
14

15
    Deity: {
16
      keyFields: ["name"],
17
      fields: {
18
        offspring(existingOffspring: Reference[], { canRead }) {
19
          // Filter out any dangling references left over from removing
20
          // offspring, supplying a default empty array if there are no
21
          // offspring left.
22
          return existingOffspring
23
            ? existingOffspring.filter(canRead)
24
            : [];
25
        },
26
      },
27
    },
28
  },
29
})

• 如果现有的 ruler已被罢黜，则 Query.ruler的 read函数将返回默认的统治者（Apollo）。
• 如果现有的 ruler已被罢黜，则 Query.ruler的 read函数将返回默认的统治者（Apollo）。

从缓存列表字段中过滤出悬挂引用（如上面的 Deity.offspring示例所示）非常常见，因此列字段默认的 read函数会自动执行此过滤。您可以定义一个自定义 read函数来覆盖此行为。

对于包含单个悬挂引用的字段（如上面的 Query.ruler示例所示），没有类似常见的解决方案，因此编写自定义 read函数最常用到此。