Jak rozchodit první REST API bez zbytečných chyb > 자유게시판

• 목록
• 답변
• 글쓰기
• 게시판 리스트 옵션
  • 수정
  • 삭제

Když začnete s prvním REST API, nejdůležitější je pochopit, že se nejedná o magii, ale o čistou výměnu dat mezi klientem a serverem. Vaším prvním úkolem není psát kód, ale promyslet si, jaké zdroje budete vystavovat a jaké operace s nimi klientům povolíte. Místo abyste rovnou sáhli po frameworku, sedněte si k papíru a načrtněte si, co má API umět: jestli bude sloužit k čtení dat, k jejich zápisu, nebo k obojímu. Tento zdánlivě nudný krok vám ušetří hodiny předělávání, protože později zjistíte, že špatně navržená struktura URL nebo nevhodné názvy zdrojů dělají API nepoužitelným a nutí vás k neustálým kompromisům.

Při pokládce izolace myslete také na akustiku. Pokud je podkroví nad obývacím pokojem, nebo naopak vy chcete mít klid v místnosti pod ním, přidejte do skladby další vrstvu, která tlumí zvuk. Nejedná se o luxus, ale o praktické řešení, které oceníte každý den. Stejně tak se vyplatí věnovat pozornost detailům u zdí a u podlahy – izolace musí být spojitá, bez přerušení u trámů nebo u zdiva. Častou chybou je nechat u okrajů volná místa, kterými pak uniká teplo a zvuk, takže výsledný efekt je poloviční.

Rozhodněte se, co bude na stole stát, když je složený. Pokud na něm plánujete mít lampu nebo květináč, potřebujete model s pevnou základní deskou a výklopnou boční částí. Naproti tomu stůl, který se sklápí celý, uvolní nejvíc místa, ale pokaždé musíte uklidit všechno z povrchu. Před nákupem si proto napište seznam činností, které u stolu budete provádět — jídlo, práce na notebooku, žehlení — a podle toho vyberte tvar desky i systém sklápění.

Jak na validaci a chybové stavy, aby API nekřičelo nesmysly Validace vstupu není žádná legrace, ale je to právě ona, která odděluje funkční API od rozpadajícího se prototypu. Každý parametr, který přijmete, musíte zkontrolovat: For more information regarding pokračovat ve čtení take a look at our own web page. typ, povinnost, délku, rozsah hodnot, a to ještě předtím, než s ním začnete pracovat. Používejte k tomu centralizované validační funkce, které vracejí srozumitelné chybové zprávy včetně názvu parametru a důvodu selhání. Tím se vyhnete situaci, kdy klient dostane obecné „internal server error" a vy si pak hodiny lámete hlavu, co se vlastně pokazilo. rady pro rekonstrukci nevalidní data vracejte kód 400 a do těla dejte seznam konkrétních chyb, ne jen jedno obecné konstatování.

Jakmile máte jistotu, že je konstrukce suchá a zdravá, přichází na řadu izolace. U podkroví, které má sloužit jako obytný prostor, je zateplení mezi krokvemi naprostým základem. Materiál musíte nacpat tak, aby těsně přiléhal ke dřevu a nevznikaly mezery, kterými by unikalo teplo nebo naopak pronikala vlhkost. V praxi se osvědčuje řezat izolaci o něco širší, než je vzdálenost mezi krokvemi, a vtlačit ji mezi ně. Dbejte na to, aby izolace nebyla stlačená – ztratila by část svých tepelně izolačních vlastností. Pokud je krov nízký a mezi krokvemi se izolace nevejde, musíte přidat další vrstvu pod ně, což ovšem znamená ztrátu prostoru. S tím počítejte předem.

Co se týče barev, rozhodující je způsob barvení. Kvalitní povlečení by mělo být barveno reaktivními barvivy, která se vážou přímo na vlákna. Taková barva vydrží i mnoho let a nevybledne ani při praní na vyšší teploty. Naopak levná pigmentová barviva ulpívají pouze na povrchu a po pár vypráních se začnou loupat. Jednoduchý test: promněte suchou látku v dlani – pokud na ruce zůstane barva, máte před sebou nekvalitní výrobek. Stejně tak se vyhněte povlečení s výrazným potiskem, který je nanášen na povrch – ten časem popraská a zmatní.

Když už máte zabezpečené okna a teplotu, zaměřte se na osvětlení. V podkroví bývá málo denního světla, proto kombinujte několik zdrojů: hlavní stropní světlo, lampičku na čtení u postele a případně LED pásek pod policemi. Vyhněte se ostrému světlu z bodovek, které vrhají stíny a unavují oči. Dítě potřebuje rovnoměrné světlo, které mu umožní soustředit se na hru i učení. Jestliže je pokoj opravdu tmavý, zvažte světlejší barvy stěn do obýváku stěn a podlahy – tmavé dřevo nebo syté barvy prostor opticky zmenší a pohltí i málo světla, které sem pronikne.

Samotný požadavek pak prochází přes HTTP metody, které mají přesně daný význam. Get slouží k získání dat, post k vytvoření nového zdroje, put k jeho úplné aktualizaci a delete k jeho odstranění. Na začátku se držte těchto základních čtyř metod a vyhněte se experimentům s patch, dokud si nejste jistí sémantikou. Pokud klient pošle metodu, kterou nepodporujete, měli byste jasně odpovědět stavovým kódem 405 a v hlavičce allow uvést povolené metody. Mnohem častější chybou je ale ignorování rozdílu mezi kódy 200 s upraveným tělem a 201 s prázdným tělem – vždy vracejte status, který odpovídá skutečnému stavu operace, a přikládejte k němu dostatečně popisné tělo odpovědi.