RESTful veebiteenuste õpetus REST API näitega

Lang L: none (table-of-contents):

Anonim

Mis on rahulikud veebiteenused?

Restful Web Services on kerge, hooldatav ja skaleeritav teenus, mis on üles ehitatud REST arhitektuurile. Rahulik veebiteenus, eksponeerige oma rakenduse API helistava kliendi jaoks turvaliselt, ühetaoliselt ja kodakondsuseta. Helistav klient saab teenuse Restful abil teha etteantud toiminguid. REST-i aluseks olev protokoll on HTTP. REST tähistab riiki REpresentational State Transfer.

Selles REST API õpetuses saate teada

  • PUHATUD võtmeelemendid
  • Rahustavad meetodid
  • Miks rahulik
  • Rahustav arhitektuur
  • RestFul põhimõtted ja piirangud
  • Looge oma esimene rahulik veebiteenus ASP.NET-is
  • Oma esimese rahuliku veebiteenuse käitamine
  • Oma esimese rahuliku veebiteenuse testimine

PUHATUD võtmeelemendid

Veebiteenused REST on selle loomisest saadik tõesti kaugele jõudnud. 2002. aastal oli veebikonsortsium avaldanud WSDL ja SOAP veebiteenuste definitsiooni. See moodustas standardi, kuidas veebiteenuseid rakendatakse.

2004. aastal avaldas veebikonsortsium ka täiendava standardi RESTful definitsiooni. Paari viimase aasta jooksul on see standard muutunud üsna populaarseks. Ja seda kasutavad paljud populaarsed veebisaidid kogu maailmas, 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, pilte või videoid. Kõik need on ressursside näide. Kui klient, ütleme, et veebibrauser vajab mõnda neist ressurssidest, peab ta nendele ressurssidele juurdepääsu saamiseks serverile päringu saatma. Nüüd määravad REST-teenused viisi, kuidas nendele ressurssidele juurde pääseda.

RESTfuli rakendamise põhielemendid on järgmised:

  1. Ressursid - esimene põhielement on ressurss ise. Oletame, et serveris asuvas veebirakenduses on mitme töötaja andmed. Oletame, et veebirakenduse URL on http://demo.guru99.com . Nüüd, et REST-teenuste kaudu pääseda juurde töötaja kirjete ressursile, võib välja anda käsu http://demo.guru99.com/employee/1 - see käsk ütleb veebiserverile, et palun esitage selle töötaja andmed, kelle töötaja number on 1.

  2. Päringu verbid - need kirjeldavad, mida soovite ressursiga teha. Brauser väljastab GET-verbi, et juhendada lõpp-punkti, kuhu ta soovib andmeid hankida. Siiski on saadaval palju muid verbe, sealhulgas POST, PUT ja DELETE. Nii et näite http://demo.guru99.com/employee/1 puhul annab veebibrauser tegelikult välja GET-verbi, kuna soovib saada töötaja kirje üksikasju.

  3. Taotluse päised - need on päringuga saadetud täiendavad juhised. Need võivad määratleda nõutava vastuse tüübi või autoriseerimise üksikasjad.

  4. Taotluse keha - andmed saadetakse koos päringuga. Andmed saadetakse päringus tavaliselt siis, kui POST-taotlus tehakse veebiteenustele REST. POST-kõnes ütleb klient tegelikult veebiteenustele REST, et soovib serverile ressurssi lisada. Seega oleks päringu kehal üksikasjad ressursi kohta, mis on vajalik serverisse lisamiseks.

  5. Reageerimiskeha - see on vastuse põhiosa. Nii et meie RESTful API näites peaksime veebiserverile päringu tegema päringu http://demo.guru99.com/employee/1 kaudu , võib veebiserver tagastada XML-dokumendi koos kõigi töötaja üksikasjadega vastuses Keha.

  6. Vastuse olekukoodid - need koodid on üldised koodid, mis tagastatakse koos veebiserveri vastusega. Näiteks on kood 200, mis tavaliselt tagastatakse, kui kliendile vastuse tagastamisel pole viga.

Rahustavad meetodid

Alloleval diagrammil on enamasti näidatud kõik tegusõnad (POST, GET, PUT ja DELETE) ning REST API näide nende tähendusest.

Oletame, et meil on asukohas määratletud RESTful veebiteenus. http://demo.guru99.com/töötaja . Kui klient esitab sellele veebiteenusele mis tahes taotluse, saab ta määrata mis tahes tavalise HTTP-verbi GET, POST, DELETE ja PUT. Allpool on, mis juhtuks, kui vastavad verbid saadaks klient.

  1. POST - seda kasutatakse uue töötaja loomiseks, kasutades veebiteenust RESTful
  2. GET - seda kasutatakse kõigi RESTfuli veebiteenust kasutavate töötajate nimekirja saamiseks
  3. PUT - seda kasutatakse kõigi töötajate värskendamiseks, kasutades veebiteenust RESTful
  4. KUSTUTA - seda kasutatakse kõigi RESTfuli teenuseid kasutavate töötajate kustutamiseks

Vaatame vaid ühe plaadi perspektiivist. Oletame, et oli olemas töötaja kirje töötaja numbriga 1.

Järgmistel toimingutel oleks oma tähendus.

  1. POST - see ei oleks rakendatav, kuna me toome töötaja 1 andmeid, mis on juba loodud.
  2. GET - seda kasutatakse töötaja nr 1 töötaja üksikasjade saamiseks RESTful veebiteenuse abil
  3. PUT - seda kasutatakse töötaja nr 1 töötaja üksikasjade värskendamiseks, kasutades veebiteenust RESTful
  4. KUSTUTA - seda kasutatakse töötaja andmete kustutamiseks töötaja nr 1 korral

Miks rahulik

Rahulik sai populaarseks peamiselt järgmistel põhjustel:

  1. Heterogeensed keeled ja keskkonnad - see on üks põhilisi põhjuseid, mis on sama, mida oleme näinud ka SOAP-i puhul.
  • See võimaldab erinevatele programmeerimiskeeltele ehitatud veebirakendustel omavahel suhelda
  • Teenuse Restful abil saavad need veebirakendused asuda erinevates keskkondades, mõned võivad olla Windowsis ja teised Linuxis.

Kuid lõpuks, olenemata keskkonnast, peaks lõpptulemus olema alati sama, et nad peaksid saama omavahel rääkida. Rahulikud veebiteenused pakuvad seda paindlikkust erinevatele programmeerimiskeeltele ja platvormidele ehitatud rakendustele, et omavahel rääkida.

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

Kui kliendirakendus peaks töötama selliste saitidega nagu Facebook, Twitter jne, peaksid nad tõenäoliselt teadma, mis on Facebooki, Google'i ja Twitteri keel ning millele platvormil nad on üles ehitatud.

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

Facebook, Twitter ja Google paljastavad oma funktsionaalsuse Restfuli veebiteenuste näol. See võimaldab igal kliendirakendusel nendele veebiteenustele RESTi kaudu helistada.

  1. Seadmete sündmus - tänapäeval peab kõik toimima mobiilseadmetes, olgu see siis mobiilseade, märkmikud või isegi autosüsteemid.

    Kas te kujutate ette, kui palju on vaja proovida nende seadmete rakendusi kodeerida, et tavaliste veebirakendustega rääkida? Jällegi saavad rahulikud API-d selle töö lihtsamaks muuta, sest nagu punktis 1 mainitud, ei pea te tõesti teadma, mis on seadme aluseks olev kiht.

  2. Lõpuks on pilve sündmus - kõik liigub pilve. Rakendused liiguvad aeglaselt pilvepõhistesse süsteemidesse nagu Azure või Amazon. Azure ja Amazon pakuvad palju Restfuli arhitektuuril põhinevaid API-sid. Seega tuleb rakendused nüüd välja töötada nii, et need oleksid pilvega ühilduvad. Nii et kuna kõik pilvepõhised arhitektuurid töötavad REST-i põhimõttel, on mõistlikum, kui veebiteenused programmeeritakse REST-teenustel põhineva arhitektuuri abil, et pilvepõhiseid teenuseid kõige paremini ära kasutada.

Rahustav arhitektuur

RESTful- või REST-stiilis rakendusel või arhitektuuril on järgmised omadused

  1. Olek ja funktsionaalsus on jagatud hajutatud ressurssideks - see tähendab, et kõik ressursid peaksid olema juurdepääsetavad tavaliste HTTP-käskude GET, POST, PUT või DELETE kaudu. Nii et kui keegi soovib faili serverist hankida, peaks tal olema võimalus GET-taotlus väljastada ja fail hankida. Kui nad soovivad faili serverisse panna, peaksid nad saama POST- või PUT-päringu väljastada. Ja lõpuks, kui nad tahtsid faili serverist kustutada, väljastavad nad DELETE päringu.
  2. Arhitektuur on klient / server, kodakondsuseta, kihiline ja toetab vahemällu salvestamist -
  • Kliendiserver on tüüpiline arhitektuur, kus serveriks võib olla rakendust majutav veebiserver ja klient võib olla sama lihtne kui veebibrauser.
  • Kodakondsuseta tähendab, et rakenduse olekut REST-is ei säilitata.

    Näiteks kui kustutate ressursi serverist käsuga DELETE, ei saa eeldada, et kustutamisteave edastatakse järgmisele taotlusele.

    Ressursi kustutamise tagamiseks peate väljastama GET-päringu. GET-päringut kasutatakse kõigepealt kõigi serveris olevate ressursside hankimiseks. Pärast seda peaks nägema, kas ressurss on tegelikult kustutatud.

RESTFul põhimõtted ja piirangud

REST-arhitektuur põhineb mõnel allpool välja töötatud tunnusel. Iga RESTful veebiteenus peab vastama allpool toodud omadustele, et seda saaks nimetada RESTful. Neid omadusi nimetatakse ka disainiprintsiipideks, mida tuleb RESTful-põhiste teenustega töötamisel järgida.

  1. RESTFul klient-server

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

  1. Kodakondsuseta

Kodakondsuseta mõiste tähendab, et kogu nõutava teabe serverisse edastamise kohustus on klient. See on vajalik, et server saaks vastust asjakohaselt töödelda. Server ei tohiks kliendi päringute vahel säilitada mingisugust teavet. See on väga lihtne sõltumatu küsimuste-vastuste jada. Klient esitab küsimuse, server vastab sellele asjakohaselt. Klient küsib veel ühe küsimuse. Server ei mäleta eelmist küsimuse-vastuse stsenaariumi ja peab uuele küsimusele iseseisvalt vastama.

  1. Vahemälu

Vahemälu kontseptsiooni eesmärk on aidata kodakondsuseta isiku probleemi, mida kirjeldati viimases punktis. Kuna iga serveri klienditaotlus on oma olemuselt sõltumatu, võib mõnikord klient serverilt sama päringu uuesti küsida. Seda isegi siis, kui ta oli seda juba varem palunud. See taotlus läheb serverile ja server annab vastuse. See suurendab liiklust kogu võrgus. Vahemälu on klienti rakendatud mõiste serverisse juba saadetud päringute salvestamiseks. Nii et kui sama päringu esitab klient, läheks see serverisse minemise asemel vahemällu ja saaks vajaliku teabe. See säästab võrguliikluse hulka kliendi ja serveri vahel.

  1. Kihiline süsteem

Kihilise süsteemi mõte on see, et kliendi ja RESTFuli veebiteenust majutava serveri vahele saab lisada mis tahes täiendava kihi, näiteks vahevara kihi (vahevara kiht on see, 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.

  1. Liides / ühtne leping

See on RESTfuli veebiteenuste toimimise aluseks olev tehnika. RESTful töötab põhimõtteliselt HTTP veebikihil ja kasutab allpool olevaid verbe serveris ressurssidega töötamiseks

  • POST - serveris ressursi loomiseks
  • GET - ressursi hankimine serverist
  • PUT - ressursi oleku muutmiseks või selle värskendamiseks
  • KUSTUTA - serverist ressursi eemaldamiseks või kustutamiseks

Looge oma esimene rahulik veebiteenus ASP.NET-is

Selles REST API õpetuses õpime, kuidas luua ASP.NETis rahulikku veebiteenust:

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

Selles RESTful API näites loome Visual Studio abil oma REST-i rakenduse .Net-is. Oma näites jäljendame Restfuli veebiteenuste puhul järgmist REST-teenuse näidet.

Meil on rahulik veebiteenus, mis töötab allpool toodud andmekogumiga.

Allolev andmekogum esindab REST API näidet ettevõtte olemasolu kohta, kes paljastab õpetuse, mille neil on Tutorialidi põhjal.

Juhendaja TutorialName
0 Massiivid
1 Järjekorrad
2 Virnad

Rakendame oma REST API juhendaja näites allpool toodud rahulikke verbe.

  1. Hangi õpetus - kui klient kutsub seda Restful API-d, antakse talle kogu veebiteenuses saadaval olev õpetuste komplekt.
  2. Hangi juhendaja / juhendaja - kui klient kutsub selle Restful API-le, antakse talle kliendi saadetud juhendajale tuginedes õpetuse nimi.
  3. POST-õpetus / õpetuse nimi - kui klient kutsub selle Restfuli API-d, esitab klient õpetuse nime sisestamise taotluse. Veebiteenus lisab seejärel kogumisse esitatud õpetuse nime.
  4. KUSTUTA õpetus / õpetus - kui klient kutsub seda Restful API-d, esitab klient õpetuse nime kustutamise taotluse. Veebiteenus kustutab seejärel esitatud õpetuse nime kogust.

Järgime selle RESTful API õpetuse allolevaid samme, et luua meie esimene RESTful veebiteenus, mis viib läbi ülaltoodud rakenduse.

Samm 1) Esimene samm on luua tühi Asp.Net veebirakendus. Klõpsake Visual Studio 2013-s menüüvalikut 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

2. samm. Selles etapis

  1. Valige esmalt ASP.NET-i veebirakenduse RESTful veebiteenuste C # veebimall. Veebiteenuste projekti loomiseks peab projekt olema seda tüüpi. Selle suvandi valimisega teeb Visual Studio vajalikud toimingud kõigi veebipõhiste rakenduste jaoks nõutavate failide lisamiseks.
  2. Pange oma projektile nimi, mis on antud juhul "Webservice.REST".
  3. Seejärel veenduge, et annate asukoha, kuhu projekti failid salvestatakse.

Kui olete valmis, näete Visual Studio 2013 oma lahenduste avastajaga loodud projektifaili.

Samm 3) Järgmine samm on luua veebiteenuse fail, millel on RESTful veebiteenus

  1. Kõigepealt paremklõpsake projektifailil, nagu allpool näidatud
  1. Selles etapis
    1. Paremklõpsake projekti failil
    2. Valige suvand "Lisa-> uus üksus".

Ilmuvas dialoogiboksis peate tegema järgmist

  1. Valige suvand WCF Service (Ajax-toega) - valige seda tüüpi fail, see paneb Visual studio lisama põhikoodi, mis aitab luua RESTful veebiteenuse. WCF tähistab Windowsi kommunikatsioonifondi. WCF on raamatukogu erinevate platvormide või sama platvormi rakenduste jaoks, et suhelda erinevate protokollide, näiteks TCP, HTTP, HTTPS, kaudu. Ajax on põhimõtteliselt asünkroonne JavaScripti ja XML. AJAX võimaldab veebilehtede asünkroonset värskendamist, vahetades kulisside taga serveriga väikeseid andmehulki.
  2. Järgmisena andke teenusele nimi, mis on meie puhul TutorialService.
  3. Lõpuks klõpsake teenuse lisamiseks lahendusse nuppu Lisa.

4. samm. Järgmine samm on tegelikult konfiguratsiooni muutmine, et projekt saaks RESTfuli veebiteenustega lõpule viia. Selleks on vaja muuta faili nimega Web.config . See fail kuvatakse Webservice'i projektifailiga samas aknas. Fail Web.config sisaldab kõiki konfiguratsioone, mis muudavad veebirakenduse toimima nii, nagu peaks. Tehtud muudatus võimaldab rakendusel andmeid saata ja vastu võtta puhta RESTful veebiteenusena.

  1. Koodi avamiseks klõpsake failil Web.config
  1. Leidke reale
  1. Muutke rida

5. samm. Selle RESTful API õpetuse järgmine samm on meie koodi lisamine rakendamiseks. Kõik allpool nimetatud kood tuleb kirjutada faili TutorialService.svc

  1. Esimene bitt on lisada kood, mis tähistab meie andmeid, mida meie programmis kasutatakse. Nii et meil on nimekiri stringimuutujatest väärtustega "Massiivid", "Järjekorrad" ja "Virnad". See tähistab meie hostimise veebiteenuse kaudu saadaval olevat õpetuste nime.
namespace Webservice.REST{[ServiceContract(Namespace = "")][AspNetCompatibilityRequirements(RequirementsMode = AspNetCompatibilityRequirementsMode.Allowedpublic class TutorialService{private static List  lst = new List  (new String[] {"Arrays","Queues","Stacks"});

Samm 6) Järgmisena määratleme oma GET-meetodi koodi. See kood asub ka samas TutorialService.svc failis. See kood töötab alati, kui helistame teenusele oma brauserist.

Allpool nimetatud stsenaariumi täitmiseks kasutatakse järgmist meetodit

  • Kui kasutaja soovib kõigi saadaolevate õpetuste loendit, tuleks selle saavutamiseks 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. Esimene koodirida 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' kui http: // localhost: 52645 / TutorialService.svc / Tutorial , siis ülaltoodud kood kutsutakse. 'WebGet' atribuut on parameeter, mis võimaldab sellel meetodil olla RESTful meetod, et seda saaks kasutada GET-verbi kaudu.
  2. Seda koodijaotist kasutatakse muutuja 'lst' stringide loendi läbimiseks ja kõigi nende tagasisaatmiseks helistamisprogrammi.

Samm 7) Alltoodud kood tagab, et kui GET-kõne tehakse õppeteenusele koos juhendaja ID-ga, tagastaks see vastava õpetuse nime, mis põhineb õpetuse ID-l.

[WebGet (UriTemplate = "/Tutorial/{Tutorialid}")]public String GetTutorialbyID(String Tutorialid){int pid;Int32.TryParse(Tutorialid, out pid);return lst[pid];}

Koodi selgitus: -

  1. Esimene koodirida 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}', siis saaksime veebiteenusele helistada kui http: //localhost:52645/TutorialService.svc/Tutorial/1 näitena. Veebiteenus peaks seejärel tagastama õpetuse nime, millel oli õpetuse ID nr 1.
  2. Seda koodijaotust kasutatakse tagastamiseks "Õpetuse nimi", 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 register peab olema täisarv, nii et lisame vajaliku koodi, et kõigepealt teisendada Tutorialid täisarvuks ja seejärel kasutada seda loendis oleva indeksi positsiooni saamiseks ja
  • Seejärel tagastage väärtus vastavalt helistamisprogrammile.

8. samm. Järgmine samm on meie POST-meetodi koodi kirjutamine. Seda meetodit kasutatakse alati, kui soovime POST-meetodi abil oma õpetuste loendisse lisada stringi väärtuse. Näiteks kui soovite lisada õpetuse nime „Tarkvara testimine”, peate kasutama POST-meetodit.

Koodi selgitus: -

  1. Esimene rida on atribuut 'WebInvoke', mis on lisatud meie meetodile. See võimaldab meetodile tugineda POST-kõne kaudu. Atribuuti RequestFormat ja ResponseFormat tuleb mainida kui JSON, kuna RESTFuli veebiteenusesse väärtuste postitamisel peavad väärtused olema selles vormingus.
  2. Teist koodirida kasutatakse POST-kõne kaudu edastatud stringi väärtuse lisamiseks meie olemasolevasse juhendamisstringide loendisse.

9. samm. Lõpuks lisame oma meetodi KUSTUTAMISE käsitsemiseks. Seda meetodit kasutatakse alati, kui soovime olemasoleva stringi väärtuse õpetuste loendist DELETE meetodi abil kustutada.

[WebInvoke(Method = "DELETE", RequestFormat = WebMessageFormat.Ison,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 meetodile tugineda POST-kõne kaudu. Atribuuti RequestFormat ja ResponseFormat tuleb mainida kui JSON, kuna väärtuste postitamisel RESTFuli veebiteenusele peavad väärtused olema selles vormingus. Pange tähele, et parameetri Method väärtuseks määratakse "DELETE". See tähendab, et alati, kui väljastame verbi DELETE, kasutatakse seda meetodit.
  2. Teist koodirida kasutatakse DELETE kõne kaudu saadetud juhendaja ID võtmiseks ja seejärel selle ID kustutamiseks meie loendist. ( Koodis olevat funktsiooni Int32 kasutatakse õpetuse ID teisendamiseks stringimuutujast täisarvuks).

Oma esimese rahuliku veebiteenuse käitamine

Nüüd, kui oleme ülaltoodud jaotises loonud kogu oma veebiteenuse. Vaatame, kuidas saame õpetusteenust käivitada, et seda saaks kasutada igalt kliendilt.

Veebiteenuse käitamiseks toimige järgmiselt

Samm 1) Paremklõpsake projekti failil - Webservice.REST

Samm 2) Valige menüüvalik „Set as StartUp Project”. See tagab selle projekti käivitamise, kui Visual Studio töötab kogu lahenduse

3. samm. Järgmine samm on projekti enda käivitamine. Nüüd, sõltuvalt süsteemi installitud vaikebrauserist, tuleb Visual Studio käivitamisnupu kõrvale sobiv brauseri nimi. Meie puhul kuvatakse Google Chrome. Klõpsake lihtsalt seda nuppu.

Väljund: -

Kui projekt on käivitatud, saate sirvida jaotisse TutorialService.svc / Tutorial ja saate allpool oleva väljundi.

Ülaltoodud väljundis

  • Näete, et brauser kutsub verbi 'GET' ja täidab veebiteenuses meetodit 'GetAllTutorial'. Seda moodulit kasutatakse kõigi meie veebiteenuse pakutavate õpetuste kuvamiseks.

Oma esimese rahuliku veebiteenuse testimine

Ülaltoodud jaotises oleme juba näinud, kuidas kasutada brauserit verbi "GET" käivitamiseks ja "GetAllTutoriali" käivitamiseks.

  1. Kasutame nüüd järgmise brauseri stsenaariumi käivitamiseks brauserit.

Hangi õpetus / õpetus - kui klient kutsub selle Restful API-le, antakse talle kliendi saadetud juhendajale põhineva õpetuse nimi

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

Nüüd näete järjekordade väljundit, mis vastab tegelikult meie õpetusstringide loendi numbrile 1. See tähendab, et nüüd kasutatakse meie veebiteenusest meetodit GetTutorialbyID. See näitab ka seda, et 1 väärtus edastatakse brauseri kaudu edukalt meie veebiteenusele ja meie meetodile ning seetõttu saame brauseris õige vastava väärtuse "Järjekorrad".

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

POST-õpetus / õpetuse nimi - kui klient kutsub selle Restfuli API-d, esitab klient õpetuse nime sisestamise taotluse. Veebiteenus lisab seejärel kogumisse esitatud õpetuse nime.

Käivitage tööriist Filddler ja tehke järgmised toimingud;

  1. Minge helilooja jaotisse. Seda kasutatakse taotluste loomiseks, mida saab esitada igasse veebi

    rakendus.

  2. Veenduge, et päringu tüüp on "POST" ja tabatakse õiget URL-i, mis peaks meie puhul olema http: // localhost: 52645 / TutorialService.svc / Tutorial
  3. Veenduge, et sisutüübiks on märgitud rakendus / json. Pidage meeles, et meie POST-i päringumeetod meie veebiteenuses aktsepteerib ainult JSON-i stiilis andmeid, seega peame tagama, et see oleks täpsustatud, kui saadame oma rakendusele päringu.
  4. Lõpuks peame sisestama oma andmed. Pidage meeles, et meie POST-i meetod aktsepteerib parameetrit nimega "str". Nii et siin täpsustame, et soovime oma õpetuste nimede kogusse lisada väärtuse nimega "Puud" ja tagada, et see oleks märgitud str muutuja nimele.

Lõpuks klõpsake lihtsalt viiulil nuppu Execute. See saadab veebiteenusele päringu, et POSTIDA andmed "Puud" meie veebiteenusele.

Nüüd, kui sirvime õpetuse URL-i, et kuvada kõik meie õpetuste loendis olevad stringid, näete nüüd ka väärtuse "Puud" olemasolu. See näitab, et veebiteenuse POST-taotlus täideti edukalt ja see lisati edukalt meie õpetuste loendisse.

  1. Järgmisena tarbime oma veebiteenust, käivitades alloleva stsenaariumi. Selleks peame kasutama ka viiulitööriista

KUSTUTA õpetus / õpetus - kui klient kutsub seda Restful API-d, esitab klient õpetuse nime kustutamise taotluse. Veebiteenus kustutab seejärel esitatud õpetuse nime kogust.

Käivitage tööriist Filddler ja toimige järgmiselt

  1. Minge helilooja jaotisse. Seda kasutatakse taotluste loomiseks, mida saab esitada igasse veebi

    rakendus.

  2. Veenduge, et päringu tüüp on "KUSTUTA" ja tabatakse õiget URL-i, mis peaks meie puhul olema http: // localhost: 52645 / TutorialService.svc / Tutorial . Veenduge, et URL-i kaudu parameetrina saadetud loendi stringi kustutamiseks kasutatav ID. Meie REST näites saadame ühe, nii et see kustutab meie kollektsiooni teise elemendi "Järjekorrad".

Lõpuks klõpsake lihtsalt viiulil nuppu Execute. See saadab veebiteenusele taotluse kustutada andmed "Järjekorrad" meie veebiteenusele.

Nüüd, kui sirvime õpetuse URL-i, et näidata kõiki meie õpetuste loendis olevaid stringe, märkate, et "Järjekordade" väärtust enam pole.

See näitab, et veebiteenuse DELETE taotlus on edukalt täidetud. Meie õpetusstringide loendi indeksis nr 1 olev element kustutati edukalt.

Kokkuvõte

  • REST tähistab riiki REpresentational State Transfer. REST-i kasutatakse kergete, hooldatavate ja mastaapsete veebiteenuste loomiseks.
  • Üha rohkem rakendusi liigub arhitektuuri Restful juurde. Seda seetõttu, et praegu on palju inimesi, kes kasutavad mobiilseadmeid ja laiemat valikut rakendusi, mis pilve liiguvad.
  • RESTi põhiaspektideks on serveris asuvad ressursid ning verbid GET, POST, PUT ja DELETE, mida saab kasutada nende ressurssidega töötamiseks.
  • Visual Studio ja.Net saab kasutada Restful veebiteenuste loomiseks.
  • Veebiteenuste POST ja PUT testimisel peate kasutama teist tööriista nimega fiddler, mida saab kasutada POST- ja PUT-päringute serverile saatmiseks.