RESTful Web Services Tutorial med REST API-eksempel

Innholdsfortegnelse:

Anonim

Hva er Restful Web Services?

Restful Web Services er en lett, vedlikeholdbar og skalerbar tjeneste som er bygget på REST-arkitekturen. Restful Web Service, utsett API fra applikasjonen din på en sikker, enhetlig og statsløs måte for den anropende klienten. Den anropende klienten kan utføre forhåndsdefinerte operasjoner ved hjelp av Restful-tjenesten. Den underliggende protokollen for REST er HTTP. REST står for REpresentational State Transfer.

I denne REST API-opplæringen vil du lære-

  • RESTful nøkkelelementer
  • Avslappende metoder
  • Hvorfor avslappende
  • Avslappende arkitektur
  • RestFul-prinsipper og begrensninger
  • Lag din første avslappende webtjeneste i ASP.NET
  • Kjører din første avslappende nettjeneste
  • Testing av din første avslappende nettjeneste

RESTful nøkkelelementer

REST-webtjenester har virkelig kommet langt siden starten. I 2002 hadde webkonsortiet gitt ut definisjonen av WSDL- og SOAP-nettjenester. Dette dannet standarden for hvordan webtjenester implementeres.

I 2004 ga webkonsortiet også ut definisjonen av en tilleggsstandard kalt RESTful. I løpet av de siste par årene har denne standarden blitt ganske populær. Og blir brukt av mange av de populære nettstedene rundt om i verden som inkluderer Facebook og Twitter.

REST er en måte å få tilgang til ressurser som ligger i et bestemt miljø. For eksempel kan du ha en server som kan være vert for viktige dokumenter eller bilder eller videoer. Alt dette er et eksempel på ressurser. Hvis en klient, sier en nettleser, trenger noen av disse ressursene, må den sende en forespørsel til serveren om å få tilgang til disse ressursene. Nå definerer REST-tjenester en måte å få tilgang til disse ressursene på.

Nøkkelelementene i en RESTful implementering er som følger:

  1. Ressurser - Det første nøkkelelementet er selve ressursen. La oss anta at en webapplikasjon på en server har registreringer av flere ansatte. La oss anta at nettadressen til webapplikasjonen er http://demo.guru99.com . For å få tilgang til en ansattes postressurs via REST-tjenester, kan man utstede kommandoen http://demo.guru99.com/employee/1 - Denne kommandoen ber webserveren om å oppgi detaljene til den ansatte hvis ansattnummer er 1.

  2. Be om verb - Disse beskriver hva du vil gjøre med ressursen. En nettleser utsteder et GET-verb for å instruere sluttpunktet det ønsker å få data. Imidlertid er det mange andre verb tilgjengelig, inkludert ting som POST, PUT og DELETE. Så når det gjelder eksemplet http://demo.guru99.com/employee/1 , utgir nettleseren faktisk et GET-verb fordi det ønsker å få detaljene i ansattens rekord.

  3. Forespørselsoverskrifter - Dette er tilleggsinstruksjoner som sendes sammen med forespørselen. Disse kan definere hvilken type respons som kreves eller autorisasjonsdetaljene.

  4. Forespørselsorgan - Data sendes med forespørselen. Data sendes normalt i forespørselen når det sendes en POST-forespørsel til REST-nettjenestene. I en POST-samtale forteller klienten faktisk REST-webtjenestene at den vil legge til en ressurs på serveren. Derfor vil forespørselsorganet ha detaljene i ressursen som kreves lagt til serveren.

  5. Respons Body - Dette er hoveddelen av responsen. Så i vårt RESTful API-eksempel, hvis vi skulle spørre webserveren via forespørselen http://demo.guru99.com/employee/1 , kan det være at webserveren returnerer et XML-dokument med alle detaljene til den ansatte i svaret Kropp.

  6. Svarstatuskoder - Disse kodene er de generelle kodene som returneres sammen med svaret fra webserveren. Et eksempel er koden 200 som normalt returneres hvis det ikke er noen feil når du returnerer et svar til klienten.

Avslappende metoder

Diagrammet nedenfor viser stort sett alle verbene (POST, GET, PUT og DELETE) og et REST API-eksempel på hva de vil bety.

La oss anta at vi har en RESTful webtjeneste som er definert på stedet. http://demo.guru99.com/medarbeider . Når klienten kommer med en forespørsel til denne nettjenesten, kan den spesifisere hvilken som helst av de vanlige HTTP-verbene til GET, POST, DELETE og PUT. Nedenfor er hva som ville skje hvis de respektive verbene ble sendt av klienten.

  1. POST - Dette vil bli brukt til å opprette en ny ansatt ved hjelp av RESTful-nettjenesten
  2. FÅ - Dette vil bli brukt til å få en liste over alle ansatte som bruker RESTful-nettjenesten
  3. PUT - Dette vil bli brukt til å oppdatere alle ansatte som bruker RESTful-nettjenesten
  4. SLETT - Dette vil bli brukt til å slette alle ansatte som bruker RESTful-tjenestene

La oss ta en titt fra et perspektiv på bare en enkelt plate. La oss si at det var en ansattrekord med antall ansatte 1.

Følgende handlinger vil ha sin respektive betydning.

  1. POST - Dette vil ikke være aktuelt siden vi henter data om ansatt 1 som allerede er opprettet.
  2. FÅ - Dette vil bli brukt til å få informasjon om den ansatte med ansatt nr. 1 ved hjelp av RESTful-nettjenesten
  3. PUT - Dette vil bli brukt til å oppdatere detaljene til den ansatte med ansatt nr. 1 ved hjelp av RESTful-nettjenesten
  4. SLETT - Dette brukes til å slette detaljene til den ansatte med ansatt nr. 1

Hvorfor avslappende

Restful kom stort sett i popularitet på grunn av følgende årsaker:

  1. Heterogene språk og miljøer - Dette er en av de grunnleggende årsakene som er den samme som vi har sett for SOAP også.
  • Det gjør det mulig for webapplikasjoner som er bygget på forskjellige programmeringsspråk å kommunisere med hverandre
  • Ved hjelp av Restful-tjenester kan disse webapplikasjonene ligge i forskjellige miljøer, noen kan være på Windows og andre på Linux.

Men til slutt, uansett miljø, bør sluttresultatet alltid være det samme at de skal kunne snakke med hverandre. Avslappende webtjenester tilbyr denne fleksibiliteten til applikasjoner som er bygd på forskjellige programmeringsspråk og plattformer for å snakke med hverandre.

Bildet nedenfor gir et eksempel på en webapplikasjon som har et krav om å snakke med andre applikasjoner som Facebook, Twitter og Google.

Nå hvis en klientapplikasjon måtte jobbe med nettsteder som Facebook, Twitter osv., Ville de sannsynligvis måtte vite hva språket Facebook, Google og Twitter er bygget på, og også på hvilken plattform de er bygget på.

Basert på dette kan vi skrive grensesnittkoden for webapplikasjonen vår, men dette kan vise seg å være et mareritt.

Facebook, Twitter og Google avslører funksjonaliteten sin i form av Restful web-tjenester. Dette gjør at ethvert klientprogram kan ringe disse webtjenestene via REST.

  1. Hendelsen til enheter - I dag trenger alt å fungere på mobile enheter, enten det er den mobile enheten, bærbare datamaskiner eller til og med bilsystemer.

    Kan du forestille deg hvor mye innsats du prøver å kode applikasjoner på disse enhetene for å snakke med vanlige webapplikasjoner? Igjen kan Restful API-er gjøre denne jobben enklere fordi du som nevnt i punkt 1 ikke trenger å vite hva som er det underliggende laget for enheten.

  2. Endelig er hendelsen til skyen - alt beveger seg til skyen. Applikasjoner beveger seg sakte til skybaserte systemer som i Azure eller Amazon. Azure og Amazon gir mange API-er basert på Restful-arkitekturen. Derfor må applikasjoner nå utvikles på en slik måte at de gjøres kompatible med skyen. Så siden alle skybaserte arkitekturer arbeider med REST-prinsippet, er det mer fornuftig at webtjenester programmeres på REST-tjenestebasert arkitektur for å utnytte skybaserte tjenester best.

Avslappende arkitektur

En applikasjon eller arkitektur som betraktes som RESTful eller REST-stil har følgende egenskaper

  1. Tilstand og funksjonalitet er delt inn i distribuerte ressurser - Dette betyr at hver ressurs skal være tilgjengelig via de vanlige HTTP-kommandoene GET, POST, PUT eller DELETE. Så hvis noen ønsket å hente en fil fra en server, burde de kunne utstede GET-forespørselen og få filen. Hvis de vil legge en fil på serveren, bør de kunne utstede POST- eller PUT-forespørselen. Og til slutt, hvis de ønsket å slette en fil fra serveren, utsteder de DELETE-forespørselen.
  2. Arkitekturen er klient / server, statsløs, lagdelt og støtter caching -
  • Klient-server er den typiske arkitekturen der serveren kan være webserveren som er vert for applikasjonen, og klienten kan være så enkel som nettleseren.
  • Stateless betyr at søknadens tilstand ikke opprettholdes i REST.

    Hvis du for eksempel sletter en ressurs fra en server ved hjelp av SLETT-kommandoen, kan du ikke forvente at slettingsinformasjonen skal sendes til neste forespørsel.

    For å sikre at ressursen blir slettet, må du utstede GET-forespørselen. GET-forespørselen vil bli brukt til å først få alle ressursene på serveren. Deretter må man se om ressursen faktisk ble slettet.

RESTFul prinsipper og begrensninger

REST-arkitekturen er basert på noen egenskaper som er utdypet nedenfor. Enhver RESTful-nettjeneste må oppfylle karakteristikkene nedenfor for at den skal kunne kalles RESTful. Disse egenskapene er også kjent som designprinsipper som må følges når du arbeider med RESTful-baserte tjenester.

  1. RESTFul klient-server

Dette er det mest grunnleggende kravet til en REST-basert arkitektur. Det betyr at serveren vil ha en RESTful webtjeneste som vil gi den nødvendige funksjonaliteten til klienten. Klienten sender en forespørsel til webtjenesten på serveren. Serveren vil enten avvise forespørselen eller etterkomme og gi tilstrekkelig svar til klienten.

  1. Statsløs

Konseptet statsløs betyr at det er opp til klienten å sikre at all nødvendig informasjon blir gitt til serveren. Dette er nødvendig slik at serveren kan behandle svaret på riktig måte. Serveren skal ikke ha noen form for informasjon mellom forespørsler fra klienten. Det er en veldig enkel uavhengig spørsmålssvarssekvens. Klienten stiller et spørsmål, serveren svarer på riktig måte. Kunden vil stille et annet spørsmål. Serveren husker ikke forrige spørsmålssvarsscenario og må svare på det nye spørsmålet uavhengig.

  1. Cache

Cache-konseptet er å hjelpe til med problemet med statsløs som ble beskrevet i det siste punktet. Siden hver serverklientforespørsel er uavhengig av natur, kan det hende at klienten kanskje ber serveren om den samme forespørselen igjen. Dette er selv om det allerede hadde bedt om det tidligere. Denne forespørselen vil gå til serveren, og serveren vil svare. Dette øker trafikken over nettverket. Cachen er et konsept implementert på klienten for å lagre forespørsler som allerede er sendt til serveren. Så hvis den samme forespørselen blir gitt av klienten, i stedet for å gå til serveren, vil den gå til hurtigbufferen og få den nødvendige informasjonen. Dette sparer mengden frem og tilbake nettverkstrafikk fra klienten til serveren.

  1. Lagdelt system

Konseptet med et lagdelt system er at ethvert ekstra lag, for eksempel et mellomvarelag, kan settes inn mellom klienten og den faktiske serveren som er vert for RESTFul-nettjenesten (Midtvarelaget er der all forretningslogikken blir opprettet. Dette kan være en ekstra tjeneste opprettet som klienten kunne samhandle med før den ringer til nettjenesten.). Men introduksjonen av dette laget må være gjennomsiktig slik at det ikke forstyrrer samspillet mellom klienten og serveren.

  1. Grensesnitt / enhetlig kontrakt

Dette er den underliggende teknikken for hvordan RESTful web-tjenester skal fungere. RESTful fungerer i utgangspunktet på HTTP-nettlaget og bruker nedenstående nøkkelverb for å jobbe med ressurser på serveren

  • POST - For å opprette en ressurs på serveren
  • GET - Å hente en ressurs fra serveren
  • PUT - For å endre tilstanden til en ressurs eller for å oppdatere den
  • SLETT - For å fjerne eller slette en ressurs fra serveren

Lag din første avslappende webtjeneste i ASP.NET

Nå i denne REST API-opplæringen vil vi lære hvordan du oppretter en avslappende nettjeneste i ASP.NET:

Webtjenester kan opprettes på en rekke språk. Mange integrerte utviklingsmiljøer kan brukes til å lage REST-baserte tjenester.

I dette RESTful API-eksemplet skal vi lage vår REST-applikasjon i .Net ved hjelp av Visual Studio. I vårt eksempel, for Restful web services, skal vi etterligne følgende REST-serviceeksempel.

Vi kommer til å ha en avslappende webtjeneste som vil fungere med nedenstående datasett.

Nedre datasett representerer et REST API-eksempel på å ha et selskap som avslører opplæringen de har basert på veiledningsid.

Tutorialid Veiledningsnavn
0 Arrays
1 Køer
2 Stabler

I vårt eksempel på REST API-opplæring skal vi implementere Restful Verbs nedenfor.

  1. GET-veiledning - Når en klient påkaller denne avslappende API-en, vil de få hele settet med opplæringsprogrammer tilgjengelig fra webtjenesten.
  2. GET Tutorial / Tutorialid - Når en klient påkaller denne Restful API, vil de få opplæringsnavnet basert på Tutorialid sendt av klienten.
  3. POST-veiledning / opplæringsnavn - Når en klient påkaller dette Restful API, vil klienten sende inn en forespørsel om å sette inn et opplæringsnavn. Nettjenesten vil da legge til det innsendte opplæringsnavnet i samlingen.
  4. DELETE Tutorial / Tutorialid- Når en klient påkaller denne Restful API, vil klienten sende inn en forespørsel om å slette et Tutorialname basert på Tutorialid. Nettjenesten vil da slette det innsendte opplæringsnavnet fra samlingen.

La oss følge trinnene nedenfor i denne RESTful API-opplæringen for å lage våre første RESTful-webtjenester, som utfører implementeringen ovenfor.

Trinn 1) Det første trinnet er å opprette en tom Asp.Net-webapplikasjon. Fra Visual Studio 2013 klikker du på menyvalget File-> New project.

Når du klikker på alternativet Nytt prosjekt, vil Visual Studio gi deg en annen dialogboks for å velge prosjekttype og gi de nødvendige detaljene om prosjektet. Dette forklares i neste trinn i denne RESTful API-opplæringen

Trinn 2) I dette trinnet,

  1. Sørg for å først velge RESTful C # -malen for webtjenester for ASP.NET Web-applikasjon. Prosjektet må være av denne typen for å kunne opprette webtjenesteprosjekt. Ved å velge disse alternativene vil Visual Studio deretter utføre de nødvendige trinnene for å legge til nødvendige filer som kreves av ethvert nettbasert program.
  2. Gi et navn på prosjektet ditt som i vårt tilfelle er gitt som "Webservice.REST".
  3. Sørg deretter for å gi et sted der prosjektfilene blir lagret.

Når du er ferdig, vil du se prosjektfilen som ble opprettet i løsningsutforskeren din i Visual Studio 2013.

Trinn 3) Det neste trinnet er å opprette webtjenestefilen som skal ha den RESTful webtjenesten

  1. Høyreklikk først på prosjektfilen som vist nedenfor
  1. I dette trinnet,
    1. Høyreklikk på prosjektfilen
    2. Velg alternativet "Legg til-> nytt element."

I dialogboksen som vises, må du utføre følgende

  1. Velg alternativet WCF Service (Ajax-aktivert) - Velg en fil av denne typen, det får Visual studio til å legge til noen grunnleggende koder som hjelper deg med å lage en RESTful webtjeneste. WCF står for Windows Communication Foundation. WCF er et bibliotek for applikasjoner på forskjellige plattformer eller samme plattform for å kommunisere over de forskjellige protokollene som TCP, HTTP, HTTPS. Ajax er i utgangspunktet asynkron JavaScript og XML. AJAX lar websider oppdateres asynkront ved å utveksle små datamengder med serveren bak kulissene.
  2. Gi deretter et navn på tjenesten som er TutorialService i vårt tilfelle.
  3. Til slutt klikker du på Legg til-knappen for å legge til tjenesten i løsningen.

Trinn 4) Det neste trinnet er å faktisk foreta en konfigurasjonsendring slik at dette prosjektet kan fullføre arbeidet med RESTful webtjenester. Dette krever å gjøre en endring i filen som heter Web.config . Denne filen vises i samme vindu som Webservice-prosjektfilen. Filen Web.config inneholder alle konfigurasjoner som får webapplikasjonen til å fungere som den skal. Endringen som gjøres, gjør at applikasjonen faktisk kan sende og motta data som en ren RESTful webtjeneste.

  1. Klikk på Web.config-filen for å åpne koden
  1. Finn for linjen
  1. Endre linjen til

Trinn 5) Det neste trinnet i denne RESTful API-opplæringen er å legge til koden vår for implementering. All den nevnte koden må skrives i filen TutorialService.svc

  1. Den første biten er å legge til kode for å representere dataene våre som skal brukes i vårt program. Så vi skal ha en liste over strengvariabler med verdiene "Arrays", "Queues" og "Stacks". Dette vil representere opplæringsnavnet som er tilgjengelig gjennom vår webtjeneste.
namespace Webservice.REST{[ServiceContract(Namespace = "")][AspNetCompatibilityRequirements(RequirementsMode = AspNetCompatibilityRequirementsMode.Allowedpublic class TutorialService{private static List  lst = new List  (new String[] {"Arrays","Queues","Stacks"});

Trinn 6) Neste vil vi definere koden for GET-metoden. Denne koden vil også ligge i den samme TutorialService.svc-filen. Denne koden vil kjøre når vi ringer til tjenesten fra nettleseren vår.

Metoden nedenfor vil bli brukt til å oppfylle det nevnte scenariet

  • Hvis en bruker ønsker en liste over alle tilgjengelige opplæringsprogrammer, må koden nedenfor skrives for å oppnå dette.
[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;}

Kode Forklaring: -

  1. Den første linjen med kode er den viktigste. Den brukes til å definere hvordan vi kan kalle denne metoden via en URL. Så hvis lenken til nettjenesten vår er http: // localhost: 52645 / TutorialService.svc og hvis vi legger til '/ Tutorial' til URL-en som http: // localhost: 52645 / TutorialService.svc / Tutorial , ovennevnte kode vil bli påkalt. Attributtet til 'WebGet' er en parameter som gjør at denne metoden kan være en RESTful-metode slik at den kan påkalles via GET-verbet.
  2. Denne delen av koden brukes til å gå gjennom listen over strenger i 'lst' variabelen og returnere dem alle til anropsprogrammet.

Trinn 7) Koden nedenfor sikrer at hvis det blir foretatt et GET-anrop til opplæringstjenesten med en opplærings-ID, vil den returnere det tilsvarende opplæringsnavnet basert på opplærings-ID-en.

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

Kode Forklaring: -

  1. Den første linjen med kode er den viktigste. Den brukes til å definere hvordan vi kan kalle denne metoden via en URL. Så hvis lenken til nettjenesten vår er http: // localhost: 52645 / TutorialService.svc og hvis vi legger til '/ Tutorial / {Tutorialid}' til URL-en, vil vi kunne ringe nettjenesten som http: //localhost:52645/TutorialService.svc/Tutorial/1 som et eksempel. Nettjenesten må da returnere opplæringsnavnet som hadde opplærings-ID nr. 1.
  2. Denne delen av koden brukes til å returnere "Opplæringsnavnet" som har opplærings-ID-en sendt til nettmetoden.
  • Som standard må det huskes at det som sendes til URL-en i nettleseren, er en streng.
  • Men du må huske at indeksen til listen vår må være et helt tall, så vi legger til den nødvendige koden for å først konvertere tutorialid til et heltall og deretter bruke den til å få tilgang til indeksposisjonen i listen vår og
  • Deretter returnerer du verdien til anropsprogrammet tilsvarende.

Trinn 8) Neste trinn er å skrive opp koden for POST-metoden. Denne metoden vil bli påkalt når vi vil legge til en strengverdi i vår liste over opplæringsprogrammer via POST-metoden. Hvis du for eksempel vil legge til opplæringsnavnet til "Software Testing", må du bruke POST-metoden.

Kode Forklaring: -

  1. Første linje er attributtet 'WebInvoke' som er knyttet til metoden vår. Dette gjør at metoden kan påkalles via POST-samtalen. Attributtet RequestFormat og ResponseFormat må nevnes som JSON, siden verdiene må være i dette formatet når de legger inn verdier til en RESTFul-nettjeneste.
  2. Den andre kodelinjen brukes til å legge til strengverdien som sendes via POST-samtalen til vår eksisterende liste over opplæringsstrenger.

Trinn 9) Endelig skal vi legge til vår metode for å håndtere DELETE-operasjonen. Denne metoden vil bli påkalt når vi vil slette en eksisterende strengverdi fra vår liste over opplæringsprogrammer via DELETE-metoden.

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

Kode Forklaring: -

  1. Første linje er attributtet 'WebInvoke' som er knyttet til metoden vår. Dette gjør at metoden kan påkalles via POST-samtalen. Attributtet RequestFormat og ResponseFormat må nevnes som JSON, siden verdiene må være i dette formatet når de legger inn verdier til en RESTFul-nettjeneste. Merk at Metodeparameteren blir satt til "SLETT". Dette betyr at når vi utsteder DELETE-verbet, blir denne metoden påkalt.
  2. Den andre kodelinjen brukes til å ta veiledningen sendt via DELETE-samtalen og deretter slette den ID-en fra listen vår. ( Int32- funksjonen i kode brukes til å konvertere opplærings-ID fra en strengvariabel til et heltall).

Kjører din første avslappende nettjeneste

Nå som vi har opprettet hele vår nettjeneste i avsnittet ovenfor. La oss se hvordan vi kan kjøre opplæringstjenesten slik at den kan påberopes fra enhver klient.

Følg trinnene nedenfor for å kjøre nettjenesten

Trinn 1) Høyreklikk på prosjektfilen - Webservice.REST

Trinn 2) Velg menyalternativet 'Set as StartUp Project'. Dette vil sikre at dette prosjektet kjøres når Visual Studio kjører hele løsningen

Trinn 3) Neste trinn er å kjøre selve prosjektet. Avhengig av standard nettleser installert på systemet, vil det aktuelle nettlesernavnet komme ved siden av Run-knappen i Visual Studio. I vårt tilfelle har vi Google Chrome dukker opp. Bare klikk på denne knappen.

Produksjon:-

Når prosjektet er kjørt, kan du bla til TutorialService.svc / Tutorial-delen, og du vil få utdataene nedenfor.

I ovennevnte utdata,

  • Du kan se at nettleseren påkaller 'GET' verbet og utfører 'GetAllTutorial' -metoden i nettjenesten. Denne modulen brukes til å vise alle opplæringene som er eksponert av vår nettjeneste.

Testing av din første avslappende nettjeneste

I avsnittet ovenfor har vi allerede sett hvordan du bruker nettleseren til å utføre 'GET' verbet og påkalle 'GetAllTutorial.'

  1. La oss nå bruke nettleseren til å utføre følgende bruksscenario.

GET Tutorial / Tutorialid - Når en klient påkaller denne Restful API, vil de få opplæringsnavnet basert på Tutorialid sendt av klienten

I nettleseren din legger du til strengen / 1 etter opplæringsordet i URL-en. Hvis du trykker på enter-knappen, får du utdataene nedenfor

Nå vil du se utdataene fra køer som faktisk tilsvarer nummer 1 i vår liste over opplæringsstrenger. Dette betyr at 'GetTutorialbyID' -metoden nå blir påkalt fra vår webservice. Det viser også at verdien på 1 blir sendt vellykket via nettleseren til vår webtjeneste og til vår metode, og det er derfor vi får riktig tilsvarende verdi av "Køer" i nettleseren.

  1. La oss deretter konsumere nettjenesten vår ved å utføre scenariet nedenfor. For dette må du installere verktøyet kalt "Fiddler", som er et gratis nedlastbart verktøy fra nettstedet.

POST-veiledning / opplæringsnavn - Når en klient påkaller dette Restful API, vil klienten sende inn en forespørsel om å sette inn et opplæringsnavn. Nettjenesten vil da legge til det innsendte opplæringsnavnet i samlingen.

Kjør Filddler-verktøyet og utfør trinnene nedenfor;

  1. Gå til komponistseksjonen. Dette brukes til å lage forespørsler som kan sendes til hvilket som helst nett

    applikasjon.

  2. Forsikre deg om at forespørselstypen er "POST" og at riktig URL treffes, som i vårt tilfelle skal være http: // localhost: 52645 / TutorialService.svc / Tutorial
  3. Forsikre deg om at innholdstypen er merket som applikasjon / json. Husk at POST-forespørselsmetoden vår i nettjenesten bare godtar json-stildata, så vi må sørge for at dette er spesifisert når vi sender en forespørsel til applikasjonen vår.
  4. Til slutt må vi legge inn dataene våre. Husk at metoden vår for POST godtar en parameter kalt 'str.' Så her spesifiserer vi at vi vil legge til en verdi kalt "Trees" i vår samling av opplæringsnavn og sørge for at den er merket med navnet på str-variabelen.

Til slutt er det bare å klikke på Utfør-knappen i spelemannen. Dette vil sende en forespørsel til nettjenesten om å POSTE dataene "Trees" til vår webtjeneste.

Nå, når vi blar til URL for opplæring for å vise alle strengene i opplæringslisten vår, vil du nå se at verdien til "Trees" også er til stede. Dette viser at POST-forespørselen til nettjenesten ble fullført og at den ble lagt til i vår opplæringsliste.

  1. La oss deretter konsumere nettjenesten vår ved å utføre scenariet nedenfor. For dette må vi også bruke spillemannsverktøyet

DELETE Tutorial / Tutorialid- Når en klient påkaller denne Restful API, vil klienten sende inn en forespørsel om å slette et Tutorialname basert på Tutorialid. Nettjenesten vil da slette det innsendte opplæringsnavnet fra samlingen.

Kjør Filddler-verktøyet og utfør trinnene nedenfor

  1. Gå til komponistseksjonen. Dette brukes til å lage forespørsler som kan sendes til hvilket som helst nett

    applikasjon.

  2. Forsikre deg om at forespørselstypen er "SLETT" og at riktig URL blir truffet, som i vårt tilfelle skal være http: // localhost: 52645 / TutorialService.svc / Tutorial . Forsikre deg om at ID-en som brukes til å slette en streng i listen som sendes via URL-en som parameter. I vårt REST eksempel sender vi en så dette vil slette 2 nd element i vår samling som er "Køer".

Til slutt er det bare å klikke på Utfør-knappen i spelemannen. Dette vil sende en forespørsel til nettjenesten om å SLETTE dataene "Køer" til vår nettjeneste.

Nå, når vi blar til opplærings-URL for å vise alle strengene i opplæringslisten vår, vil du legge merke til at verdien til "køer" ikke lenger er til stede.

Dette viser at DELETE-forespørselen til nettjenesten ble utført. Elementet i indeks nr. 1 i listen over opplæringsstrenger ble slettet.

Sammendrag

  • REST står for REpresentational State Transfer. REST brukes til å bygge webtjenester som er lette, vedlikeholdbare og skalerbare.
  • Flere og flere applikasjoner flytter til den avslappende arkitekturen. Dette er fordi det er mange som nå bruker mobile enheter og et bredere utvalg av applikasjoner som flytter til skyen.
  • Hovedaspektene ved REST er ressursene som ligger på serveren og verbene til GET, POST, PUT og DELETE, som kan brukes til å jobbe med disse ressursene.
  • Visual Studio og.Net kan brukes til å lage Restful web-tjenester.
  • Når du tester nettjenester for POST og PUT, må du bruke et annet verktøy kalt spillemann som kan brukes til å sende POST og PUT-forespørselen til serveren.