آپ کسی GraphQL API کو cache کیسے کرتے ہیں؟

Question

IT Interview Practice · Accepted Answer

GraphQL کو cache کرنا REST سے مشکل ہے کیونکہ یہاں ایک ہی endpoint ہوتا ہے اور requests عموماً POST ہوتی ہیں، اس لیے URL پر مبنی HTTP caching بغیر اضافی محنت کے کام نہیں کرتی۔ اس کے بجائے آپ تین تہوں پر cache کرتے ہیں: **client**، **transport/CDN**، اور **server**۔

## Normalized client cache

Apollo Client اور Relay نتائج کو ایک **normalized cache** میں `__typename` + `id` کے حساب سے محفوظ کرتے ہیں۔ ہر object ایک بار محفوظ ہوتا ہے؛ مختلف queries جو اسی `User:1` کا حوالہ دیتی ہیں اسے شیئر کرتی ہیں، اس لیے ایک mutation جو ایک entity کو update کرے وہ خودکار طور پر ہر view کو refresh کر دیتی ہے۔

```graphql
# Both queries write to the same normalized entry User:1 in the client cache
query A { user(id: "1") { id name } }
query B { post(id: "9") { author { id name } } }  # author is also User:1
```

اسی لیے fields کو `id` واپس کرنا چاہیے — cache کو deduplicate کرنے کے لیے ایک مستحکم key درکار ہوتی ہے۔

## Persisted queries + CDN

**Persisted queries** query string کو ایک hash سے بدل دیتی ہیں۔ Client لمبی POST body کے بجائے ایک مختصر hash بھیجتا ہے؛ server رجسٹرڈ query کو تلاش کر لیتا ہے۔

```js
// Automatic Persisted Queries: first a tiny GET with just the hash
// GET /graphql?extensions={"persistedQuery":{"sha256Hash":"abc..."}}
// -> because it's a GET with a stable key, a CDN can cache the RESPONSE at the edge
```

read queries کو cacheable GETs میں بدلنا ایک **CDN** کو انہیں edge پر serve کرنے دیتا ہے، اور payloads کو چھوٹا کرتا ہے۔ `@cacheControl` hints (max-age، scope) server کو per-field TTLs کا اعلان کرنے دیتی ہیں جن کا CDN اور Apollo server cache احترام کرتے ہیں۔

## Server-side

ایک response cache (مثلاً Apollo کا) جو query + variables + auth scope کے حساب سے keyed ہو، resolvers کو دوبارہ چلانے سے بچاتا ہے؛ DataLoader per-request de-duplication سنبھالتا ہے (یہ ایک الگ معاملہ ہے — یہ cross-request cache نہیں ہے)۔

## یہ کیوں اہم ہے

single-endpoint/POST ڈیزائن naive HTTP caching کو توڑ دیتا ہے، اس لیے interviewers **تہہ دار (layered)** جواب سننا چاہتے ہیں: client پر normalized entity cache، CDN/edge caching کو کھولنے کے لیے persisted queries + `@cacheControl`، اور DataLoader کہاں فٹ ہوتا ہے (per-request، cross-request نہیں)۔

Normalized client cache

Persisted queries + CDN

Server-side

یہ کیوں اہم ہے

متعلقہ سوالات