แคช Apollo: การทำให้เป็นมาตรฐานและการอัปเดต

InMemoryCache จัดเก็บออบเจ็กต์แต่ละรายการด้วยคีย์แคชที่ประกอบด้วย __typename และ id: User:1, Post:42 เมื่อคำค้นหาส่งคืน User ที่มี id "1" ระบบจะจัดเก็บรายการนั้นไว้เพียงครั้งเดียวภายใต้คีย์นี้ ไม่ว่าคำค้นหาที่แตกต่างกันจะมีรายการดังกล่าวอยู่กี่คำค้นหาก็ตาม

คำค้นหาใดก็ตามที่ดึงข้อมูล User:1 ในภายหลังจะอ่านข้อมูลจากรายการแคชเดียวกัน ทำให้ทุกคอมโพเนนต์เห็นข้อมูลชุดเดียวกัน

เมื่อ mutation ส่งคืนออบเจ็กต์ User:1 ที่อัปเดตแล้ว Apollo จะเขียนข้อมูลนั้นลงในรายการแคช User:1 คำค้นหาที่กำลังทำงานอยู่ทุกคำซึ่งมี User:1 จะสะท้อนฟิลด์ที่อัปเดตแล้วในส่วนติดต่อผู้ใช้โดยอัตโนมัติ โดยไม่ต้องเขียนโค้ดเพิ่มเติม

การส่งต่อข้อมูลโดยอัตโนมัตินี้เป็นข้อได้เปรียบหลักของแคชที่ทำให้ข้อมูลเป็นมาตรฐาน เมื่อเทียบกับแคชแบบเอกสาร (ที่ใช้คำค้นหาเป็นคีย์)

อ่านผลลัพธ์ปัจจุบันของคำค้นหาจากแคช: cache.readQuery({ query: GET_USERS }) จะส่งคืนออบเจ็กต์ข้อมูลเช่นเดียวกับที่ useQuery ส่งคืน หากคำค้นหาไม่มีอยู่ในแคช ระบบจะส่งคืนค่า null

ใช้ readQuery ภายในฟังก์ชันอัปเดตของ mutation เพื่ออ่านรายการปัจจุบันก่อนแก้ไข

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: 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() จะสำรวจกราฟแคชโดยเริ่มจากคำค้นหาที่กำลังทำงานอยู่ทั้งหมด แล้วลบเอนทิตีที่ไม่สามารถเข้าถึงได้อีกต่อไป สามารถเรียกใช้เป็นระยะหรือหลัง mutation แบบกลุ่มที่ลบเอนทิตีจำนวนมากได้อย่างปลอดภัย

เอนทิตีที่ถูกอ้างอิงโดยฮุก useQuery ที่กำลังทำงานอยู่จะไม่ถูกเก็บกวาด จะมีเพียงเอนทิตีที่ไม่มีเจ้าของและไม่เป็นส่วนหนึ่งของผลลัพธ์คำค้นหาใดอีกต่อไปเท่านั้นที่ถูกลบ

หากคุณค้นหาเอนทิตีเดียว (GET_USER ตาม id) ซึ่งถูกแคชไว้แล้วในคำค้นหาแบบรายการ Apollo สามารถอ่านเอนทิตีนั้นจากแคชได้โดยไม่ต้องส่งคำขอเครือข่ายรอบใหม่ โดยใช้นโยบายฟิลด์ ได้แก่ keyArgs และฟังก์ชันอ่านในนโยบายชนิดข้อมูล

ฟังก์ชันอ่านจะส่งคืนการอ้างอิงแคช: return toReference({ __typename: 'User', id: args.id }) ซึ่งบอกให้ Apollo อ่านข้อมูลจากรายการแคช User:id ที่มีอยู่แล้ว

หากเอนทิตีของคุณใช้ฟิลด์อื่นที่ไม่ใช่ id เป็นคีย์เฉพาะ (เช่น slug หรือ uuid) ให้กำหนดค่าในนโยบายชนิดข้อมูล: new InMemoryCache({ typePolicies: { Post: { keyFields: ['slug'] } } })

จากนั้น Apollo จะใช้ Post:my-post-slug เป็นคีย์แคชแทนการบังคับให้มีฟิลด์ id ซึ่งช่วยรักษาการทำข้อมูลให้เป็นมาตรฐานสำหรับสคีมาที่ใช้คีย์รูปแบบอื่น

refetchQueries: [{ query: GET_USERS }] ในตัวเลือกของ useMutation จะเรียกการดึงข้อมูลจากเครือข่ายใหม่หลัง mutation ทำงานเสร็จ วิธีนี้เรียบง่ายกว่า แต่จะส่งคำขอเครือข่ายทุกครั้ง

ฟังก์ชัน update จะแก้ไขแคชภายในเครื่องและไม่ต้องส่งคำขอเครือข่ายรอบใหม่ ให้ใช้ refetchQueries เมื่อเขียนตรรกะการอัปเดตแคชได้ซับซ้อนเกินไป หรือเมื่อฟิลด์ที่เซิร์ฟเวอร์คำนวณทำให้การอัปเดตแคชภายในเครื่องไม่น่าเชื่อถือ

รูปแบบคีย์แคชเริ่มต้นที่ InMemoryCache ใช้จัดเก็บเอนทิตีคืออะไร

InMemoryCache จะทำข้อมูลเอนทิตีให้เป็นมาตรฐานด้วย __typename+id ซึ่งทำให้เกิดการอัปเดตข้ามคำค้นหาโดยอัตโนมัติ อ่านและเขียนแคชด้วย cache.readQuery, cache.writeQuery และ cache.modify นำเอนทิตีออกด้วย cache.evict ตามด้วย cache.gc กำหนดฟิลด์คีย์แบบกำหนดเองผ่าน typePolicies สำหรับคีย์หลักที่ไม่ใช่ id

ใช้ฟังก์ชันอัปเดตของ mutation เพื่อประสิทธิภาพของแคชภายในเครื่อง และใช้ refetchQueries เมื่อฟิลด์ที่เซิร์ฟเวอร์คำนวณทำให้การอัปเดตภายในเครื่องไม่น่าเชื่อถือ