Grundläggande HTTP-tjänst

Exemplet BasicHttpService visar hur du implementerar en HTTP-baserad, RPC-baserad tjänst – som ofta kallas "POX"-tjänst (vanlig gammal XML) med hjälp av WINDOWS Communication Foundation (WCF) REST Programming-modellen. Det här exemplet består av två komponenter: en lokalt installerad WCF HTTP-tjänst (Service.cs) och ett konsolprogram (Program.cs) som skapar tjänsten och anropar den.

Exempelinformation

WCF-tjänsten exponerar två åtgärder EchoWithGet och EchoWithPost, som returnerar strängen som skickades som indata.

Åtgärden EchoWithGet kommenteras med WebGetAttribute, vilket anger att åtgärden bearbetar HTTP-begäranden GET . Eftersom WebGetAttribute inte uttryckligen anger en UriTemplate, förväntar sig operationen att indatasträngen skickas med hjälp av en frågesträngsparameter med namnet s. Observera att formatet för den URI som tjänsten förväntar sig kan anpassas med hjälp av UriTemplate egenskapen .

Åtgärden EchoWithPost kommenteras med WebInvokeAttribute, vilket indikerar att det inte är en GET åtgärd (den har biverkningar). Eftersom inte uttryckligen WebInvokeAttribute anger en Method, bearbetar åtgärden HTTP-begäranden POST som har strängen i begärandetexten (i XML-format, till exempel). Observera att HTTP-metoden och formatet för URI:n för begäran kan anpassas med respektive MethodUriTemplate egenskaper.

Filen App.config konfigurerar WCF-tjänsten med en standardinställning WebHttpEndpoint som har HelpEnabled egenskapen inställd på true. Därför skapar WCF-infrastrukturen en automatisk HTML-baserad hjälpsida på http://localhost:8000/Customers/help som innehåller information om hur du konstruerar HTTP-begäranden till tjänsten och hur du använder tjänstens HTTP-svar.

Program.cs visar hur en WCF-kanalfabrik kan användas för att göra anrop till tjänsten och bearbeta svar. Observera att detta bara är ett sätt att komma åt en WCF-tjänst. Det går också att komma åt tjänsten med hjälp av andra .NET Framework-klasser som HttpWebRequest och WebClient.

Exemplet består av en lokalt installerad tjänst och en klient som båda körs i ett konsolprogram. När konsolprogrammet körs skickar klienten begäranden till tjänsten och skriver relevant information från svaren till konsolfönstret.

Så här använder du det här exemplet

1. Öppna lösningen för Exempel på grundläggande HTTP-tjänst. När du startar Visual Studio 2012 måste du köra som administratör för att exemplet ska kunna köras korrekt. Gör detta genom att högerklicka på Visual Studio-ikonen och välja Kör som administratör på snabbmenyn.

2. Tryck på Ctrl+Skift+B för att skapa lösningen och tryck sedan på Ctrl+F5 för att köra konsolprogrammet utan att felsöka. Konsolfönstret visas och tillhandahåller URI för den tjänst som körs och URI:n för HTML-hjälpsidan för den tjänst som körs. När som helst kan du visa HTML-hjälpsidan genom att skriva URI:n för hjälpsidan i en webbläsare. När exemplet körs skriver klienten status för den aktuella aktiviteten.

3. Tryck på valfri tangent för att avsluta exemplet.