Differences

This shows you the differences between two versions of the page.

--- tanszek:oktatas:informacios_rendszerek_integralasa:graphql_integracio [2025/02/22 16:28] – knehez
+++ tanszek:oktatas:informacios_rendszerek_integralasa:graphql_integracio [2026/03/12 13:50] (current) – knehez
@@ Line 1: / Line 1: @@
 ==== GraphQL integráció ====
+A GraphQL egy modern API-lekérdezési nyelv és futtatókörnyezet, amelyet a Facebook fejlesztett ki 2012-ben, majd 2015-ben nyílt forráskódúvá tett. A GraphQL célja, hogy rugalmasabb és hatékonyabb adatlekérdezési lehetőséget biztosítson a kliensalkalmazások számára.
+A hagyományos REST API-k esetén a kliens különböző endpointokon keresztül kér le adatokat, és gyakran előfordul, hogy több HTTP-kérésre van szükség az összes szükséges információ megszerzéséhez. Emellett a szerver által visszaadott adatszerkezet fix, így a kliens sokszor több adatot kap, mint amire valójában szüksége van.
+A GraphQL ezt a problémát úgy oldja meg, hogy a kliens pontosan megadhatja, milyen adatmezőket szeretne lekérdezni. A szerver ennek megfelelően csak a kért adatokat küldi vissza. Ez csökkenti a hálózati forgalmat és egyszerűbbé teszi az összetett adatszerkezetek lekérdezését.
+A GraphQL működésének három alapvető eleme van:
+  * **Schema** – a rendszer adatmodelljének és lekérdezési lehetőségeinek leírása. A schema határozza meg, milyen típusok, mezők és műveletek érhetők el az API-ban.
+  * **Query** – adatlekérdezésre szolgál. A kliens meghatározza, hogy milyen mezőket szeretne visszakapni.
+  * **Mutation** – adatmódosító műveletek (például létrehozás, módosítás vagy törlés).
+A GraphQL egyik fontos jellemzője, hogy általában **egyetlen endpointot** használ (például `/graphql`). A különböző műveleteket nem az URL-ek, hanem a lekérdezések szerkezete határozza meg.
+A GraphQL különösen előnyös olyan rendszerekben, ahol:
+  * a kliensalkalmazások különböző adatszerkezeteket igényelnek,
+  * összetett, egymáshoz kapcsolódó adatok lekérdezése szükséges,
+  * fontos a hálózati forgalom minimalizálása.
+Ugyanakkor a GraphQL implementációja általában összetettebb, mint egy hagyományos REST API, és a gyorsítótárazás vagy a jogosultságkezelés megvalósítása is több tervezést igényel.
+Az alábbi részben bemutatjuk a GraphQL alapvető jellemzőit, valamint egy egyszerű Python alapú GraphQL API implementációját FastAPI és Strawberry könyvtárak segítségével.
+Főbb tulajdonságok összehasonlítása a RESTAPI-val.
+Hivatalos dokumentáció:
+https://graphql.org/learn/
 |         | **REST API** | **GraphQL** |
@@ Line 14: / Line 46: @@
 | **Alkalmazási körök** | Egyszerű CRUD API-khoz ideális | Összetett, dinamikus kliensigényekhez jobb választás |
+Python virtuális környezet kialakítás után az alábbi sorral telepíthetjük a függőségeket:
 <code>
 pip install fastapi strawberry-graphql uvicorn
 </code>
+Mintapélda az első használathoz:
 <sxh python>
@@ Line 68: / Line 103: @@
 </code>
-Majd nyisd meg a GraphQL Playground-ot a következő URL-en:
+A GraphQL Playground a következő URL-en elérhető lesz:
 👉 http://127.0.0.1:8000/graphql
+----
+===== Mintafeladat: Könyvtári rendszer GraphQL-lel =====
+==== Feladat leírása ====
+Készítsünk egy egyszerű GraphQL API-t, amely egy könyvtár adatait kezeli. A rendszer tárolja a könyveket és a szerzőket, valamint lehetőséget ad új könyv felvitelére.
+==== Követelmények ====
+A GraphQL séma tartalmazza az alábbi típusokat:
+  * **Author**:
+    * `id` (Int)
+    * `name` (String)
+  * **Book**:
+    * `id` (Int)
+    * `title` (String)
+    * `author` (Author)
+    * `year` (Int)
+==== Implementálandó funkciók ====
+  * **Lekérdezés:**
+    * Az összes könyv lekérdezése (cím, szerző neve, év)
+    * Egy szerző könyveinek lekérdezése név alapján
+  * **Mutáció:**
+    * Új könyv hozzáadása a következő adatokkal: cím, szerző ID, év
+==== Példa lekérdezés ====
+<code javascript>
+query {
+  books {
+    title
+    author {
+      name
+    }
+    year
+  }
+}
+</code>
+==== Példa mutáció ====
+<code javascript>
+mutation {
+  addBook(title: "1984", authorId: 1, year: 1949) {
+    id
+    title
+    author {
+      name
+    }
+  }
+}
+</code>
+==== Technikai követelmények ====
+  * Használj **FastAPI** + **Strawberry GraphQL** könyvtárakat
+  * Tárolásra használj beépített listákat (pl. `authors`, `books`)
+  * A GraphQL endpoint legyen elérhető a `http://127.0.0.1:8000/graphql` címen
+==== Bónusz feladat ====
+  * Valósíts meg egy új mutációt: egy szerző hozzáadása név alapján
+  * Lekérdezés, amely egy évszám alapján listázza a megjelent könyveket