Mi az a GraphQL?

A GraphQL egy lekérdezési nyelv az API-khoz, és egy végrehajtási környezet ezeknek a lekérdezéseknek a végrehajtására az adataidon. Alternatívát kínál a REST-hez képest, lehetővé téve a kliens számára, hogy csak azokat az adatokat kérje, amelyekre szüksége van, egyetlen kérésben.

Fő fogalmak:

1. Séma: Meghatározza az API-ban elérhető adat típusokat, azok kapcsolatait és az elérhető műveleteket (lekérdezések, mutációk, előfizetések).
2. Lekérdezések (Queries): Az adatok olvasására szolgálnak. A kliens megadja, mely mezőkre van szüksége.
3. Mutációk (Mutations): Az adatok módosítására szolgálnak (létrehozás, frissítés, törlés).
4. Előfizetések (Subscriptions): Valós idejű adatok fogadására szolgálnak egy állandó kapcsolat révén (pl. WebSocket).

Példa egy lekérdezésre:

query GetUserData {
  user(id: "123") {
    name
    email
    posts {
      title
    }
  }
}

A kérdésre adott válasz így nézhet ki:

{
  "data": {
    "user": {
      "name": "Ivan",
      "email": "ivan@example.com",
      "posts": [
        { "title": "Az első cikkem" },
        { "title": "A GraphQL-ről" }
      ]
    }
  }
}

Előnyök a REST-hez képest:

• Adatok túlzott lekérdezésének (Over-fetching) elkerülése: A kliens csak a kért mezőket kapja.
• Adatok alullekérdezésének (Under-fetching) / Több kérés: Gyakran lehetővé teszi az összes szükséges információ egy kérésben történő megszerzését, ellentétben a REST-vel, ahol több kérésre lehet szükség különböző végpontokra.
• Erős típusosság: A séma világos dokumentációt és kérés-ellenőrzést biztosít.
• Jobb teljesítmény: Kevesebb adatátvitel.
• Rugalmasság az ügyfél oldalán: Az ügyfelek függetlenül fejlődhetnek a szervertől, kérve az adatokat szükség szerint.

Hátrányok:

• A szerver oldal konfigurációja bonyolult.
• Problémák a cache-eléssel a REST szabványos cache módszereihez képest (pl. HTTP szinten).
• A hibakezelés bonyolultabb a REST-hez képest (amely a standard HTTP státuszkódokat használja).