Když stojíte před návrhem API, první otázka obvykle zní: REST, nebo GraphQL? Většina týmů sáhne po RESTu, protože ho zná, nebo po GraphQL, protože je moderní. Obě cesty ale vedou k problémům, pokud nerozumíte tomu, co přesně vaše aplikace potřebuje. Rozdíl není v tom, co je „lepší", ale v tom, co vám ušetří práci a co vám ji naopak přidá.

Nakonec si uvědomte, že licence se nedá zvolit jednou provždy. Jakmile začnete distribuovat kód, měnit licenci na jinou je obtížné, protože musíte získat souhlas všech přispěvatelů. Proto je lepší si vybrat správně na začátku. Pokud váháte mezi dvěma variantami, zvolte tu méně omezující – permisivní licenci můžete v budoucnu u nových verzí zpřísnit, ale opačný postup je prakticky nerealizovatelný. A hlavně: po výběru licence ji uveďte v repozitáři, ideálně v souboru s názvem LICENSE a byt v paneláku hlavičce každého zdrojového souboru. Bez toho váš projekt neplní podmínky open source, ačkoli to tak může vypadat.

Dalším užitečným nástrojem je inline – opak extrakce. Pokud máte zbytečně rozdrobený kód, můžete metodu nebo proměnnou vložit zpět do místa použití. To se hodí při zjednodušování po zdlouhavém refaktoringu. IDE samo zkontroluje, zda je inline bezpečný, a upozorní na případné konflikty. Používejte to ale střídmě: inline může snížit čitelnost, pokud se metoda používala na více místech a měla jasný sémantický význam.

Jak se rozhodnout podle reálných potřeb Začněte tím, že si sepíšete, kdo bude API používat a jaké operace bude provádět. Pokud máte více druhů klientů (web, mobil, interní nástroje) a každý potřebuje jiná data, GraphQL vám ušetří čas při vývoji i při komunikaci s frontendem. Pokud ale API slouží hlavně pro integraci s externími systémy, kde je důležitá stabilita a jednoduchost, zůstaňte u RESTu – je snáze pochopitelný a má bohatou podporu nástrojů.

Další oblastí, kde začátečníci tápou, je volba prostředí. Není nutné okamžitě stavět kompletní Kubernetes cluster. Mnoho týmů si vystačí s jednoduchým nasazením na virtuální server nebo do kontejneru, který spouštíte v rámci CI. Důležité je mít reprodukovatelný postup: stejné sestavení, stejné závislosti, stejné výsledky. Pokud používáte kontejnery, definujte si jejich obsah v souboru, který je verzovaný. Tím zajistíte, že kdokoli v týmu dostane identické prostředí – a to i za dva měsíce.

Při tvorbě prvního automatizovaného procesu se vyhněte časté chybě: kopírování složitých konfigurací z internetu. Stejně jako u kódu platí, že převzatá řešení neznáte a při problému nevíte, kde hledat. Začněte s minimální konfigurací – třeba jen sestavení a jeden test. Postupně přidávejte kroky, které dávají smysl. Také se vyhněte snaze automatizovat vše najednou. Pokud nemáte testy, automatizace jen urychlí šíření chyb.

Při psaní testů se vyhněte dvěma častým chybám. První je testování více věcí najednou. Jeden test = jedno očekávání. Pokud máte v jednom testu pět různých tvrzení, při selhání nevíte, která část kódu je rozbitá. Druhým problémem jsou testy, které spoléhají na pořadí provedení nebo na sdílený stav. Každý test by měl být nezávislý, aby se dal spustit samostatně.

Nejprve si ověřte, co je pro vás důležité Udělejte si test: Chcete, aby váš kód používalo co nejvíc lidí, i když ho začlení do placeného softwaru? Sáhněte po permisivní licenci. Chcete, aby se všechny odvozeniny nutně staly open source? Pak si vyberte copyleft. Pokud si nejste jistí, podívejte se na konkrétní situace. Typickou chybou je sáhnout po GPL jen proto, že ji používá oblíbená knihovna, ale pak zjistíte, že vaše aplikace nemůže být nasazená u zákazníka, který vyžaduje uzavřený kód. Naopak příliš permisivní licence může vést k tomu, že vaše práce skončí v komerčním produktu, který nikdy nevrátí žádné změny.

Když už máte normalizovaný stav, nezapomínejte na správné používání akcí a reduktorů. Akce by měly popisovat událost, ne to, co se má stát. Například místo SET_LOADING_TRUE používejte FETCH_STARTED, FETCH_SUCCESS, FETCH_ERROR. Reduktory pak musí být čisté funkce bez vedlejších efektů. Pokud potřebujete volat API nebo jiné asynchronní operace, použijte middleware jako Redux Thunk nebo Redux Saga. Tyto middleware umožňují psát akce, které vracejí funkci místo objektu, a díky tomu můžete řídit celý životní cyklus požadavku.

Než se rozhodnete, udělejte si malý prototyp – vezměte dvě konkrétní obrazovky aplikace a zkuste je implementovat s RESTem i GraphQL. Změřte dobu odezvy, velikost přenesených dat a hlavně čas, který strávíte na vývoji. Většinou zjistíte, že jedno z řešení je výrazně pohodlnější. A pokud začínáte s GraphQL, začněte na menším projektu, kde si osaháte jeho principy – jinak skončíte s technologickou demonstraci, která vám přinese jen problémy.

If you have any concerns with regards to exactly where and how to use celý článek, you can make contact with us at our web site.