DELETE-meetod: toote kustutamine
Saad teada, kuidas administraator kustutab toote veebipoe kataloogist. Vaatame, kuidas DELETE-päringus kasutatakse toote ID-d aadressis, mida tähendab edukat kustutamist kinnitav olekukood 204 ning kuidas kustutamine andmebaasis kajastub.
Tootest
Tere! Me oskame juba tooteid lisada ja muuta. Aga tooted võivad muutuda tarbetuks: need on tarnijal otsas või lisati eksikombel. Nüüd vaatame, kuidas administraator kataloogist toote kustutab.
Selge! Aga kuidas see töötab?
Kõik seletab Kadri: Kadri ootab sind juba nõupidamisruumis. Võtame ainult positiivse stsenaariumi: kõik läheb nii, nagu peab.
Tere! Sa tead juba GET-i (saa), POST-i (loo) ning PATCH-i ja PUT-i (muuda). Toote kustutamiseks on HTTP-s DELETE-meetod.
Tere, Kadri! Kuidas näeb kustutamispäring välja?
DELETE tähendab „kustuta“. Klient paneb aadressi sisse, milline toode kustutada — selle id järgi. Päringu keha pole vaja: server saab ka niigi aru, mida teha. Siin on päring toote id 3 kustutamiseks:
Päring
DELETE /api/v1/products/3
- meetod — mida teha.
DELETEtähendab „kustuta“ - aadress — millega.
/api/v1/products/3on toodeid-ga 3. Toote number on otse aadressis - keha pole: serverile piisab meetodist ja aadressist
Ja mida server kustutamisele vastab?
Server kustutab rea andmebaasist ja saadab vastuse. Kood 204 No Content tähendab „õnnestus, sisu pole“. Vastuse keha on tühi: kustutatud toodet pole mõtet tagastada.
Vastus
204 No Content
- olekukood — kuidas läks.
204 No Contenttähendab „kustutatud, lisada pole midagi“ - keha pole: kustutatud toodet enam ei ole, näidata pole midagi
Märkus: 204 on levinud, kuid mitte ainus variant. Olenevalt teostusest võib server vastata näiteks 200 OK koos kehaga või 202 Accepted, kui kustutamine toimub hiljem.
Kontrollime, kas on selge. Administraator vajutas toote number 3 juures „Kustuta“. Millise päringu klient saadab?
Vaatame seda praktikas!
Siin on BB Foodi admin-paneel. Vali toode ja vajuta „Kustuta“. Jälgi päringu teed: klient → server → andmebaas → server → klient.
Testitav rakendus
Stsenaarium. Positiivne: administraator kustutab toote
Server ootab päringuid. Vajuta „Kustuta“, et klient saadaks DELETE-päringu.
Animatsioon on aeglustatud: tegelikult võtab kogu teekond mõnikümmend millisekundit.
| id | name | price |
|---|
Kataloogis ei ole enam tooteid.
Valmis! Server tagastas 204 No Content ja andmebaasi tabelis pole selle id-ga rida enam. Seega on toode kustutatud: ostja seda enam ei näe.
Ja mida tagastab GET /api/v1/products pärast toote kustutamist?
Aga mida ma siin kontrollima peaksin?
Kontrolli kolme asja. Esiteks: vastuse kood on 204 No Content ja vastusel pole keha. Teiseks: selle id-ga rida kadus andmebaasi tabelist ja teised tooted on alles. Kolmandaks: eraldi päring GET /api/v1/products tagastab nimekirja juba ilma selle tooteta, seega ostjad seda ei näe.
Niisiis tunned sa nüüd kõiki nelja põhitegevust andmetega. Neid nimetatakse CRUD-iks ingliskeelsete sõnade Create, Read, Update, Delete esitähtede järgi. Siin on spikker:
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
Lühiviide
DELETE-meetod
DELETE /api/v1/products/3 tähendab „kustuta“. Klient ütleb aadressis, mida kustutada, ja server kustutab andmed andmebaasist. Päringu keha pole tavaliselt vaja.
Toote number aadressis
Aadress kujul /api/v1/products/3 osutab konkreetsele tootele id-ga 3. Ilma numbrita käiks meetod kogu nimekirja kohta.
Kood 204 No Content
Edukas vastus ilma kehata: tegevus on tehtud ja tagastada pole enam midagi.
Mida testija kontrollib
Vastuse kood on 204. Selle id-ga rida kadus andmebaasist, teised on alles. Toode kadus admin-paneelist ja ostjate kataloogist.