Si e ruan në cache një API GraphQL?

Question

IT Interview Practice · Accepted Answer

Caching-u i GraphQL është më i vështirë se REST sepse ka një endpoint të vetëm dhe kërkesat zakonisht janë POST, kështu që HTTP caching i bazuar në URL nuk funksionon menjëherë. Në vend të kësaj ruani në cache në tri shtresa: **klienti**, **transporti/CDN**, dhe **serveri**.

## Cache i normalizuar në klient

Apollo Client dhe Relay i ruajnë rezultatet në një **cache të normalizuar** të indeksuar sipas `__typename` + `id`. Çdo objekt ruhet një herë; query-t e ndryshme që referojnë të njëjtin `User:1` e ndajnë atë, kështu që një mutation që përditëson një entitet freskon çdo pamje automatikisht.

```graphql
# Të dyja query-t shkruajnë te e njëjta hyrje e normalizuar User:1 në cache-in e klientit
query A { user(id: "1") { id name } }
query B { post(id: "9") { author { id name } } }  # author është gjithashtu User:1
```

Kjo është arsyeja pse fushat duhet të kthejnë `id` — cache-i ka nevojë për një çelës të qëndrueshëm për të deduplikuar.

## Persisted queries + CDN

**Persisted queries** e zëvendësojnë string-un e query-t me një hash. Klienti dërgon një hash të shkurtër në vend të një trupi të gjatë POST; serveri kërkon query-n e regjistruar.

```js
// Automatic Persisted Queries: fillimisht një GET i vockël vetëm me hash-in
// GET /graphql?extensions={"persistedQuery":{"sha256Hash":"abc..."}}
// -> sepse është një GET me çelës të qëndrueshëm, një CDN mund të ruajë PËRGJIGJEN në edge
```

Kthimi i query-ve të leximit në GET-e të ruajtshme në cache lejon një **CDN** t'i shërbejë ato në edge, dhe zvogëlon payload-et. Udhëzimet `@cacheControl` (max-age, scope) i lejojnë serverit të deklarojë TTL-të për-fushë që CDN-ja dhe cache-i i serverit Apollo i respektojnë.

## Në anën e serverit

Një cache përgjigjeje (p.sh. i Apollo-s) i indeksuar sipas query + variables + auth scope shmang riekzekutimin e resolver-ëve; DataLoader trajton deduplikimin për-kërkesë (një çështje tjetër — nuk është cache ndër-kërkesa).

## Pse ka rëndësi

Dizajni me një endpoint të vetëm/POST prish caching-un naiv HTTP, kështu që intervistuesit duan të dëgjojnë përgjigjen **me shtresa**: cache entitetesh i normalizuar në klient, persisted queries + `@cacheControl` për të zhbllokuar caching-un CDN/edge, dhe ku futet DataLoader (për-kërkesë, jo ndër-kërkesa).

Cache i normalizuar në klient

Persisted queries + CDN

Në anën e serverit

Pse ka rëndësi

Pyetje të ngjashme