Jak vybrat správné API pro váš projekt

Kdy naopak sáhnout po GraphQL? GraphQL vyniká tam, kde máte složité datové vztahy a potřebujete efektivně agregovat data z více zdrojů. Typickým příkladem je mobilní aplikace, která pro jednu obrazovku potřebuje kombinaci uživatele, jeho přátel, příspěvků a komentářů. V RESTu byste museli volat několik endpointů a pak data skládat na klientovi. GraphQL umožňuje poslat jeden dotaz, který vrátí přesně to, co potřebujete, bez nadbytečných dat.

Na závěr si pamatujte, že strukturovaná zpětná vazba funguje jen tehdy, když je pravidelná a krátká. Nezavádějte ji jen na měsíční retrospektivu, ale klidně i na kratší „check-in" na konci každého sprintu. Čím častěji ji budete používat, tím přirozenější pro vás bude. Vyhněte se ale tomu, abyste každý týden měnili formát – tým si potřebuje na strukturu zvyknout. A pokud některý bod vyvolá vášnivou debatu, nezapomeňte, že cílem není vyhrát hádku, ale najít společně schůdné řešení, které posune práci týmu dál.

Jednotkové testy jsou základem udržovatelného kódu. Framework NUnit patří mezi nejpoužívanější nástroje pro testování v ekosystému .NET. Pokud začínáte, první kroky jsou jednoduché: vytvořte testovací projekt, přidejte balíček NUnit a napište první třídu s atributem [TestFixture]. Každá testovací metoda pak nese atribut [Test]. Důležité je, aby testy byly nezávislé, rychlé a jejich výsledek nebyl ovlivněn pořadím spuštění.

Na závěr si osvojte práci s nástrojem Test Explorer ve Visual Studiu nebo s příkazem dotnet test. Umožní vám spustit vybrané testy, filtrovat podle kategorií a zobrazit podrobné informace o selhání. S NUnit se vyplatí prozkoumat i pokročilé funkce, jako jsou parametrizované testy, setup a teardown, nebo asynchronní testy. Tyto nástroje vám dovolí psát testy efektivněji a s menším množstvím opakujícího se kódu.

Při psaní testů se držte pravidla AAA – Arrange, Act, Assert. Nejdříve připravte vstupní data a objekty, poté vyvolejte testovanou metodu, a nakonec ověřte očekávaný výsledek. Například při testování třídy Calculator s metodou Add nejprve vytvoříte instanci, zavoláte metodu s čísly 2 a 3, a poté ověříte, že je výsledek 5. Tento postup zajišťuje čitelnost a jednoznačnost testu.

Pokud přicházíte z čistého JavaScriptu, první setkání s TypeScriptem může působit jako zbytečná byrokracie. Po pár dnech práce si ale začnete všímat, že mnoho chyb, které jste dříve odhalovali až za běhu, se nyní objeví přímo v editoru. TypeScript není samostatný jazyk, ale nadstavba, která do JavaScriptu přidává statické typování. Jeho hlavní přínos spočívá v tom, že umožňuje lépe popsat tvary dat a vztahy mezi nimi, což oceníte zejména u větších projektů nebo týmové spolupráce.

Čistý kód není o osobním vkusu, ale o udržitelnosti projektu. Když píšete JavaScript, každé rozhodnutí – od názvu proměnné po strukturu funkcí – ovlivní, jak snadno se bude kód číst a měnit. Základním pravidlem je, že kód se píše jednou, ale čte se mnohokrát. Proto se vyplatí investovat čas do srozumitelnosti hned na začátku, místo abyste se k němu vraceli později s frustrací.

Na závěr: TypeScript se nejlépe učí při práci na reálném projektu. Začněte tím, že si do existujícího JavaScriptového projektu přidáte konfigurační soubor a postupně přepnete soubory na .ts. Sledujte chyby, které editor hlásí, a opravujte je. Po pár týdnech zjistíte, že píšete kód rychleji, protože se nemusíte spoléhat na paměť a dokumentaci. Chyby odhalíte dřív, než se dostanou k uživatelům, a to je největší přínos, který TypeScript nabízí.

Nejlepší způsob, jak začít, je vyzkoušet si veřejné API, které nevyžaduje registraci nebo klíč. Otevři si nástroj pro vývojáře v prohlížeči (klávesa F12) a přejdi do záložky Konzole. Do příkazového řádku napiš příkaz pro získání dat, třeba z API, které poskytuje aktuální čas nebo počasí. Použij metody jako fetch nebo axios – v konzoli prohlížeče funguje bez dalšího nastavení. Po odeslání požadavku uvidíš odpověď ve formátu JSON, což je strukturovaný text, který se snadno čte i zpracovává.

Velmi důležité je také pojmenování testů. Název by měl popisovat očekávané chování, ne interní implementaci. Místo Test1 použijte Add_TwoNumbers_ReturnsSum. Takový název usnadní orientaci v testovací sadě i při jejím procházení po měsících. Kromě toho si zvykněte spouštět testy po každé změně kódu, ideálně automaticky pomocí CI serveru. Čím častěji testy běží, tím rychleji odhalíte regrese.

Při práci s API se také vyvaruj tvrdému zakódování adres a klíčů přímo do kódu. Pro klíče používej proměnné prostředí, které se nastavují mimo zdrojový kód. Jinak riskuješ, že se tvoje klíče dostanou na veřejnost, pokud kód sdílíš nebo nahraješ na internet. Stejně tak si zvykni na zpracování chyb – vždy ošetři situaci, kdy API neodpovídá podle očekávání. Používej bloky try-catch nebo .catch(), abys program nespadl při chybě sítě.