Apollo Önbelleği: Normalleştirme ve Güncellemeler

InMemoryCache her nesneyi __typename ve id'den oluşan bir önbellek anahtarıyla saklar: User:1, Post:42. Bir sorgu id'si "1" olan bir User döndürdüğünde, bu nesne kaç farklı sorguda yer alırsa alsın bu anahtar altında yalnızca bir kez saklanır.

Aynı User:1'i getiren sonraki her sorgu tek önbellek girdisinden okur; böylece tüm bileşenler aynı verileri görür.

Bir mutasyon güncellenmiş bir User:1 nesnesi döndürdüğünde Apollo bunu User:1 önbellek girdisine yazar. User:1'i içeren her etkin sorgu, ek kod gerektirmeden kullanıcı arayüzünde güncellenen alanları otomatik olarak gösterir.

Bu otomatik yayılım, normalleştirilmiş önbelleğin belge (sorgu anahtarlı) önbelleğe göre başlıca avantajıdır.

Bir sorgunun önbellekteki güncel sonucunu okuyun: cache.readQuery({ query: GET_USERS }) veriyi, useQuery döndürmüş gibi bir veri nesnesi olarak döndürür. Sorgu önbellekte yoksa null döndürür.

Bir mutasyonun update işlevlerinde, üzerinde değişiklik yapmadan önce güncel listeyi okumak için readQuery kullanın.

cache.writeQuery({ query: GET_USERS, data: { users: updatedUsers } }) doğrudan önbelleğe yazar ve GET_USERS'ı okuyan tüm bileşenlerde yeniden oluşturmayı tetikler. Ağ isteği yapılmaz.

Değişmez önbellek güncellemeleri uygulamak için readQuery ve writeQuery'yi birleştirin: okuyun, yeni bir dizi oluşturun ve yeniden yazın.

cache.modify({ id: cache.identify(user), fields: { name: () => 'New Name' } }) belirli bir önbelleğe alınmış varlığın alanlarını doğrudan değiştirir. Önbellek kimliğini biliyorsanız önce bir sorgu okumanız gerekmez.

fields nesnesi, alan adlarını geçerli değeri alan ve yeni değeri döndüren değiştirici işlevlerle eşler.

useMutation'a bir update işlevi geçirin: useMutation(ADD_POST, { update(cache, { data: { addPost } }) { cache.modify({ id: cache.identify(user), fields: { posts: existingPosts => [...existingPosts, addPost] } }); } }).

Bu işlem yeni gönderiyi kullanıcının önbelleğe alınmış gönderi dizisinin sonuna ekler ve kullanıcının gönderi listesini görüntüleyen tüm bileşenleri günceller.

cache.evict({ id: 'User:1' }) User:1 girdisini önbellekten kaldırır. User:1'i içeren etkin sorgular, bu varlık sonuçta eksik olacak şekilde yeniden oluşturulur.

Girdileri kaldırdıktan sonra, artık kök sorgulardan erişilemeyen nesneleri silmek için cache.gc() çağrısını yapın. Bu, uzun süre çalışan uygulamalarda bellek sızıntılarını önler.

cache.gc() tüm etkin sorgulardan başlayarak önbellek grafiğini dolaşır ve artık erişilemeyen varlıkları kaldırır. Düzenli aralıklarla veya çok sayıda varlığı silen toplu mutasyonlardan sonra güvenle çağrılabilir.

Etkin useQuery kancalarının başvurduğu varlıklar hiçbir zaman çöp toplanmaz; yalnızca artık hiçbir sorgu sonucunun parçası olmayan yetim varlıklar toplanır.

Bir liste sorgusunun parçası olarak zaten önbelleğe alınmış tek bir varlığı (id'ye göre GET_USER) sorgularsanız Apollo, tür politikasındaki keyArgs ve read işlevlerini kullanarak ağ üzerinden gidiş-dönüş yapmadan bu varlığı önbellekten okuyabilir.

read işlevi bir önbellek referansı döndürür: return toReference({ __typename: 'User', id: args.id }), Apollo'ya mevcut User:id önbellek girdisinden okumasını söyler.

Varlıklarınız benzersiz anahtar olarak id yerine başka bir alan (örneğin slug veya uuid) kullanıyorsa bunu tür politikasında yapılandırın: new InMemoryCache({ typePolicies: { Post: { keyFields: ['slug'] } } }).

Apollo daha sonra id alanı gerektirmek yerine önbellek anahtarı olarak Post:my-post-slug kullanır ve standart dışı şemalarda normalleştirmeyi korur.

useMutation seçeneklerindeki refetchQueries: [{ query: GET_USERS }] ifadesi, mutasyon tamamlandıktan sonra ağ üzerinden yeniden getirme işlemini tetikler. Daha basittir ancak her zaman bir ağ isteği yapar.

update işlevi önbelleği yerel olarak değiştirir ve ağ üzerinden gidiş-dönüşü önler. Önbellek güncelleme mantığını yazmak çok karmaşık olduğunda veya sunucu tarafından hesaplanan alanlar yerel önbellek güncellemelerini güvenilmez kıldığında refetchQueries kullanın.

InMemoryCache'in varlıkları depolamak için kullandığı varsayılan önbellek anahtarı biçimi nedir?

InMemoryCache, varlıkları __typename+id ile normalleştirerek sorgular arası otomatik güncellemeleri mümkün kılar. Önbelleği cache.readQuery, cache.writeQuery ve cache.modify ile okuyun veya yazın. Varlıkları cache.evict ve ardından cache.gc ile kaldırın. id dışındaki birincil anahtarlar için özel anahtar alanlarını typePolicies üzerinden yapılandırın.

Yerel önbellek verimliliği için mutasyon update işlevlerini kullanın; sunucu tarafından hesaplanan alanlar yerel güncellemeleri güvenilmez kıldığında refetchQueries kullanın.