Cache Apollo: Penormalan dan Kemas Kini

InMemoryCache menyimpan setiap objek menggunakan kunci cache yang terdiri daripada __typename dan id: User:1, Post:42. Apabila sesuatu pertanyaan mengembalikan User dengan id "1", objek itu disimpan sekali di bawah kunci ini tanpa mengira berapa banyak pertanyaan berbeza yang menyertakannya.

Mana-mana pertanyaan seterusnya yang mendapatkan User:1 yang sama membaca daripada satu entri cache itu, memastikan semua komponen melihat data yang sama.

Apabila mutasi mengembalikan objek User:1 yang dikemas kini, Apollo menulisnya ke entri cache User:1. Setiap pertanyaan aktif yang menyertakan User:1 secara automatik mencerminkan medan yang dikemas kini dalam antara muka pengguna tanpa kod tambahan.

Penyebaran automatik ini ialah kelebihan utama cache ternormalisasi berbanding cache dokumen (berkunci pertanyaan).

Baca hasil semasa yang dicache bagi sesuatu pertanyaan: cache.readQuery({ query: GET_USERS }) mengembalikan objek data seolah-olah useQuery telah mengembalikannya. Mengembalikan null jika pertanyaan itu tiada dalam cache.

Gunakan readQuery dalam fungsi kemas kini mutasi untuk membaca senarai semasa sebelum mengubah suainya.

cache.writeQuery({ query: GET_USERS, data: { users: updatedUsers } }) menulis terus ke cache, lalu mencetuskan pemaparan semula dalam semua komponen yang membaca GET_USERS. Tiada permintaan rangkaian dibuat.

Gabungkan readQuery dan writeQuery untuk melaksanakan kemas kini cache yang tidak boleh diubah suai: baca, hasilkan tatasusunan baharu, kemudian tulis semula.

cache.modify({ id: cache.identify(user), fields: { name: () => 'New Name' } }) mengubah suai medan entiti tertentu yang dicache secara langsung. Anda tidak perlu membaca pertanyaan terlebih dahulu apabila mengetahui ID cache entiti itu.

Objek medan memetakan nama medan kepada fungsi pengubah yang menerima nilai semasa dan mengembalikan nilai baharu.

Hantar fungsi kemas kini kepada useMutation: useMutation(ADD_POST, { update(cache, { data: { addPost } }) { cache.modify({ id: cache.identify(user), fields: { posts: existingPosts => [...existingPosts, addPost] } }); } }).

Ini menambahkan kiriman baharu pada tatasusunan kiriman pengguna yang dicache, lalu mengemas kini semua komponen yang memaparkan senarai kiriman pengguna.

cache.evict({ id: 'User:1' }) mengalih keluar entri User:1 daripada cache. Mana-mana pertanyaan aktif yang menyertakan User:1 akan dipaparkan semula tanpa entiti itu dalam hasilnya.

Selepas mengalih keluar entri, panggil cache.gc() untuk mengalih keluar objek yang kini tidak boleh dicapai daripada pertanyaan akar. Ini mencegah kebocoran memori dalam aplikasi yang berjalan lama.

cache.gc() merentasi graf cache bermula daripada semua pertanyaan aktif dan mengalih keluar mana-mana entiti yang tidak lagi boleh dicapai. Ia selamat dipanggil secara berkala atau selepas mutasi kelompok yang memadamkan banyak entiti.

Entiti yang dirujuk oleh cangkuk useQuery aktif tidak pernah dikutip oleh pengutipan sampah; hanya entiti yatim yang tidak lagi menjadi sebahagian daripada mana-mana hasil pertanyaan akan dikutip.

Jika anda menyoal entiti tunggal (GET_USER mengikut id) yang sudah dicache sebagai sebahagian daripada pertanyaan senarai, Apollo boleh membacanya daripada cache tanpa perjalanan pergi balik rangkaian menggunakan dasar medan: keyArgs dan fungsi read dalam dasar jenis.

Fungsi read mengembalikan rujukan cache: return toReference({ __typename: 'User', id: args.id }), yang memberitahu Apollo supaya membaca daripada entri cache User:id yang sedia ada.

Jika entiti anda menggunakan medan selain id sebagai kunci uniknya (contohnya slug atau uuid), konfigurasikannya dalam dasar jenis: new InMemoryCache({ typePolicies: { Post: { keyFields: ['slug'] } } }).

Apollo kemudiannya menggunakan Post:my-post-slug sebagai kunci cache dan tidak memerlukan medan id, sekali gus mengekalkan normalisasi untuk skema bukan standard.

refetchQueries: [{ query: GET_USERS }] dalam pilihan useMutation mencetuskan pengambilan semula melalui rangkaian selepas mutasi selesai. Kaedah ini lebih mudah tetapi sentiasa membuat permintaan rangkaian.

Fungsi kemas kini mengubah suai cache secara setempat dan mengelakkan perjalanan pergi balik rangkaian. Gunakan refetchQueries apabila logik kemas kini cache terlalu rumit untuk ditulis atau apabila medan yang dikira pelayan menjadikan kemas kini cache setempat tidak boleh dipercayai.

InMemoryCache menormalkan entiti berdasarkan __typename+id, sekali gus membolehkan kemas kini automatik merentas pertanyaan. Baca dan tulis cache dengan cache.readQuery, cache.writeQuery, dan cache.modify. Alih keluar entiti dengan cache.evict diikuti cache.gc. Konfigurasikan medan kunci tersuai melalui typePolicies untuk kunci utama bukan id.

Gunakan fungsi kemas kini mutasi untuk kecekapan cache setempat; gunakan refetchQueries apabila medan yang dikira pelayan menjadikan kemas kini setempat tidak boleh dipercayai.