Sdílet prostřednictvím

Základní služba HTTP

  • Článek

Ukázka BasicHttpService ukazuje, jak implementovat službu založenou na protokolu RPC založenou na protokolu HTTP , která se často označuje jako "POX" (Plain Old XML) pomocí programovacího modelu REST služby Windows Communication Foundation (WCF). Tato ukázka se skládá ze dvou komponent: místní služby WCF HTTP (Service.cs) a konzolové aplikace (Program.cs), která vytvoří službu a volá ji.

Ukázkové podrobnosti

Služba WCF zveřejňuje 2 operace EchoWithGet a EchoWithPost, která vrací řetězec, který byl předán jako vstup.

Operace EchoWithGet je opatřena poznámkami WebGetAttribute, což označuje, že operace zpracovává požadavky HTTP GET . WebGetAttribute Vzhledem k tomu, že není explicitně zadána UriTemplate, operace očekává předání vstupního řetězce pomocí parametru řetězce dotazu s názvem s. Všimněte si, že formát identifikátoru URI, který služba očekává, lze přizpůsobit pomocí UriTemplate vlastnosti.

Operace EchoWithPost je opatřena poznámkami WebInvokeAttribute, což znamená, že se nejedná o GET operaci (má vedlejší účinky). WebInvokeAttribute Vzhledem k tomu, že není explicitně zadána Method, operace zpracovává požadavky HTTPPOST, které mají řetězec v textu požadavku (například ve formátu XML). Všimněte si, že metodu HTTP a formát identifikátoru URI požadavku lze přizpůsobit pomocí Method vlastností a UriTemplate vlastností.

Soubor App.config nakonfiguruje službu WCF s výchozí WebHttpEndpoint vlastností nastavenou HelpEnabled na true. V důsledku toho infrastruktura WCF vytvoří automatickou stránku nápovědy založenou na HTML, která http://localhost:8000/Customers/help poskytuje informace o tom, jak vytvořit požadavky HTTP na službu a jak využívat odpověď HTTP služby.

Program.cs ukazuje, jak lze objekt pro vytváření kanálů WCF použít k volání služby a zpracování odpovědí. Všimněte si, že je to jen jeden způsob, jak získat přístup ke službě WCF. Je také možné přistupovat ke službě pomocí jiných tříd rozhraní .NET Framework, jako a HttpWebRequestWebClient.

Ukázka se skládá ze služby v místním prostředí a klienta, který běží v rámci konzolové aplikace. Při spuštění konzolové aplikace klient odešle žádosti do služby a zapíše příslušné informace z odpovědí do okna konzoly.

Použití této ukázky

  1. Otevřete řešení pro základní ukázku služby HTTP. Při spuštění sady Visual Studio 2012 musíte spustit jako správce, aby se ukázka úspěšně spustila. Uděláte to tak, že v místní nabídce kliknete pravým tlačítkem na ikonu sady Visual Studio a vyberete Spustit jako Správa istrator.

  2. Stisknutím kombinace kláves Ctrl+Shift+B sestavte řešení a stisknutím kláves Ctrl+F5 spusťte konzolovou aplikaci bez ladění. Zobrazí se okno konzoly a poskytne identifikátor URI spuštěné služby a identifikátor URI stránky nápovědy HTML pro spuštěnou službu. Kdykoli můžete zobrazit stránku nápovědy HTML zadáním identifikátoru URI stránky nápovědy v prohlížeči. Při spuštění ukázky zapíše klient stav aktuální aktivity.

  3. Stisknutím libovolné klávesy ukončete ukázku.