GraphQL

Příklady z praxe

1. 01

   Produktová karta v mobilní aplikaci

   Mobilní aplikace zobrazuje kartu produktu a nepotřebuje dlouhý popis, skladové pohyby ani doporučení. GraphQL dotaz vyžádá pouze název, cenu a obrázek. Server pošle menší odpověď a stejný backend může obsloužit i webovou stránku s širším dotazem.

   query ProductCard($id: ID!) {
     product(id: $id) {
       name
       price
       imageUrl
     }
   }

2. 02

   Detail objednávky přes více služeb

   Administrace potřebuje na jedné obrazovce objednávku, zákazníka, položky a stav doručení. GraphQL server může data posbírat z několika interních služeb a vrátit je jako jednu odpověď. Klient nemusí ručně skládat několik REST volání a řešit jejich pořadí.

   query OrderScreen($id: ID!) {
     order(id: $id) {
       number
       customer { name }
       items { title quantity }
       delivery { status eta }
     }
   }

Časté omyly

MýtusGraphQL je náhrada databáze.

Ve skutečnostiGraphQL není databázový systém. GraphQL server jen přijímá dotazy podle schématu a resolvery data získávají z databází, služeb, souborů nebo jiných zdrojů.

MýtusGraphQL je vždy rychlejší než REST.

Ve skutečnostiGraphQL může snížit počet volání a objem přenesených dat, ale výkon závisí na resolverech, cache a limitech dotazů. Špatně navržené GraphQL API může být pomalejší než jednoduchý REST endpoint.

Časté dotazy

Kdy dává GraphQL větší smysl než REST endpointy?

GraphQL dává největší smysl, když klienti potřebují různě tvarovaná data ze stejné domény a backend se často vyvíjí. REST bývá jednodušší pro malé služby s několika jasnými zdroji, dobře cachovatelnými URL a minimem variant odpovědí. GraphQL přidává typované schéma, introspekci a přesné dotazy, ale také vyžaduje promyšlené limity, autorizaci polí a sledování nákladnosti dotazů.

Je GraphQL totéž co HTTP endpoint?

GraphQL endpoint typicky vrací data přes HTTP ve formátu JSON, ale GraphQL samo o sobě není HTTP metoda ani síťový protokol. GraphQL popisuje dotazy, typy, validaci a vyhodnocení operací proti schématu. Přenos může být navržen různě podle serveru a klienta, i když v praxi nejčastěji potkáte jeden HTTP endpoint pro query a mutation operace.

Jak se u GraphQL řeší bezpečnost a oprávnění?

GraphQL bezpečnost stojí hlavně na serverové implementaci, ne na samotném dotazovacím jazyce. GraphQL API musí kontrolovat oprávnění u objektů i jednotlivých polí, omezovat hloubku a složitost dotazů, filtrovat introspekci podle prostředí a logovat nákladné operace. Bez těchto pravidel může flexibilní dotazování zhoršit výkon nebo nechtěně odhalit citlivé části datového modelu.

Jak se v GraphQL API zavádějí změny bez rozbití klientů?

GraphQL schema se mění přidáváním nových typů a polí, protože starší klienti si o ně sami nepožádají. GraphQL pole, které už nemá být používáno, se obvykle označí jako deprecated a ponechá se po dobu migrace. Rozbíjející změny, například přejmenování pole nebo změna typu, vyžadují koordinaci s klienty stejně jako u jiných API.

Zdroje

1. What is GraphQL?(otevře se v novém okně)Amazon Web Services
2. GraphQL(otevře se v novém okně)Wikipedia

Související pojmy

• APIAPI je smluvené rozhraní, přes které spolu dva programy komunikují, aniž by jeden musel znát vnitřní fungování druhého. Definuje, jaké operace lze volat, jaká data se posílají a co se vrátí zpět.
• JSONJSON je textový formát pro zápis strukturovaných dat, který používá objekty, pole, řetězce, čísla a literály true, false a null. Hodí se hlavně pro přenos dat mezi webovým klientem, serverem a službami, protože je čitelný pro člověka, snadno se parsuje a není vázaný na jeden programovací jazyk.
• 3D model3D model je digitální reprezentace objektu nebo prostoru ve třech rozměrech, složená z geometrie, materiálů a často i textur, animací či fyzikálních vlastností. Používá se v hrách, filmech, průmyslovém návrhu, architektuře, e-commerce i simulacích, kde software z modelu počítá zobrazení nebo další data.
• ACIDACID je sada čtyř vlastností databázové transakce: atomicity, consistency, isolation a durability. Zaručuje, že skupina zápisů proběhne jako jeden celek, neporuší definovaná pravidla databáze, nebude se nebezpečně míchat s jinými transakcemi a po potvrzení přežije pád systému, například při převodu peněz.
• Adaptive IconAdaptivní ikona je formát ikony aplikace na Androidu, který se místo jedné hotové bitmapy skládá z oddělených vrstev: pozadí a popředí. Systém výsledný tvar sám ořízne podle masky výrobce zařízení a může vrstvy animovat nebo přebarvit. Vývojář tak dodá jeden zdroj a launcher z něj vytvoří kruh, čtverec i squircle.
• Adresa v pamětiAdresa v paměti je číslo, kterým procesor jednoznačně označuje konkrétní buňku operační paměti, obvykle jeden bajt. Program pomocí adresy říká, odkud má data načíst nebo kam je zapsat. Adresy tvoří souvislý číselný rozsah, jehož velikost určuje šířka adresní sběrnice a architektura, typicky 32 nebo 64 bitů.
• AI agentAI agent je softwarový systém, který pomocí modelu umělé inteligence vnímá zadaný kontext, plánuje další kroky a samostatně volá nástroje nebo služby k dosažení cíle. Na rozdíl od jednorázového promptu udržuje stav úlohy, vyhodnocuje výsledky akcí a může opakovat postup, dokud nesplní zadání nebo nenarazí na limit.
• Alfa kanálAlfa kanál je složka obrazových dat, která u pixelu určuje míru neprůhlednosti nebo průhlednosti. Doplňuje barevné kanály, typicky RGB, a umožňuje plynulé okraje, stíny, překryvy, masky i skládání vrstev. Hodnota alfa sama neurčuje barvu, ale říká, jak se barva pixelu promíchá s pozadím.