Apolloキャッシュ：正規化と更新

InMemoryCacheは、__typenameとidで構成されるキャッシュキー（User:1、Post:42）ごとに各オブジェクトを保存します。クエリがid "1" のUserを返すと、異なるクエリに何度含まれていても、このキーの下に一度だけ保存されます。

以降のクエリで同じUser:1を取得すると、単一のキャッシュエントリから読み取られるため、すべてのコンポーネントで同じデータが表示されます。

ミューテーションが更新済みのUser:1オブジェクトを返すと、ApolloはそれをUser:1のキャッシュエントリに書き込みます。User:1を含むアクティブなクエリはすべて、追加のコードなしでUIに更新されたフィールドを自動的に反映します。

この自動的な伝播が、ドキュメント（クエリキー方式）キャッシュに対する正規化キャッシュの主な利点です。

クエリの現在のキャッシュ結果を読み取ります。cache.readQuery({ query: GET_USERS })は、useQueryが返した場合と同じようにデータオブジェクトを返します。クエリがキャッシュに存在しない場合はnullを返します。

変更する前の現在のリストを読み取るには、ミューテーションのupdate関数内でreadQueryを使用します。

cache.writeQuery({ query: GET_USERS, data: { users: updatedUsers } })はキャッシュに直接書き込み、GET_USERSを読み取るすべてのコンポーネントで再レンダリングを発生させます。ネットワークリクエストは実行されません。

readQueryとwriteQueryを組み合わせると、イミュータブルなキャッシュ更新を実装できます。読み取り、新しい配列の生成、書き戻しという流れです。

cache.modify({ id: cache.identify(user), fields: { name: () => 'New Name' } })は、特定のキャッシュエンティティのフィールドを直接変更します。エンティティのキャッシュIDがわかっている場合は、先にクエリを読み取る必要はありません。

fieldsオブジェクトでは、フィールド名をモディファイア関数に対応付けます。モディファイア関数は現在の値を受け取り、新しい値を返します。

useMutationにupdate関数を渡します。useMutation(ADD_POST, { update(cache, { data: { addPost } }) { cache.modify({ id: cache.identify(user), fields: { posts: existingPosts => [...existingPosts, addPost] } }); } })。

これにより、新しい投稿がユーザーのキャッシュ済み投稿配列に追加され、ユーザーの投稿一覧を表示するすべてのコンポーネントが更新されます。

cache.evict({ id: 'User:1' })は、User:1のエントリをキャッシュから削除します。User:1を含むアクティブなクエリは、該当エンティティが結果からなくなった状態で再レンダリングされます。

エントリを削除した後は、cache.gc()を呼び出して、ルートクエリから到達できなくなったオブジェクトを削除します。これにより、長時間稼働するアプリケーションでのメモリリークを防げます。

cache.gc()は、すべてのアクティブなクエリを起点にキャッシュグラフをたどり、到達できなくなったエンティティを削除します。定期的に呼び出したり、多数のエンティティを削除する一括ミューテーションの後に呼び出したりしても安全です。

アクティブなuseQueryフックから参照されているエンティティはガベージコレクションの対象になりません。対象になるのは、どのクエリ結果にも含まれなくなった孤立エンティティだけです。

一覧クエリの一部としてすでにキャッシュされている単一エンティティ（idによるGET_USER）をクエリする場合、Apolloはtype policyのkeyArgsとread関数によるフィールドポリシーを使って、ネットワークへの往復なしにキャッシュから読み取れます。

read関数はキャッシュ参照を返します。return toReference({ __typename: 'User', id: args.id })と記述することで、既存のUser:idキャッシュエントリから読み取るようApolloに指示します。

エンティティで一意なキーとしてid以外のフィールド（例：slugやuuid）を使用する場合は、type policyで設定します。new InMemoryCache({ typePolicies: { Post: { keyFields: ['slug'] } } })。

Apolloはidフィールドを必須にせず、代わりにPost:my-post-slugをキャッシュキーとして使用するため、標準以外のスキーマでも正規化を維持できます。

useMutationのオプションでrefetchQueries: [{ query: GET_USERS }]を指定すると、ミューテーションの完了後にネットワークから再取得します。より簡単ですが、必ずネットワークリクエストが発生します。

update関数はキャッシュをローカルで変更するため、ネットワークへの往復を避けられます。キャッシュ更新のロジックが複雑で記述しにくい場合や、サーバーで計算されるフィールドのためにローカルでのキャッシュ更新が信頼できない場合は、refetchQueriesを使用します。

InMemoryCacheがエンティティの保存に使用するデフォルトのキャッシュキーの形式は何ですか。

InMemoryCacheは__typename+idによってエンティティを正規化し、クエリ間の自動更新を可能にします。cache.readQuery、cache.writeQuery、cache.modifyでキャッシュを読み書きします。cache.evictでエンティティを削除した後、cache.gcを実行して不要なエンティティを回収します。id以外を主キーにする場合は、typePoliciesでカスタムキーのフィールドを設定します。

ローカルキャッシュを効率よく更新するにはミューテーションのupdate関数を使用します。サーバーで計算されるフィールドによってローカル更新が信頼できない場合は、refetchQueriesを使用します。