Vadnica za spletne storitve RESTful z zgledom API-ja REST

Kazalo:

Anonim

Kaj so spletne storitve Restful?

Restful Web Services je lahka, vzdrževalna in razširljiva storitev, ki temelji na arhitekturi REST. Skrbna spletna storitev, izpostavljajte API iz svoje aplikacije na varen, enoten način brez državljanstva kličečemu odjemalcu. Klicni odjemalec lahko izvaja vnaprej določene operacije s storitvijo Restful. Temeljni protokol za REST je HTTP. REST pomeni zastopniški državni prenos.

V tej vadnici API REST boste izvedeli-

  • RESTful ključni elementi
  • Spokojne metode
  • Zakaj miren
  • Spokojna arhitektura
  • Načela in omejitve RestFul
  • Ustvarite svojo prvo spletno storitev Restful v ASP.NET
  • Zagon vaše prve spletne storitve Restful
  • Testiranje vaše prve spletne storitve Restful

RESTful ključni elementi

Spletne storitve REST so od svojega začetka resnično daleč daleč. Leta 2002 je spletni konzorcij objavil definicijo spletnih storitev WSDL in SOAP. To je oblikovalo standard izvajanja spletnih storitev.

Leta 2004 je spletni konzorcij objavil tudi definicijo dodatnega standarda, imenovanega RESTful. V zadnjih nekaj letih je ta standard postal zelo priljubljen. Uporabljajo ga številna priljubljena spletna mesta po svetu, med katerimi sta Facebook in Twitter.

REST je način za dostop do virov, ki ležijo v določenem okolju. Na primer, lahko imate strežnik, ki bi lahko gostil pomembne dokumente ali slike ali videoposnetke. Vse to so primer virov. Če odjemalec, recimo, da spletni brskalnik potrebuje katerega koli od teh virov, mora strežniku poslati zahtevo za dostop do teh virov. Zdaj storitve REST opredeljujejo način dostopa do teh virov.

Ključni elementi izvedbe RESTful so naslednji:

  1. Viri - prvi ključni element so viri sami. Predpostavimo, da ima spletna aplikacija na strežniku evidenco več zaposlenih. Predpostavimo, da je URL spletne aplikacije http://demo.guru99.com . Zdaj, če želite dostopati do virov zapisov zaposlenih prek storitev REST, lahko izdate ukaz http://demo.guru99.com/employee/1 - Ta ukaz spletnemu strežniku sporoči, naj navede podatke o zaposlenem, katerega številka zaposlenega je 1.

  2. Zahtevalni glagoli - opisujejo, kaj želite storiti z virom. Brskalnik izda glagol GET, da navede končno točko, ki jo želi pridobiti. Na voljo pa je še veliko drugih glagolov, vključno s stvarmi, kot so POST, PUT in DELETE. V primeru primera http://demo.guru99.com/employee/1 spletni brskalnik dejansko izda GET Verb, ker želi dobiti podrobnosti o evidenci zaposlenih.

  3. Glave zahteve - to so dodatna navodila, poslana skupaj z zahtevo. Ti lahko opredelijo vrsto zahtevanega odgovora ali podrobnosti o avtorizaciji.

  4. Telo zahteve - podatki se pošljejo skupaj z zahtevo. Podatki se v zahtevi običajno pošljejo, ko se zahteva POST pošlje v spletne storitve REST. V klicu POST odjemalec dejansko sporoči spletnim storitvam REST, da želi dodati vir na strežnik. Zato bi telo zahteve imelo podrobnosti vira, ki ga je treba dodati strežniku.

  5. Odgovorno telo - To je glavno telo odziva. Torej, v našem primeru RESTful API, če bi poizvedovali po spletnem strežniku prek zahteve http://demo.guru99.com/employee/1 , bi spletni strežnik morda vrnil dokument XML z vsemi podrobnostmi o zaposlenem v odgovoru Telo.

  6. Kode stanja odziva - te kode so splošne kode, ki se vrnejo skupaj z odzivom spletnega strežnika. Primer je koda 200, ki se običajno vrne, če ni napake pri vrnitvi odziva odjemalcu.

Spokojne metode

Spodnji diagram prikazuje večinoma vse glagole (POST, GET, PUT in DELETE) in primer REST API, kaj bi pomenili.

Predpostavimo, da imamo na lokaciji določeno spletno storitev RESTful. http://demo.guru99.com/employee . Ko odjemalec poda katero koli zahtevo tej spletni storitvi, lahko določi katerega koli običajnega glagola HTTP GET, POST, DELETE in PUT. Spodaj je opisano, kaj bi se zgodilo, če bi ustrezne glagole poslala stranka.

  1. POST - S tem bi ustvarili novega zaposlenega z uporabo spletne storitve RESTful
  2. GET - S tem bi dobili seznam vseh zaposlenih, ki uporabljajo spletno storitev RESTful
  3. PUT - S tem bi posodobili vse zaposlene z uporabo spletne storitve RESTful
  4. IZBRIŠI - S tem bi izbrisali vse zaposlene, ki uporabljajo storitve RESTful

Oglejmo si pogled z vidika samo enega zapisa. Recimo, da je obstajala evidenca o zaposlenem s številko zaposlenega 1.

Naslednji ukrepi bi imeli svoj pomen.

  1. POST - To ne bi veljalo, ker pridobivamo podatke o zaposlenem 1, ki so že ustvarjeni.
  2. GET - S tem bi dobili podatke o zaposlenem z zaposlenim št. 1 z uporabo spletne storitve RESTful
  3. PUT - S tem bi posodobili podatke o zaposlenem z zaposlenim št. 1 z uporabo spletne storitve RESTful
  4. IZBRIŠI - S tem se izbrišejo podatki o zaposlenem z zaposlenim št. 1

Zakaj miren

Restful se je večinoma uveljavil iz naslednjih razlogov:

  1. Heterogeni jeziki in okolja - To je eden temeljnih razlogov, ki je enak, kot smo ga videli tudi za SOAP.
  • Spletnim aplikacijam, ki temeljijo na različnih programskih jezikih, omogoča medsebojno komunikacijo
  • S pomočjo storitev Restful lahko te spletne aplikacije prebivajo v različnih okoljih, nekatere so lahko v sistemu Windows, druge pa v sistemu Linux.

Toda na koncu naj bo končni rezultat ne glede na okolje vedno enak, da bi se lahko pogovarjali med seboj. Prijetne spletne storitve ponujajo to prilagodljivost aplikacijam, ki temeljijo na različnih programskih jezikih in platformah za medsebojni pogovor.

Spodnja slika prikazuje primer spletne aplikacije, ki zahteva pogovore z drugimi aplikacijami, kot so Facebook, Twitter in Google.

Če bi odjemalska aplikacija morala delati s spletnimi mesti, kot so Facebook, Twitter itd., Bi verjetno morala vedeti, v katerem jeziku so Facebook, Google in Twitter zgrajeni, in tudi na kakšni platformi.

Na podlagi tega lahko napišemo povezovalno kodo za našo spletno aplikacijo, vendar se to lahko izkaže za nočno moro.

Facebook, Twitter in Google svojo funkcionalnost izpostavijo v obliki spletnih storitev Restful. To omogoča kateri koli odjemalski aplikaciji, da pokliče te spletne storitve prek REST.

  1. Dogodek naprav - Dandanes mora na mobilnih napravah delovati vse, najsi gre za mobilne naprave, prenosnike ali celo avtomobilske sisteme.

    Si predstavljate, koliko truda bi poskušali kodirati programe na teh napravah in se pogovarjati z običajnimi spletnimi aplikacijami? Restful API-ji lahko to delo poenostavijo, saj kot je omenjeno v točki 1, vam res ni treba vedeti, kaj je osnovna plast naprave.

  2. Končno je dogodek v oblaku - vse se premika v oblak. Aplikacije se počasi selijo v sisteme v oblaku, kot sta Azure ali Amazon. Azure in Amazon ponujata veliko API-jev, ki temeljijo na arhitekturi Restful. Zato je treba aplikacije zdaj razvijati tako, da so združljive z oblakom. Ker torej vse arhitekture v oblaku delujejo po načelu REST, je bolj smiselno, da se spletne storitve programirajo na arhitekturi, ki temelji na storitvah REST, da kar najbolje izkoristijo storitve v oblaku.

Spokojna arhitektura

Aplikacija ali arhitektura, ki velja za RESTful ali REST-style, ima naslednje značilnosti

  1. Stanje in funkcionalnost sta razdeljena na porazdeljene vire - to pomeni, da bi morali biti vsi viri dostopni prek običajnih ukazov HTTP GET, POST, PUT ali DELETE. Če bi torej nekdo hotel dobiti datoteko s strežnika, bi moral imeti možnost izdati zahtevo GET in jo dobiti. Če želijo dati datoteko na strežnik, bi morali imeti možnost izdati zahtevo POST ali PUT. In končno, če so želeli datoteko izbrisati s strežnika, izdajo zahtevo DELETE.
  2. Arhitektura je odjemalec / strežnik, brez stanja, večplastna in podpira predpomnjenje -
  • Client-server je tipična arhitektura, pri kateri je strežnik lahko spletni strežnik, ki gosti aplikacijo, odjemalec pa je lahko tako preprost kot spletni brskalnik.
  • Brez državljanstva pomeni, da se stanje aplikacije ne vzdržuje v REST.

    Če na primer z ukaza DELETE iz strežnika izbrišete vir, ne morete pričakovati, da se bodo informacije o brisanju posredovale naslednji zahtevi.

    Če želite zagotoviti, da se vir izbriše, morate izdati zahtevo GET. Zahteva GET bi bila uporabljena za pridobitev vseh virov na strežniku. Potem bi morali preveriti, ali je bil vir dejansko izbrisan.

RESTFul Načela in omejitve

Arhitektura REST temelji na nekaj značilnostih, ki so opisane v nadaljevanju. Vsaka spletna storitev RESTful mora izpolnjevati spodnje značilnosti, da se lahko imenuje RESTful. Te značilnosti so znane tudi kot načela oblikovanja, ki jih je treba upoštevati pri delu s storitvami, ki temeljijo na RESTful.

  1. RESTFul Client-Server

To je najbolj temeljna zahteva arhitekture, ki temelji na REST. To pomeni, da bo imel strežnik spletno storitev RESTful, ki bo stranki zagotovila zahtevano funkcionalnost. Naročnik pošlje zahtevo spletni storitvi na strežniku. Strežnik bi zahtevo bodisi zavrnil bodisi bi jo izpolnil in stranki zagotovil ustrezen odgovor.

  1. Brez državljanstva

Koncept brez državljanstva pomeni, da mora stranka zagotoviti, da bodo vse zahtevane informacije posredovane strežniku. To je potrebno, da lahko strežnik odgovor ustrezno obdela. Strežnik ne sme vzdrževati kakršnih koli informacij med zahtevami odjemalca. To je zelo preprosto neodvisno zaporedje vprašanje-odgovor. Naročnik postavi vprašanje, strežnik nanj ustrezno odgovori. Stranka bo postavila še eno vprašanje. Strežnik se ne bo spomnil prejšnjega scenarija odgovora na vprašanje in bo moral na novo vprašanje odgovoriti samostojno.

  1. predpomnilnik

Koncept predpomnilnika je pomagati pri težavi brez državljanstva, ki je bila opisana v zadnji točki. Ker je vsaka zahteva odjemalskega strežnika po svoji naravi neodvisna, lahko odjemalca včasih spet prosi za isto zahtevo. To je, čeprav je to že zahtevalo v preteklosti. Ta zahteva bo poslana strežniku in strežnik bo odgovoril. To poveča promet po omrežju. Predpomnilnik je koncept, ki se na odjemalcu izvaja za shranjevanje zahtev, ki so že poslane strežniku. Torej, če isto zahtevo da odjemalec, namesto da bi šel na strežnik, bi šel v predpomnilnik in dobil zahtevane informacije. Tako prihranite količino omrežnega prometa od odjemalca do strežnika.

  1. Večplastni sistem

Koncept večplastnega sistema je, da je mogoče med odjemalcem in dejanskim strežnikom, ki gosti spletno storitev RESTFul, vstaviti katero koli dodatno plast, na primer plast vmesne programske opreme (Vmesna plast je tista, kjer je ustvarjena vsa poslovna logika. To je lahko dodatna storitev ustvarjena, s katero bi lahko stranka komunicirala, preden pokliče spletno storitev.). Toda uvedba te plasti mora biti pregledna, da ne bo motila interakcije med odjemalcem in strežnikom.

  1. Vmesnik / enotna pogodba

To je osnovna tehnika, kako naj delujejo spletne storitve RESTful. RESTful v bistvu deluje na spletni plasti HTTP in uporablja spodnje ključne glagole za delo z viri na strežniku

  • POST - Če želite na strežniku ustvariti vir
  • GET - Za pridobitev vira s strežnika
  • PUT - Če želite spremeniti stanje vira ali ga posodobiti
  • DELETE - Če želite odstraniti ali izbrisati vir s strežnika

Ustvarite svojo prvo spletno storitev Restful v ASP.NET

Zdaj v tej vadnici API REST bomo izvedeli, kako ustvariti spletno storitev Restful v ASP.NET:

Spletne storitve je mogoče ustvariti v različnih jezikih. Za ustvarjanje storitev, ki temeljijo na REST, je mogoče uporabiti številna integrirana razvojna okolja.

V tem primeru API-ja RESTful bomo ustvarili aplikacijo REST v .Net z uporabo Visual Studio. V našem primeru bomo za spletne storitve Restful posnemali naslednji primer storitve REST.

Imeli bomo spletno storitev Restful, ki bo delovala na spodnjem naboru podatkov.

Spodnji niz podatkov predstavlja primer API-ja REST, da imamo podjetje, ki izpostavi vaje, ki jih imajo na podlagi Tutorialida.

Tutorialid TutorialName
0 Polja
1. Čakalne vrste
2. Skladi

V našem primeru vadnice REST API bomo uvedli spodnje Restful Verbs.

  1. GET Tutorial - Ko odjemalec pokliče ta Restful API, bo dobil celoten nabor vadnic, ki jih ponuja spletna storitev.
  2. GET Tutorial / Tutorialid - Ko odjemalec pokliče ta Restful API, bo dobil ime Vadnice na podlagi Tutorialida, ki ga je poslal odjemalec.
  3. POST Tutorial / Tutorialname - Ko odjemalec pokliče ta Restful API, bo oddal zahtevo za vstavitev imena vadnice. Nato bo spletna storitev dodanemu imenu vadnice dodala zbirko.
  4. DELETE Tutorial / Tutorialid - Ko odjemalec pokliče ta Restful API, bo oddal zahtevo za izbris imena vadnice, ki temelji na Tutorialid. Spletna storitev bo nato poslano ime vadnice izbrisala iz zbirke.

Sledimo spodnjim korakom v tej vadnici API-ja RESTful, da ustvarimo naše prve spletne storitve RESTful, ki izvajajo zgornjo implementacijo.

Korak 1) Prvi korak je ustvariti prazno spletno aplikacijo Asp.Net. V Visual Studio 2013 kliknite menijsko možnost Datoteka-> Nov projekt.

Ko kliknete možnost Nov projekt, vam bo Visual Studio odprl še eno pogovorno okno za izbiro vrste projekta in potrebne podrobnosti o projektu. To je razloženo v naslednjem koraku te vaje za API RESTful

Korak 2) V tem koraku

  1. Prepričajte se, da najprej izberete spletno predlogo R #ful web services C # spletne aplikacije ASP.NET. Projekt mora biti te vrste, če želite ustvariti projekt spletnih storitev. Z izbiro te možnosti bo Visual Studio nato izvedel potrebne korake za dodajanje potrebnih datotek, ki jih zahteva katera koli spletna aplikacija.
  2. Navedite ime za svoj projekt, ki je bil v našem primeru imenovan kot "Webservice.REST".
  3. Nato zagotovite lokacijo, kjer bodo shranjene projektne datoteke.

Ko končate, boste videli projektno datoteko, ustvarjeno v raziskovalcu rešitev v Visual Studio 2013.

Korak 3) Naslednji korak je ustvariti datoteko spletne storitve, ki bo imela spletno storitev RESTful

  1. Najprej z desno miškino tipko kliknite projektno datoteko, kot je prikazano spodaj
  1. V tem koraku
    1. Z desno miškino tipko kliknite datoteko projekta
    2. Izberite možnost "Dodaj-> nov element."

V pogovornem oknu, ki se odpre, morate narediti naslednje

  1. Izberite možnost storitve WCF (z omogočenim Ajaxom) - izberite datoteko te vrste, zaradi česar bo Visual studio dodal nekaj osnovne kode, ki bo pomagala ustvariti spletno storitev RESTful. WCF pomeni Windows Communication Foundation. WCF je knjižnica za aplikacije različnih platform ali iste platforme za komunikacijo prek različnih protokolov, kot so TCP, HTTP, HTTPS. Ajax je v osnovi asinhroni JavaScript in XML. AJAX omogoča asinhrono posodabljanje spletnih strani z izmenjavo majhnih količin podatkov s strežnikom v zakulisju.
  2. Nato navedite ime storitve, ki je v našem primeru TutorialService.
  3. Na koncu kliknite gumb Dodaj, da dodate storitev v rešitev.

Korak 4) Naslednji korak je, da dejansko spremenite konfiguracijo, da omogočite temu projektu dokončanje dela s spletnimi storitvami RESTful. To zahteva spremembo datoteke z imenom Web.config . Ta datoteka se prikaže v istem oknu kot datoteka projekta Webservice. Datoteka Web.config vsebuje vse konfiguracije, zaradi katerih spletna aplikacija deluje, kot bi morala. Sprememba dejansko omogoča aplikaciji pošiljanje in prejemanje podatkov kot čisto spletno storitev RESTful.

  1. Kliknite datoteko Web.config, da odprete kodo
  1. Poiščite vrstico
  1. Spremenite vrstico v

Korak 5) Naslednji korak v tej vadnici API-ja RESTful je dodati našo kodo za izvedbo. Vsa spodaj navedena koda mora biti zapisana v datoteko TutorialService.svc

  1. Prvi del je dodati kodo, ki predstavlja naše podatke, ki bodo uporabljeni v našem programu. Torej bomo dobili seznam spremenljivk niza z vrednostmi "Polja", "Čakalne vrste" in "Stacks". To bo predstavljalo ime vadnic, ki je na voljo prek naše spletne storitve gostovanja.
namespace Webservice.REST{[ServiceContract(Namespace = "")][AspNetCompatibilityRequirements(RequirementsMode = AspNetCompatibilityRequirementsMode.Allowedpublic class TutorialService{private static List  lst = new List  (new String[] {"Arrays","Queues","Stacks"});

Korak 6) Nato bomo definirali kodo za našo metodo GET. Ta koda bo tudi v isti datoteki TutorialService.svc. Ta koda se bo izvajala, kadar koli pokličemo storitev iz našega brskalnika.

Spodnja metoda bo uporabljena za izpolnitev spodaj omenjenega scenarija

  • Če uporabnik želi seznam vseh vaj, ki so na voljo, potem je treba za to napisati spodnjo kodo.
[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;}

Pojasnilo kode: -

  1. Prva vrstica kode je najpomembnejša. Uporablja se za določanje, kako lahko to metodo pokličemo prek URL-ja. Torej, če je povezava do naše spletne storitve http: // localhost: 52645 / TutorialService.svc in če URL-ju dodamo '/ Tutorial' kot http: // localhost: 52645 / TutorialService.svc / Tutorial , zgornja koda bo poklicano. Atribut 'WebGet' je parameter, ki omogoča, da je ta metoda metoda RESTful, tako da jo je mogoče priklicati prek glagola GET.
  2. Ta odsek kode se uporablja za pregledovanje našega seznama nizov v spremenljivki 'lst' in vrnitev vseh v klicni program.

Korak 7) Spodnja koda zagotavlja, da bo GET klic vadbeni službi z ID-jem vadnice vrnil ustrezno ime vadnice, ki temelji na ID-ju vadnice.

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

Pojasnilo kode: -

  1. Prva vrstica kode je najpomembnejša. Uporablja se za določanje, kako lahko to metodo pokličemo prek URL-ja. Torej, če je povezava do naše spletne storitve http: // localhost: 52645 / TutorialService.svc in če URL-ju dodamo '/ Tutorial / {Tutorialid}', bi lahko spletno storitev poklicali kot http: //localhost:52645/TutorialService.svc/Tutorial/1 kot primer. Nato bi spletna storitev morala vrniti ime vadnice, ki je imela ID vadnice št. 1.
  2. Ta odsek kode se uporablja za vrnitev "imena vadnice", ki ima ID vadnice posredovan spletni metodi.
  • Privzeto si je treba zapomniti, da je vse, kar se v brskalnik posreduje URL-ju, niz.
  • Vendar se morate zavedati, da mora biti indeks na našem seznamu celo število, zato dodajamo potrebno kodo, da Tutorialid najprej pretvorimo v celo število, nato pa ga uporabimo za dostop do položaja indeksa na našem seznamu in
  • Nato vrednost vrnite klicnemu programu.

Korak 8) Naslednji korak je zapisovanje kode za našo metodo POST. Ta metoda se bo sprožila, kadar želimo na seznam vaj dodati metodo niza z metodo POST. Če bi na primer želeli dodati ime vadnice "Testiranje programske opreme", bi morali uporabiti metodo POST.

Pojasnilo kode: -

  1. Prva vrstica je atribut 'WebInvoke', ki je bil priložen naši metodi. To omogoča priklic metode prek klica POST. Atributa RequestFormat in ResponseFormat je treba omeniti kot JSON, saj morajo biti vrednosti pri objavljanju vrednosti v spletni storitvi RESTFul v tej obliki.
  2. Druga vrstica kode se uporablja za dodajanje vrednosti niza, posredovanega prek klica POST, na naš obstoječi seznam nizov vadnic.

Korak 9) Na koncu bomo dodali še našo metodo za ravnanje z DELETE. Ta metoda bo uporabljena, kadar želimo z metode DELETE izbrisati obstoječo vrednost niza s seznama vadnic.

[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);}

Pojasnilo kode: -

  1. Prva vrstica je atribut 'WebInvoke', ki je bil priložen naši metodi. To omogoča priklic metode prek klica POST. Atributa RequestFormat in ResponseFormat je treba omeniti kot JSON, saj morajo biti vrednosti pri objavljanju vrednosti v spletni storitvi RESTFul v tej obliki. Upoštevajte, da je parameter metode nastavljen na "DELETE". To pomeni, da bo ta način uporabljen vsakič, ko bomo izdali glagol DELETE.
  2. Druga vrstica kode se uporablja za prevzem Tutorialida, poslanega prek klica DELETE, in nato ta ID izbrišemo z našega seznama. (Funkcija Int32 v kodi se uporablja za pretvorbo ID vadnice iz spremenljivke niza v celo število).

Zagon vaše prve spletne storitve Restful

Zdaj, ko smo v zgornjem razdelku ustvarili celotno spletno storitev. Poglejmo, kako lahko zaženemo storitev Vadnica, tako da jo lahko prikliče kateri koli odjemalec.

Če želite zagnati spletno storitev, sledite spodnjim korakom

Korak 1) Z desno miškino tipko kliknite datoteko projekta - Webservice.REST

Korak 2) Izberite možnost menija 'Nastavi kot zagon projekta'. To bo zagotovilo, da se ta projekt zažene, ko Visual Studio zažene celotno rešitev

Korak 3) Naslednji korak je zagon samega projekta. Zdaj, odvisno od privzetega brskalnika, nameščenega v sistemu, bo poleg gumba za zagon v Visual Studio prišlo ustrezno ime brskalnika. V našem primeru se prikaže Google Chrome. Samo kliknite ta gumb.

Izhod: -

Ko se projekt zažene, lahko brskate do razdelka TutorialService.svc / Tutorial in dobili boste spodnji izhod.

V zgornjem izhodu

  • Vidite lahko, da brskalnik prikliče glagol „GET“ in v spletni storitvi izvede metodo „GetAllTutorial“. Ta modul se uporablja za prikaz vseh vaj, ki jih izpostavlja naša spletna storitev.

Testiranje vaše prve spletne storitve Restful

V zgornjem razdelku smo že videli, kako uporabiti brskalnik za izvajanje glagola 'GET' in priklic 'GetAllTutorial'.

  1. Zdaj uporabimo brskalnik za izvedbo naslednjega primera uporabe.

GET Tutorial / Tutorialid - Ko odjemalec pokliče ta Restful API, bo dobil ime Vadnice na podlagi Tutorialida, ki ga je poslal odjemalec

V brskalniku dodajte besedo / 1 za besedo Vadnica v URL. Če pritisnete gumb za vnos, boste dobili spodnji izhod

Zdaj boste videli izhod iz čakalnih vrst, ki dejansko ustreza številki 1 na našem seznamu nizov vadnic. To pomeni, da se metoda "GetTutorialbyID" zdaj prikliče iz naše spletne storitve. To tudi kaže, da se vrednost 1 uspešno posreduje prek brskalnika naši spletni storitvi in ​​naši metodi, zato v brskalniku dobimo pravilno ustrezno vrednost "Čakalne vrste".

  1. Nato zaženimo našo spletno storitev z izvajanjem spodnjega scenarija. Za to morate namestiti orodje, imenovano "Fiddler", ki je brezplačno naložljivo orodje s spletnega mesta.

POST Tutorial / Tutorialname - Ko odjemalec pokliče ta Restful API, bo oddal zahtevo za vstavitev imena vadnice. Nato bo spletna storitev dodanemu imenu vadnice dodala zbirko.

Zaženite orodje Filddler in izvedite spodnje korake;

  1. Pojdite na razdelek o skladatelju. To se uporablja za ustvarjanje zahtev, ki jih je mogoče poslati na kateri koli splet

    aplikacijo.

  2. Prepričajte se, da je vrsta zahteve »POST« in da je zadet pravilen URL, ki bi v našem primeru moral biti http: // localhost: 52645 / TutorialService.svc / Tutorial
  3. Prepričajte se, da je Content-Type označen kot application / json. Ne pozabite, da naša metoda zahteve POST v naši spletni storitvi sprejema samo podatke sloga json, zato moramo zagotoviti, da je to določeno, ko pošiljamo zahtevo naši aplikaciji.
  4. Na koncu moramo vnesti še svoje podatke. Ne pozabite, da naša metoda za POST sprejema parameter, imenovan 'str.' Tukaj torej določamo, da želimo v svojo zbirko imen vadnic dodati vrednost, imenovano "Drevesa", in zagotoviti, da je označena z imenom spremenljivke str.

Nazadnje v fiddlerju preprosto kliknite gumb Izvedi. S tem bo spletna storitev poslala zahtevo za pošiljanje podatkov "Drevesa" v našo spletno storitev.

Zdaj, ko poiščemo URL vadnice, da prikažemo vse nize na našem seznamu vadnic, boste zdaj videli tudi vrednost »Drevesa«. To kaže, da je bila zahteva POST za spletno storitev uspešno izvedena in da je bila uspešno dodana na naš seznam vadnic.

  1. Nato zaženimo našo spletno storitev z izvajanjem spodnjega scenarija. Za to moramo uporabiti tudi orodje fiddler

DELETE Tutorial / Tutorialid - Ko odjemalec pokliče ta Restful API, bo oddal zahtevo za izbris imena vadnice, ki temelji na Tutorialid. Spletna storitev bo nato poslano ime vadnice izbrisala iz zbirke.

Zaženite orodje Filddler in izvedite spodnje korake

  1. Pojdite na razdelek o skladatelju. To se uporablja za ustvarjanje zahtev, ki jih je mogoče poslati na kateri koli splet

    aplikacijo.

  2. Prepričajte se, da je vrsta zahteve »IZBRIŠI« in da je zadet pravilen URL, ki bi v našem primeru moral biti http: // localhost: 52645 / TutorialService.svc / Tutorial . Prepričajte se, da je ID, ki se uporablja za brisanje niza s seznama, poslanega prek URL-ja, kot parameter. V našem primeru REST pošiljamo 1, zato bomo izbrisali 2. element v naši zbirki, ki je "Čakalne vrste".

Nazadnje v fiddlerju preprosto kliknite gumb Izvedi. S tem bo spletna storitev poslala zahtevo za IZBRIS podatkov "Čakalne vrste" v našo spletno storitev.

Zdaj, ko poiščemo URL vadnice, da prikažemo vse nize na našem seznamu vadnic, boste opazili, da vrednost "Čakalne vrste" ni več prisotna.

To kaže, da je bila zahteva DELETE za spletno storitev uspešno izvedena. Element z indeksom št. 1 na našem seznamu nizov vaj je bil uspešno izbrisan.

Povzetek

  • REST pomeni zastopniški državni prenos. REST se uporablja za izdelavo spletnih storitev, ki so lahke, vzdržne in razširljive.
  • Vse več aplikacij se seli v arhitekturo Restful. To je zato, ker zdaj veliko ljudi uporablja mobilne naprave in širok spekter aplikacij, ki se selijo v oblak.
  • Glavni vidiki REST-a so viri, ki se nahajajo na strežniku, in glagoli GET, POST, PUT in DELETE, ki jih lahko uporabimo za delo s temi viri.
  • Visual Studio in. Net lahko uporabite za ustvarjanje spletnih storitev Restful.
  • Ko preizkušate spletne storitve za POST in PUT, morate uporabiti drugo orodje, imenovano fiddler, s katerim lahko strežniku pošljete zahtevo POST in PUT.