REST

Allikas: Vikipeedia
Jump to navigation Jump to search

REST (representational state transfer)[1] on tarkvaraarhitektuuri laad, mis seab veebirakenduse loomisele kindlad piirid. Tihti kutsutakse sellised veebirakendusi ka RESTful veebirakendusteks. Veebirakendused, mis on ehitatud REST arhitektuuril, tagavad internetis rakenduste koostoimimise. RESTful rakendused lubavad teistel süsteemidel juurde pääseda ja manipuleerida enda ressursse, kasutades selleks eelnevalt kindlaks määratud ilma olekuta päringuid. Muud arhitektuurid, näiteks SOAP, kasutavad omaenda toimingukomplekte.[2]

REST arhitektuuri põhiidee seisneb selles, et tehakse erinevat tüüpi päringuid REST-arhitektuuriga üles seatud erinevatele URI-dele, mis seejärel vastavad sobiva vastusega. Vastuse vorming ei ole kindlaks määratud ja oleneb rakenduse tüübist. Levinumad vormingud on JSON, HTML ja XML. Rakenduselt saadud vastus sisaldab staatuse koodi, mis ütleb, kas tehtud päring oli edukas, ja olenevalt päringust ka lisaandmeid, mida rakenduselt küsiti. Kui kasutatakse HTTP-d, mis on kõige levinum protokoll RESTful rakenduste jaoks, siis olemasolevate toimingute hulka kuuluvad GET-, POST-, PUT-, DELETE- ja PATCH-toimingud, tihti tuntud ka kui CRUD-toimingud.[2]

Kasutades sobivaid protokolle ja standardseid toiminguid, püüavad RESTful-süsteemid komponentide uuesti kasutamise ja värskendamisega saavutada suurt jõudlust, töökindlust ja võimet laieneda, ilma kogu töötavat süsteemi mõjutamata.[2]

Termini representational state transfer defineeris ja võttis kasutusele Roy Fielding 2000. aastal oma doktoritöös.[3][4] Fieldingi töö seletas RESTi põhimõtteid, mida senimaani nimetati "HTTP objekti mudeliks", mis oli kasutusel aastast 1994 ja seda kasutati HTTP 1.1 ja URI standardite disainimiseks.[3][5][6] Mõiste eesmärk on kujundada hästi kavandatud veebirakenduse käitumine: see on veebiressursside võrk (virtuaalne olek-masin), kus kasutaja edastab rakenduse kaudu, valides lingid, näiteks /user/tom ja sellised toimingud nagu GET või DELETE (seisundi muudatus), mille tulemuseks edastatakse kasutajale järgmine ressurss, mis esindab rakenduse järgmist seisundit.[7]

Ajalugu[muuda | muuda lähteteksti]

Roy Fielding esinemas OSCON-il 2008

Roy Fielding määratles REST arhitektuuri oma 2000. aasta doktoritööga "Arhitektuurilaadid ja võrgupõhiste tarkvaraspetsifikaatide projekteerimine" California Ülikoolis. Ta arendas 1996.–1999. aastal HTTP 1.1 protokolli, mis põhines 1996. aastal loodud HTTP 1.0-l.[8] Tagasiulatuvalt REST arhitektuuri arendamisele ütles Fielding järgmist:

Arhitektuuri omadused[muuda | muuda lähteteksti]

REST arhitektuuri stiili piirangud mõjutavad järgmisi arhitektuurilisi omadusi:

  • komponentidevaheliste interaktsioonide jõudlus, mis võib olla kasutaja tajutava jõudluse ja võrgu tõhususe domineeriv tegur;[3]
  • skaleeritavus, mis võimaldab toetada suurt hulka komponente ja nendevahelisi interaktsioone;
  • ühtse liidese lihtsus;
  • komponentide muutmine uute vajaduste rahuldamiseks, isegi kui rakendus töötab;
  • teenindusagentide ja komponentide vahelise kommunikatsiooni läbipaistvus;
  • komponentide teisaldatavus programmi koodi ja andmete abil;
  • süsteemi stabiilsus pistikühendustes, komponentides või andmetes esinevate tõrgete korral.

Roy Fielding kirjeldab RESTi skaleeritavust järgmiselt:

URLi ja sobivate HTTP meetodite kasutamine[muuda | muuda lähteteksti]

Järgnev tabel demonstreerib, kuidas HTTP meetodeid tavaliselt REST API-des kasutatakse:

HTTP meetodid
(URL) ühtne ressursilokaator (Uniform Resource Locator) GET PUT PATCH POST DELETE
Kollektsioon
https://api.example.com/resources/
Tagastatakse list kollektsiooni elementide URI-dest ja vahel ka muust nendega seonduvast infost. Asendatakse kogu kollektsiooni teise kollektsiooniga. Üldiselt seda ei kasutata. Luuakse uus kirje kollektsiooni. Uue kirje on URI on loodud automaatselt ja on tavaliselt ka vastuses tagastatud. Kustutatakse kogu kollektsioon.
Element
 https://api.example.com/resources/item17
Tagastatakse kollektsiooni elemendi andmed sobivad meediatüübis. Asendatakse olemasolev element või luuakse selle puudumisel uus element. Uuendatakse olemasolevat elementi uute andmetega. Üldiselt seda ei kasutata, kuid kasutamisel on selle eesmärk muuta element omakorda kollektsiooniks.[9] Kustutatakse element kollektsioonist.

Viited[muuda | muuda lähteteksti]

  1. "REST definitsioon". Vaadatud 30.11.2018.
  2. 2,0 2,1 2,2 World Wide Web Consortium. "Web Services Architecture". 11. veebruar 2004. Vaadatud 04.11.2018.
  3. 3,0 3,1 3,2 3,3 Roy Thomas Fielding. "Architectural Styles and the Design of Network-based Software Architectures". 2000. University of California, Irvine. Vaadatud 30.11.2018.
  4. "Fielding discussing the definition of the REST term". groups.yahoo.com. Vaadatud 08.08.2017.
  5. T. Berners-Lee, R. Fielding, H. Frystyk. "RFC 1945". Mai 1996. Vaadatud 02.12.2018.
  6. R. Fielding, J. Gettys, J. Mogul, H. Frystyk, L. Masinter, P. Leach, T. Berners-Lee. "RFC 2616". Juuni 1999. Vaadatud 02.12.2018.
  7. "REST principles explained". Servage. Vaadatud 30.11.2018.
  8. 8,0 8,1 "Fielding discusses the development of the REST style". Vaadatud 14.09.2014. Arhiiviversioon, arhiveeritud 11.11.2009.
  9. Jeremy H. "API Example Using REST". 16. mai 2012. Vaadatud 04.11.2018.