GET-meetod: kataloogi laadimine

Saad teada, kuidas klient, server ja andmebaas omavahel suhtlevad ning kuidas andmed nende vahel liiguvad. Veebipoe kataloogi laadimise näitel vaatame, kuidas GET-päring töötab ja kuidas server andmed kliendile tagastab.

Tootest

BB Food on kojuveoga toidukaupade e-pood. Ostja avab veebilehe, sirvib kataloogi, valib tooted ja vormistab tellimuse.

Praegu on kataloogis 7 toodet. Enne veebilehe testimist vaatame, kuidas see töötab: mis toimub brauseris, mis serveris ja kus tooteid hoitakse.

Kadri, mentor

Alustame peamisest: kuidas on üles ehitatud peaaegu iga veebirakendus.

Lühiviide

Klient

Programm, mida inimene kasutab: brauser või mobiilirakendus. Klient kuvab liidest ja küsib andmeid serverilt.

Server

Programm, mis kuulab pidevalt sissetulevaid päringuid, töötleb neid ja saadab vastuse. Server ei kirjuta kunagi esimesena: see ainult vastab klientide päringutele.

Andmebaas

Hoidla, kus andmed on tabelites. Klient ei pöördu andmebaasi poole otse: sellega töötab ainult server.

Päring ja vastus

Klient ja server suhtlevad HTTP-protokolli kaudu. Päringus on meetod (mida teha) ja aadress (millega). Vastuses on olekukood (kuidas läks) ja keha andmetega, enamasti JSON-vormingus.

JSON

Tekstiline andmevorming. Objekt kirjutatakse loogeliste sulgude { } vahele „võti: väärtus“ paaridena, näiteks {"id": 3, "price": 1.19}. Tekst on jutumärkides, numbrid ilma jutumärkideta. Objektide nimekiri kirjutatakse nurksulgude [ ] vahele komadega eraldatult. Tühi nimekiri [] tähendab „andmeid pole“, mitte viga.

GET-meetod ja kood 200

GET /api/v1/products tähendab „saa andmed“. See ei muuda serveris midagi, seega võib seda korrata kui tahes palju kordi. Kood 200 OK tähendab, et päring õnnestus.

Kood 500

Vastus, mille server saadab, kui tema enda poolel läks midagi katki. Viiega algavad koodid on serveri vead, neljaga algavad koodid kliendi vead. Testija kontrollib, et kasutaja näeb arusaadavat veateadet ja rakendus ei jää ootama.