RESTful veebiteenuste õpetus: mis on näitega REST API

RESTful võtmeelemendid

RESTi veebiteenused on nende loomisest saadik tõesti kaugele jõudnud. 2002. aastal avaldas veebikonsortsium WSDL-i ja SOAP-i veebiteenuste määratluse. See moodustas veebiteenuste rakendamise standardi.

2004. aastal avaldas veebikonsortsium ka lisastandardi definitsiooni nimega RESTful. Viimase paari aasta jooksul on see standard muutunud üsna populaarseks. Ja seda kasutavad paljud populaarsed veebisaidid üle maailma, sealhulgas Facebook ja Twitter.

REST on viis juurdepääsuks ressurssidele, mis asuvad konkreetses keskkonnas. Näiteks võib teil olla server, mis võib majutada olulisi dokumente või pilte või videoid. Kõik see on näide ressurssidest. Kui klient, näiteks veebibrauser, vajab mõnda neist ressurssidest, peab ta saatma serverile taotluse neile ressurssidele juurdepääsuks. Nüüd määratlevad REST-teenused viisi, kuidas neile ressurssidele juurde pääseda.

RESTfuli rakendamise põhielemendid on järgmised:

1. Vahendid – Esimene võtmeelement on ressurss ise. Oletame, et serveri veebirakenduses on kirjed mitme töötaja kohta. Oletame, et veebirakenduse URL on https://demo.guru99.com. Nüüd saab REST-teenuste kaudu töötaja kirje ressursile juurdepääsuks anda käsu https://demo.guru99.com/employee/1 – See käsk käsib veebiserveril esitada selle töötaja andmed, kelle töötaja number on 1.
2. Küsi tegusõnu – Need kirjeldavad, mida soovite ressursiga teha. Brauser väljastab GET-verbi, et anda juhiseid lõpp-punktile, mida ta soovib andmeid hankida. Siiski on saadaval palju muid tegusõnu, sealhulgas selliseid asju nagu POSTITA, PANEMINE ja KUSTUTAMINE. Nii ka näite puhul https://demo.guru99.com/employee/1 , väljastab veebibrauser tegelikult GET Verbi, kuna soovib saada töötaja kirje üksikasju.
3. Taotle päiseid – Need on taotlusega koos saadetud lisajuhised. Need võivad määratleda nõutava vastuse tüübi või volituse üksikasjad.
4. Taotluse keha – Andmed saadetakse koos päringuga. Andmed saadetakse päringus tavaliselt siis, kui REST veebiteenustele tehakse POST-päring. POST-kõnes teatab klient tegelikult REST veebiteenustele, et soovib serverisse ressurssi lisada. Seega on päringu kehal andmed ressursi kohta, mis tuleb serverisse lisada.
5. Vastus – See on vastuse põhiosa. Nii et meie RESTful API näites, kui peaksime päringu kaudu veebiserverit päringuma https://demo.guru99.com/employee/1 , võib veebiserver tagastada XML-dokumendi, mis sisaldab kõiki vastusekogus olevaid töötaja üksikasju.
6. Vastuse olekukoodid – Need koodid on üldised koodid, mis tagastatakse koos vastusega veebiserverist. Näiteks on kood 200, mis tavaliselt tagastatakse, kui kliendile vastuse tagastamisel viga ei esine.

Rahustavad meetodid

Allolev diagramm näitab enamasti kõiki tegusõnu (POSTITA, HANGI, PANEM ja KUSTUTA) ning REST API näidet, mida need tähendaksid.

Oletame, et asukohas on määratletud veebiteenus RESTful. https://demo.guru99.com/employee . Kui klient esitab sellele veebiteenusele mis tahes päringu, saab ta määrata mis tahes tavalise HTTP-verbi GET, POST, DELETE ja PUT. Allpool on näha, mis juhtuks, kui vastavad verbid saadaks klient.

1. POST – Seda kasutataks uue töötaja loomiseks, kasutades veebiteenust RESTful
2. GET – Seda kasutatakse kõigi RESTfuli veebiteenust kasutavate töötajate loendi saamiseks
3. PUT – Seda kasutatakse kõigi RESTfuli veebiteenust kasutavate töötajate värskendamiseks
4. Kustuta – Seda kasutatakse kõigi RESTfuli teenuseid kasutavate töötajate kustutamiseks

Heidame pilgu ainult ühe plaadi vaatenurgast. Oletame, et oli töötaja kirje töötaja numbriga 1.

Järgmistel toimingutel oleks nende vastav tähendus.

1. POST – See ei kehti, kuna toome töötaja 1 andmeid, mis on juba loodud.
2. GET – Seda kasutatakse veebiteenust RESTful kasutades töötaja, kelle töötaja number on 1, andmete hankimiseks
3. PUT – Seda kasutatakse töötaja, kelle töötaja number on 1, andmete värskendamiseks, kasutades veebiteenust RESTful
4. Kustuta – Seda kasutatakse selle töötaja andmete kustutamiseks, kelle töötaja number on 1

Miks Rahulik

Restful sai populaarseks peamiselt järgmistel põhjustel:

1. Heterogeensed keeled ja keskkonnad – See on üks peamisi põhjuseid, mis on sama, mida oleme näinud SOAP samuti.

• See võimaldab erinevatele programmeerimiskeeltele üles ehitatud veebirakendustel omavahel suhelda
• Restfuli teenuste abil saavad need veebirakendused asuda erinevates keskkondades, mõned võivad olla sisse lülitatud Windowsja teised võivad olla Linuxis.

Kuid lõppude lõpuks, olenemata sellest, milline keskkond on, peaks lõpptulemus olema alati sama, et nad peaksid saama üksteisega rääkida. Rahulikud veebiteenused pakuvad seda paindlikkust erinevatele programmeerimiskeeltele ja platvormidele üles ehitatud rakendustele, et omavahel suhelda.

Alloleval pildil on näide veebirakendusest, millel on nõue suhelda teiste rakendustega, nagu Facebook, Twitter ja Google.

Nüüd, kui klientrakendus peaks töötama selliste saitidega nagu Facebook, Twitter jne, peaksid nad tõenäoliselt teadma, mis keeles on Facebook, Google ja Twitter üles ehitatud, ja ka seda, millisele platvormile need on üles ehitatud.

Selle põhjal saame kirjutada oma veebirakenduse liidesekoodi, kuid see võib osutuda õudusunenäoks.

Facebook, Twitter ja Google tutvustavad oma funktsioone Restfuli veebiteenuste kujul. See võimaldab igal kliendirakendusel helistada nendele veebiteenustele REST-i kaudu.

2. Seadmete sündmus – Tänapäeval peab kõik edasi töötama mobiilne seadmeid, olgu selleks siis mobiilseade, sülearvutid või isegi autosüsteemid.

Kas kujutate ette, kui palju vaeva on vaja nende seadmete rakenduste proovimiseks ja kodeerimiseks, et tavaliste veebirakendustega suhelda? Jällegi võivad Restful API-d selle töö lihtsamaks muuta, sest nagu punktis 1 mainitud, ei pea te tõesti teadma, mis on seadme aluseks olev kiht.

3. Lõpuks on Pilve sündmus – Kõik liigub pilve. Rakendused liiguvad aeglaselt pilvepõhistesse süsteemidesse, näiteks sisse Azure or Amazon. Azure ja Amazon pakkuda palju API-sid, mis põhinevad Restfuli arhitektuuril. Seetõttu tuleb rakendusi nüüd arendada nii, et need oleksid pilvega ühilduvad. Seega, kuna kõik pilvepõhised arhitektuurid töötavad REST-põhimõttel, on mõistlikum, kui veebiteenused programmeeritakse REST-teenustel põhinevale arhitektuurile, et pilvepõhiseid teenuseid kõige paremini kasutada.

Rahulik Architektuur

Rakendusel või arhitektuuril, mida peetakse RESTful või REST-stiilis, on järgmised omadused

1. Olek ja funktsionaalsus on jagatud hajutatud ressurssideks – See tähendab, et igale ressursile peaks pääsema juurde tavaliste HTTP-käskude kaudu GET, POST, PUT või DELETE. Seega, kui keegi soovib faili serverist saada, peaks tal olema võimalik väljastada GET-päring ja fail hankida. Kui nad soovivad faili serverisse panna, peaksid nad saama väljastada kas POST- või PUT-päringu. Ja lõpuks, kui nad tahavad faili serverist kustutada, saavad nad väljastada DELETE taotluse.

2. Arhitektuur on klient/server, olekuta, kihiline ja toetab vahemällu salvestamist

• Klient-server on tüüpiline arhitektuur, kus server võib olla rakendust majutav veebiserver ja klient võib olla sama lihtne kui veebibrauser.
• Kodanikuta tähendab, et rakenduse olekut REST-is ei säilitata. Näiteks kui kustutate serverist ressursi käsu DELETE abil, ei saa te eeldada, et kustutamisteave edastatakse järgmisele päringule.

Ressursi kustutamise tagamiseks peate väljastama GET-päringu. GET-päringut kasutatakse esmalt kõigi serveri ressursside hankimiseks. Pärast seda tuleks vaadata, kas ressurss on tegelikult kustutatud.

RESTFul põhimõtted ja piirangud

REST-arhitektuur põhineb mõnel allpool kirjeldatud omadusel. Iga RESTfuli veebiteenus peab vastama alltoodud omadustele, et seda saaks nimetada RESTfuliks. Neid omadusi nimetatakse ka disainipõhimõteteks, mida tuleb RESTful-põhiste teenustega töötamisel järgida.

1. RESTFul klient-server

   

See on REST-põhise arhitektuuri kõige olulisem nõue. See tähendab, et serveril on RESTful veebiteenus, mis pakuks kliendile vajalikke funktsioone. Klient saadab päringu serveri veebiteenusele. Server lükkab taotluse tagasi või täidab selle ja annab kliendile adekvaatse vastuse.

2. Kodakondsuseta

Kodanikuta mõiste tähendab, et kliendi ülesanne on tagada kogu nõutava teabe edastamine serverile. See on vajalik selleks, et server saaks vastust nõuetekohaselt töödelda. Server ei tohiks kliendi päringute vahel säilitada mingit teavet. See on väga lihtne sõltumatu küsimuste-vastuste jada. Klient esitab küsimuse, server vastab sellele õigesti. Klient esitab teise küsimuse. Server ei mäleta eelmist küsimus-vastusstsenaariumi ja peab uuele küsimusele iseseisvalt vastama.

3. Cache

Vahemälu kontseptsioon aitab lahendada kodakondsuseta probleemi, mida kirjeldati viimases punktis. Kuna iga serverikliendi päring on olemuselt sõltumatu, võib klient mõnikord küsida serverilt sama päringut uuesti. Seda isegi siis, kui ta oli seda juba varem palunud. See päring saadetakse serverisse ja server annab vastuse. See suurendab liiklust kogu võrgus. Vahemälu on kliendis rakendatud kontseptsioon, mis salvestab juba serverisse saadetud päringuid. Nii et kui sama päringu esitab klient, läheks see serverisse mineku asemel vahemällu ja saaks vajaliku teabe. See säästab kliendilt serverisse edasi-tagasi võrguliiklust.

4. Kihiline süsteem

Kihilise süsteemi kontseptsioon seisneb selles, et kliendi ja RESTFuli veebiteenust majutava tegeliku serveri vahele saab sisestada mis tahes täiendava kihi, näiteks vahevara kihi (vahevara kiht on koht, kus luuakse kogu äriloogika. See võib olla lisateenus loodud, millega klient saaks enne veebiteenusele helistamist suhelda.). Kuid selle kihi kasutuselevõtt peab olema läbipaistev, et see ei häiriks kliendi ja serveri vahelist suhtlust.

5. Liides / ühtne leping

See on RESTfuli veebiteenuste toimimise aluseks olev tehnika. RESTful töötab põhimõtteliselt HTTP veebikihil ja kasutab serveris ressurssidega töötamiseks allolevaid võtmetegusõnu

• POST – serveris ressursi loomiseks
• GET – ressursi toomiseks serverist
• PUT – ressursi oleku muutmiseks või värskendamiseks
• DELETE – ressursi eemaldamiseks või kustutamiseks serverist

Looge ASP.NETis oma esimene Restfuli veebiteenus

Nüüd selles REST API õpetuses õpime, kuidas luua ASP.NETis Restfuli veebiteenust:

Veebiteenuseid saab luua erinevates keeltes. REST-põhiste teenuste loomiseks saab kasutada paljusid integreeritud arenduskeskkondi.

Selles RESTful API näites loome rakenduse REST .Netis, kasutades Visual Studio. Meie näites emuleerime Restfuli veebiteenuste jaoks järgmist REST-teenuse näidet.

Meil on veebiteenus Restful, mis töötab allolevate andmetega.

Allolev andmekogum kujutab REST API näidet ettevõttest, mis tutvustab õpetusel põhinevaid õpetusi.

Tutorialid	TutorialName
0	Massiraadid
1	järjekorrad
2	Hoidla

Meie REST API õpetuse näites rakendame allolevaid rahustavaid tegusõnu.

1. HANGI Õpetus – Kui klient seda Restful API-t kutsub, antakse talle kogu veebiteenusest saadaolevate õpetuste komplekt.
2. HANGI Õpetus/juhend – Kui klient seda Restful API-t kutsub, antakse talle õpetuse nimi, mis põhineb kliendi saadetud õpetusel.
3. POSTITUSÕpetus/õpetuse nimi – Kui klient seda Restful API-t kutsub, saadab ta taotluse õpetuse nime lisamiseks. Seejärel lisab veebiteenus esitatud õpetuse nime kogusse.
4. KUSTUTA Õpetus/õpetusleht– Kui klient kasutab seda Restful API-t, esitab klient Õpetusprogrammil põhineva õpetuse nime kustutamise taotluse. Seejärel kustutab veebiteenus kogust esitatud õpetuse nime.

Järgime selle RESTful API õpetuse allolevaid samme, et luua meie esimesed RESTfuli veebiteenused, mis teostavad ülaltoodud juurutamist.

Kuidas luua oma esimene rahulik veebiteenus

Step 1) Loo uus projekt.
Esimene samm on tühja ruumi loomine Asp.Net Veebirakendus. Visual Studio 2013-s klõpsake menüükäsku Fail->Uus projekt.

Kui klõpsate suvandil Uus projekt, annab Visual Studio teile uue dialoogiboksi projekti tüübi valimiseks ja projekti vajalike üksikasjade esitamiseks. Seda selgitatakse selle RESTful API õpetuse järgmises etapis

Step 2) Sisestage projekti nimi ja asukoht.

1. Valige esmalt RESTfuli veebiteenused C# Veebirakenduse ASP.NET veebimall. Veebiteenuste projekti loomiseks peab projekt seda tüüpi olema. Kui valite need suvandid, viib Visual Studio seejärel läbi vajalikud toimingud vajalike failide lisamiseks, mida nõuavad mis tahes veebipõhised rakendused.
2. Andke oma projektile nimi, mis meie puhul on antud kui "Webservice.REST".
3. Seejärel määrake kindlasti koht, kuhu projektifailid salvestatakse.

Kui olete lõpetanud, näete Visual Studio 2013 lahendusuurijas loodud projektifaili.

Step 3) Looge veebiteenuse fail.
Järgmine samm on luua veebiteenuse fail, millel on veebiteenus RESTful

1. Kõigepealt paremklõpsake projekti failil, nagu allpool näidatud

2. Selles sammus
   1. Paremklõpsake projekti failil
   2. Valige suvand "Lisa-> uus üksus".

Ilmuvas dialoogiboksis peate tegema järgmist

1. Valige WCF-teenuse suvand (Ajax-toega) – valige seda tüüpi fail, see põhjustab Visual studio lisada mõni põhikood, mis aitab luua RESTfuli veebiteenust. WCF tähistab Windows KOMMUNIKATSIOON Foundation. WCF on raamatukogu erinevate platvormide või sama platvormi rakenduste jaoks, et suhelda erinevate protokollide (nt TCP, HTTP, HTTPS) kaudu. Ajax on põhimõtteliselt asünkroonne JavaScript ja XML. AJAX võimaldab veebilehti asünkroonselt värskendada, vahetades stseenide taga serveriga väikeseid andmemahtusid.
2. Järgmisena andke teenusele nimi, mis meie puhul on TutorialService.
3. Lõpuks klõpsake teenuse lahendusele lisamiseks nuppu Lisa.

Step 4) Tehke konfiguratsioon.
Järgmine samm on konfiguratsiooni muutmine, et see projekt saaks RESTfuli veebiteenustega töö lõpule viia. See nõuab faili nimega muutmist Web.config. See fail kuvatakse veebiteenuse projektifailiga samas aknas. Fail Web.config sisaldab kõiki konfiguratsioone, mis panevad veebirakenduse nii nagu peab. Tehtav muudatus võimaldab tegelikult rakendusel andmeid saata ja vastu võtta puhta RESTful veebiteenusena.

1. Koodi avamiseks klõpsake failil Web.config

2. Otsige rida

3. Muutke rida väärtuseks

Step 5) Lisage rakendamiseks meie kood.
Selle RESTful API õpetuse järgmine samm on meie koodi lisamine juurutamiseks. Kogu allpool nimetatud kood tuleb kirjutada faili TutorialService.svc

1. Esimene bitt on koodi lisamine meie andmete esitamiseks, mida meie programmis kasutatakse. Nii et meil on stringimuutujate loend, mille väärtused on "Arrays", "Queues" ja "Stacks". See tähistab meie hostimise veebiteenuse kaudu saadaolevate õpetuste nime.

namespace Webservice.REST
{
	[ServiceContract(Namespace = "")]
	[AspNetCompatibilityRequirements(RequirementsMode = AspNetCompatibilityRequirementsMode.Allowed
	public class TutorialService
	{
		private static List<String> lst = new List<String>
		(new String[] {"Arrays","Queues","Stacks"});

Step 6) Määratlege meie GET-meetodi kood.
Järgmisena määratleme oma GET-meetodi koodi. See kood asub ka samas failis TutorialService.svc. See kood töötab alati, kui me oma brauserist teenusesse helistame.

Allpool nimetatud stsenaariumi täitmiseks kasutatakse alltoodud meetodit

• Kui kasutaja soovib saadaolevate õpetuste loendit, tuleb selle tegemiseks kirjutada allolev kood.

[WebGet(UriTemplate="/Tutorial")]

public String GetAllTutorial()
{
	int count = 1st.Count;
	String TutorialList = "";
	for (int i = 0; i < count; i++)
	TutorialList = TutorialList + lst[i] + ",";
	return TutorialList;
}

Koodi selgitus: -

1. Koodi esimene rida on kõige olulisem. Seda kasutatakse selleks, et määratleda, kuidas seda meetodit URL-i kaudu kutsuda. Nii et kui link meie veebiteenusele on http://localhost:52645/TutorialService.svc ja kui lisame URL-ile "/Tutorial" as http://localhost:52645/TutorialService.svc/Tutorial , käivitatakse ülaltoodud kood. Atribuut „WebGet” on parameeter, mis võimaldab sellel meetodil olla RESTful meetod, nii et seda saab välja kutsuda verbi GET kaudu.
2. Seda koodiosa kasutatakse muutuja "lst" stringide loendi läbimiseks ja kõigi nende kutsuvasse programmi tagastamiseks.

Step 7) Tagasta väljund.
Allolev kood tagab, et kui GET-kõne tehakse õpetuse teenusele õpetuse ID-ga, tagastaks see õpetuse ID alusel vastava õpetuse nime.

[WebGet (UriTemplate = "/Tutorial/{Tutorialid}")]

public String GetTutorialbyID(String Tutorialid)
{
	int pid;
	Int32.TryParse(Tutorialid, out pid);
	return lst[pid];
}

Koodi selgitus: -

1. Koodi esimene rida on kõige olulisem. Seda kasutatakse selleks, et määratleda, kuidas seda meetodit URL-i kaudu kutsuda. Nii et kui link meie veebiteenusele on http://localhost:52645/TutorialService.svc ja kui lisame URL-ile '/Tutorial/{Tutorialid}', saaksime veebiteenust kutsuda http://localhost:52645/TutorialService.svc/Tutorial/1 näitena. Seejärel peaks veebiteenus tagastama õpetuse nime, millel oli õpetuse ID#1.
2. Seda koodiosa kasutatakse õpetuse nime tagastamiseks, mille õpetuse ID edastatakse veebimeetodile.

• Vaikimisi tuleb meeles pidada, et kõik, mis brauseris URL-ile edastatakse, on string.
• Kuid peate meeles pidama, et meie loendi indeks peab olema täisarv, seega lisame vajaliku koodi, et esmalt teisendada Tutorialid täisarvuks ja seejärel kasutada seda meie loendi indeksi positsioonile juurdepääsuks ja
• Seejärel tagastage väärtus vastavalt kutsuvale programmile.

Step 8) Kirjutage POST-meetodi kood.
Järgmine samm on meie POST-meetodi koodi kirjutamine. Seda meetodit kasutatakse alati, kui tahame POST-meetodi abil oma õpetuste loendisse stringiväärtust lisada. Näiteks kui soovite lisada õpetuse nime "Tarkvara testimine", peaksite kasutama POST-meetodit.

Koodi selgitus: -

1. Esimene rida on atribuut „WebInvoke”, mis on lisatud meie meetodile. See võimaldab meetodit käivitada POST-kutse kaudu. Atribuudid RequestFormat ja ResponseFormat tuleb mainida kui JSON, kuna RESTFul-i veebiteenusesse väärtuste postitamisel peavad väärtused olema selles vormingus.
2. Teist koodirida kasutatakse POST-kutse kaudu edastatud stringi väärtuse lisamiseks meie olemasolevasse õpetuse stringide loendisse.

Step 9) Lisage toimingu DELETE käsitlemiseks meetod.
Lõpuks lisame oma meetodi toimingu DELETE käsitlemiseks. Seda meetodit kasutatakse alati, kui soovime kustutada olemasoleva stringi väärtuse oma õpetuste loendist meetodi DELETE kaudu.

[WebInvoke(Method = "DELETE", RequestFormat = WebMessageFormat.Json,
	UriTemplate = "/Tutorial/{Tutorialid}", ResponseFormat = WebMessageFormat.Json,
	BodyStyle = WebMessageBodyStyle.Wrapped)]
	
public void DeleteTutorial(String Tutorialid)
{
	int pid;
	Int32.TryParse(Tutorialid, out pid);
	1st.RemoveAt(pid);
}

Koodi selgitus: -

1. Esimene rida on atribuut „WebInvoke”, mis on lisatud meie meetodile. See võimaldab meetodit käivitada POST-kutse kaudu. Atribuudid RequestFormat ja ResponseFormat tuleb mainida kui JSON, kuna RESTFul-i veebiteenusesse väärtuste postitamisel peavad väärtused olema selles vormingus. Pange tähele, et parameetri meetod on seatud väärtusele "DELETE". See tähendab, et alati, kui väljastame tegusõna DELETE, käivitatakse see meetod.
2. Teist koodirida kasutatakse DELETE-kõne kaudu saadetud Tutorialidi võtmiseks ja seejärel selle ID meie loendist kustutamiseks. ( Intxnumx koodi funktsiooni kasutatakse õpetuse ID teisendamiseks stringi muutujast täisarvuks).

Käitate oma esimest Restfuli veebiteenust

Nüüd, kui oleme ülaltoodud jaotises loonud kogu oma veebiteenuse. Vaatame, kuidas saame teenust Tutorial käivitada nii, et seda saaks käivitada mis tahes kliendilt.

Veebiteenuse käitamiseks järgige alltoodud samme

Step 1) Paremklõpsake projekti failil – Webservice.REST

Step 2) Valige menüükäsk 'Määra käivitusprojektiks'. See tagab selle projekti käivitamise, kui Visual Studio käitab kogu lahendust

Step 3) Järgmine samm on projekti enda käivitamine. Nüüd, olenevalt süsteemi installitud vaikebrauserist, ilmub Visual Studio käivitamisnupu kõrvale sobiv brauseri nimi. Meie puhul on meil Google Chrome ilmumas. Lihtsalt klõpsake sellel nupul.

Väljund:-

Kui projekt on käivitatud, saate sirvida jaotist TutorialService.svc/Tutorial ja näete allolevat väljundit.

Ülaltoodud väljundis

• Näete, et brauser kutsub esile verbi „GET” ja käivitab veebiteenuses meetodi „GetAllTutorial”. Seda moodulit kasutatakse kõigi meie veebiteenuse avaldatud õpetuste kuvamiseks.

Testime oma esimest Restfuli veebiteenust

Ülaltoodud jaotises oleme juba näinud, kuidas kasutada brauserit sõna „GET” käivitamiseks ja „GetAllTutoriali” käivitamiseks.

1. Kasutame nüüd brauserit järgmise kasutusjuhtumi stsenaariumi täitmiseks.

GET Tutorial/Tutorialid – kui klient seda Restful API-t kutsub, antakse talle õpetuse nimi, mis põhineb kliendi saadetud õpetusel.

Lisage brauseris string /1 URL-is õpetussõna järele. Kui vajutate sisestusnuppu, saate alloleva väljundi

Nüüd näete järjekordade väljundit, mis tegelikult vastab numbrile 1 meie õpetuse stringide loendis. See tähendab, et meetod „GetTutorialbyID” käivitatakse nüüd meie veebiteenusest. Samuti näitab see, et väärtus 1 edastatakse brauseri kaudu edukalt meie veebiteenusele ja meie meetodile ning seetõttu saame brauseris õige vastava väärtuse “Järjed”.

2. Järgmisena tarbime oma veebiteenust, täites alloleva stsenaariumi. Selleks peate installima tööriista nimega "Fiddler”, mis on saidilt tasuta allalaaditav tööriist.

POST-i õpetus/õpetuse nimi – kui klient seda Restful API-t kutsub, saadab klient õpetuse nime sisestamise taotluse. Seejärel lisab veebiteenus esitatud õpetuse nime kogusse.

Käivitage Filddleri tööriist ja tehke alltoodud toimingud;

1. Minge helilooja jaotisesse. Seda kasutatakse taotluste loomiseks, mida saab esitada mis tahes veebirakendusele.
2. Veenduge, et päringu tüüp on „POSTITUS” ja tabatakse õiget URL-i, mis meie puhul peaks olema http://localhost:52645/TutorialService.svc/Tutorial
3. Veenduge, et sisu tüüp oleks märgitud rakenduseks/json-iks. Pidage meeles, et meie veebiteenuse POST-päringu meetod aktsepteerib ainult json-stiili andmeid, nii et peame tagama, et see oleks täpsustatud, kui saadame oma rakendusele päringu.
4. Lõpuks peame sisestama oma andmed. Pidage meeles, et meie meetod POST-i jaoks aktsepteerib parameetrit nimega str. Seega täpsustame siin, et tahame oma õpetuse nimede kogusse lisada väärtuse nimega "Puud" ja tagada, et see oleks sildistatud muutuja nimega str.

Lõpuks klõpsake lihtsalt viiuldaja nupul Käivita. Sellega saadetakse veebiteenusele taotlus POSTADA andmed “Puud” meie veebiteenusesse.

Nüüd, kui sirvime õpetuse URL-i, et kuvada kõik meie õpetuste loendis olevad stringid, näete nüüd, et "Puud" on samuti olemas. See näitab, et POST-i päring veebiteenusele täideti edukalt ja see lisati edukalt meie õpetuste loendisse.

3. Järgmisena tarbime oma veebiteenust, täites alloleva stsenaariumi. Selleks peame kasutama ka viiuldaja tööriista

DELETE Tutorial/Jutorialid – kui klient seda Restful API-t kutsub, esitab klient õpetuse nimetuse kustutamise taotluse. Seejärel kustutab veebiteenus kogust esitatud õpetuse nime.

Käivitage tööriist Filddler ja tehke alltoodud toimingud

1. Minge helilooja jaotisesse. Seda kasutatakse taotluste loomiseks, mida saab esitada mis tahes veebirakendusele.
2. Veenduge, et päringu tüüp on "DELETE" ja tabatakse õiget URL-i, mis meie puhul peaks olema http://localhost:52645/TutorialService.svc/Tutorial. Veenduge, et id, mida kasutatakse stringi kustutamiseks loendis, saadetakse URL-i kaudu parameetrina. Meie näites REST saadame 1, nii et see kustutab 2^nd element meie kollektsioonis, milleks on "Järjekorrad".

Lõpuks klõpsake lihtsalt viiuldaja nupul Käivita. Sellega saadetakse veebiteenusele taotlus meie veebiteenuse „Järjekordade“ andmete KUSTUTAMISEKS.

Nüüd, kui sirvime õpetuse URL-i, et kuvada kõik meie õpetuste loendis olevad stringid, märkate, et järjekorra väärtust pole enam olemas.

See näitab, et veebiteenuse DELETE taotlus täideti edukalt. Meie õpetuste stringide loendis indeksi number 1 olev element kustutati edukalt.

kokkuvõte

• REST tähistab REpresentational State Transfer. REST-i kasutatakse veebiteenuste loomiseks, mis on oma olemuselt kerged, hooldatavad ja skaleeritavad.
• Üha enam rakendusi liigub Restfuli arhitektuurile. Selle põhjuseks on asjaolu, et praegu kasutab palju inimesi mobiilseadmeid ja laiemat valikut rakendusi, mis liiguvad pilve.
• REST-i peamised aspektid on serveris asuvad ressursid ja tegusõnad GET, POST, PUT ja DELETE, mida saab nende ressurssidega töötamiseks kasutada.
• Visual Studio ja.Neti abil saab luua Restfuli veebiteenuseid.
• Kui Testimine POST-i ja PUT-i veebiteenuste jaoks peate kasutama teist tööriista nimega fiddler, mida saab kasutada POST- ja PUT-päringu serverisse saatmiseks.