Kokkuvõte: klient ja server
Sissejuhatava sarja lõpukontroll. Kinnistad sarja teemad, kasutad HTTP-meetodite ja vastuskoodide spikrit ning vastad 23 küsimusele, mis hõlmavad kogu sarja põhimõisteid.
Tootest
Tere! Sa läbisid kogu kliendi ja serveri sissejuhatava sarja: GET, POST, PATCH, PUT, DELETE ja vastuskoodid. Suurepärane töö! Jääb üle kõik kokku võtta.
Aitäh! Mis edasi?
Kadri valmistas ette lõpukontrolli: lühikese spikri ja küsimused kogu sarja kohta. Kadri ootab sind nõupidamisruumis.
Tere! Tubli, et jõudsid lõpuni. Enne kui ennast kontrollid, paneme kõik ühte pilti kokku.
Teeme! Mida on kõige tähtsam meeles pidada?
Klient saadab päringu, server töötleb seda, pöördub vajadusel andmebaasi poole ja tagastab siis vastuse: olekukoodi ja andmed, enamasti JSON-vormingus. Klient ei lähe kunagi ise andmebaasi. Siin on kaks spikrit:
CRUD ja HTTP-meetodid
- Create — loo:
POST, edu —201 Created - Read — loe:
GET, edu —200 OK - Update — muuda:
PATCH(osa andmetest) võiPUT(terve objekt), edu —200 OK - Delete — kustuta:
DELETE, edu —204 No Content
Vastuskoodid
2xx— edu.200 OKtühja nimekirjaga[]on samuti edu, mitte viga3xx— ümbersuunamine: ressurss on kolinud. Näiteks vana leht/salekustutati ja pakkumised on nüüd aadressil/promo. PäringuleGET /salevastab server301 Moved Permanentlyja kirjutab päisesseLocationuue aadressi/promo, brauser läheb sinna ise. Testija kontrollib, et vana link viib õigele lehele, mitte404-le4xx— kliendi viga:401— pole sisse logitud,404— ei leitud,405— meetod pole lubatud5xx— serveri viga:500— serveris läks midagi katki,503— server on ajutiselt kättesaamatu või ülekoormatud
Ja testija jaoks kõige tähtsam: kontrolli mitte ainult vastuse koodi, vaid ka andmeid andmebaasis ja seda, mida kasutaja näeb.
Olen valmis ennast kontrollima!
Siis läheme! Küsin 21 küsimust kogu sarja kohta juhuslikus järjekorras, nagu arutaksime päris tööolukordi. Kui eksid, annan vihje ja saad uuesti vastata. Arvesse lähevad esimesel katsel õiged vastused.
Alustame soojendusega. Server saatis sellise vastuse. Mis on toote nimi?
{
"id": 5,
"name": "Rukkileib",
"price": 1.79
}Ostja avas kataloogi ja server tagastas sellise nimekirja. Mitu toodet ostja näeb?
[
{"id": 2, "name": "Kirsstomatid, 250 g", "price": 2.29},
{"id": 7, "name": "Soolaheeringas, 300 g", "price": 3.29}
]Muide, eile nägin logides, et ostja päris kataloogi viis korda järjest: viis GET-päringut. Kas peaksin andmebaasis olevate toodete pärast muretsema?
Nüüd halduspaneelist. Administraator lisas just uue toote. Milline meetod läks serverisse ja millist vastust standardi järgi ootame?
Siin on lugu elust: administraator vajutas kogemata kaks korda järjest „Lisa toode“ samade andmetega. Vaatame andmebaasi — mis seal on?
Väike ülesanne minult: tootel on vaja muuta ainult hinda, ülejäänut ei puutu. Millise meetodi valid?
Kujuta ette, et pead kustutama toote id-ga 5. Kuidas päring välja näeb ja millist vastust ootad?
Veel üks olukord. Vana pakkumiste leht /sale kustutati ja pakkumised on nüüd aadressil /promo. Kuid klientide vanades uudiskirjades on endiselt link /sale-le. Mida peaks server vastama päringule GET /sale?
Räägime nüüd vigadest. Administraator logis adminpaneeli sisse ja sai pääsukoodi, mis kehtib 15 minutit. Kui ta tootekaarti täitis, segas teda telefonikõne ja 15 minutit möödus. Nüüd vajutab ta „Lisa toode“. Mida server vastab?
Siin on huvitavam juhtum: klient saatis DELETE-i kogu nimekirjale /api/v1/products, kuid seal on lubatud ainult GET ja POST. Milline kood vastuseks tuleb?
Uus testija tõi mulle „vea“: pood just avati, tooteid pole ja server vastab 200 OK ja tühja nimekirjaga []. Kas teeme veateate?
Saadad päringu ja server vastab 500. Kes on süüdi?
Rukkileiva hind oli 1.79. Administraator saatis PATCH-i uue hinnaga 2.19 ja server vastas 200 OK. Avad toote GET-iga, kuid seal on endiselt 1.79. Kas teeme veateate?
Administraator lisas toote: server vastas 201 Created ja GET /api/v1/products tagastab uue toote. Kuid kataloogilehel ostja seda ei näe. Kust probleemi otsida?
Vaata päringut ja vastust. Mis siin valesti on?
DELETE /api/v1/products/5
← 200 OK
{
"error": "Product not found"
}Saatsid DELETE /api/v1/products/5 ja said 204 No Content. Kontrolliks saadad täpselt sama päringu uuesti. Mida server vastab?
Ostja avas lingi tootele, mida poes pole kunagi olnud: GET /api/v1/products/999. Milline vastus on õige?
Must reede: poodi tuli väga palju ostjaid ja osa neist saab vastuseks 503 Service Unavailable. Mida see tähendab?
Arendaja ütleb, et serveri vastus on korras. Vaata lähemalt: kas siin on kõik õige?
{
"id": 5,
"name": "Rukkileib",
"price": "1.79"
}Pead hankima toote id-ga 5. Kolleeg pakub saata GET /api/v1/products kehaga { "id": 5 }. Kas see töötab nii, nagu ta lootis?
Kustutad toote: DELETE /api/v1/products/5. Kas selles päringus on vaja keha?
Lõpukontroll on tehtud ja sissejuhatav sari „Klient-server“ on läbitud! Kinnistamiseks ootab ees iseseisev töö: joonistad päris Todo-rakenduse CRUD-skeemi.
Lühiviide
Klient, server ja andmebaas
Klient saadab päringu, server töötleb seda, pöördub vajadusel andmebaasi poole ja tagastab vastuse. Klient ei lähe kunagi otse andmebaasi.
JSON
Vastuse andmed tulevad tavaliselt JSON-vormingus. Objekt on loogeliste sulgude { } vahel „võti: väärtus“ paaridega, objektide nimekiri nurksulgude [ ] vahel. Tühi nimekiri [] tähendab „andmeid pole“, mitte viga.
Meetodid ja CRUD
POST /api/v1/products — loo (201 Created), GET /api/v1/products — loe (200 OK), PATCH /api/v1/products/3 — muuda osa andmetest, PUT /api/v1/products/3 — asenda täielikult (mõlemad 200 OK), DELETE /api/v1/products/3 — kustuta (204 No Content).
Päringute kordamine
GET-i võib korrata kui tahes palju kordi: see ei muuda midagi. Iga POST loob uue kirje, seega annab kordus duplikaadi. Korduv DELETE andmebaasi ei muuda, kuid tagastab 404.
Vastuskoodid
2xx on edu (200 tühja nimekirjaga on samuti edu). 4xx on kliendi viga: 401 — pole sisse logitud, 404 — ei leitud, 405 — meetod pole lubatud. 5xx on serveri viga: 500 — midagi läks katki, 503 — server on ajutiselt ülekoormatud.
Mida testija kontrollib
Vastuse koodi, andmeid andmebaasis ja seda, mida kasutaja näeb: arusaadav teade, ajakohane nimekiri, mingit hangumist.