Temel HTTP Hizmeti

TemelHttpService örneği, Windows Communication Foundation (WCF) REST Programlama modelini kullanarak HTTP tabanlı, RPC tabanlı bir hizmetin (popüler olarak "POX" (Düz Eski XML) hizmeti olarak adlandırılır) nasıl uygulanduğunu gösterir. Bu örnek iki bileşenden oluşur: şirket içinde barındırılan WCF HTTP hizmeti (Service.cs) ve hizmeti oluşturan ve ona çağrı yapan bir konsol uygulaması (Program.cs).

Örnek Ayrıntılar

WCF hizmeti, EchoWithGet ve EchoWithPost adlı 2 işlemi kullanıma sunar, bu işlemler giriş olarak geçirilen dizeyi döndürür.

EchoWithGet işlemi için, HTTP WebGetAttribute isteklerini işleyeceğini belirten GET ile bir açıklama eklenir. WebGetAttribute açıkça bir UriTemplate belirtmediğinden, işlem s adlı bir sorgu dizesi parametresi kullanılarak giriş dizesinin geçirilmesini bekler. Hizmetin beklediği URI biçiminin özelliği kullanılarak UriTemplate özelleştirilebileceğini unutmayın.

EchoWithPost işlemi, WebInvokeAttribute ile açıklanmıştır ve bu, bir GET işlemi olmadığını (yan etkileri vardır) belirtir. WebInvokeAttribute açıkça bir Method belirtmediği için, işlem, istek gövdesinde (örneğin, XML formatında) dizgi bulunan HTTP POST isteklerini işler. HTTP yönteminin ve URI biçiminin istek için Method ve UriTemplate özellikleri kullanılarak özelleştirilebileceğini unutmayın.

App.config dosyası, WebHttpEndpoint özelliği HelpEnabled olarak ayarlanmış bir varsayılan true ile WCF hizmetini yapılandırmaktadır. Sonuç olarak WCF altyapısı, hizmete HTTP istekleri oluşturma ve hizmetin HTTP yanıtını kullanma hakkında bilgi sağlayan otomatik HTML tabanlı bir yardım sayfası http://localhost:8000/Customers/help oluşturur.

Program.cs, bir WCF kanalı fabrikasının hizmete çağrı yapmak ve yanıtları işlemek için nasıl kullanılabileceğini gösterir. Bunun bir WCF hizmetine erişmenin yalnızca bir yolu olduğunu unutmayın. ve HttpWebRequestgibi WebClient diğer .NET Framework sınıflarını kullanarak hizmete erişmek de mümkündür.

Örnek, kendi kendine barındırılan bir hizmet ve her ikisi de bir konsol uygulamasında çalışan bir istemciden oluşur. Konsol uygulaması çalışırken istemci hizmete istekte bulunur ve yanıtlardan konsol penceresine ilgili bilgileri yazar.

Bu örneği kullanmak için

1. Temel Http Hizmeti Örneği için çözümü açın. Visual Studio 2012'yi başlatırken, örneğin başarıyla yürütülmesi için yönetici olarak çalıştırmanız gerekir. Visual Studio simgesine sağ tıklayıp bağlam menüsünden Yönetici Olarak Çalıştır'ı seçerek bunu yapın.

2. Çözümü oluşturmak için Ctrl+Shift+B tuşlarına basın ve ardından Ctrl+F5 tuşlarına basarak konsol uygulamasını hata ayıklamadan çalıştırın. Konsol penceresi görüntülenir ve çalışan hizmetin URI'sini ve çalışan hizmet için HTML yardım sayfasının URI'sini sağlar. Herhangi bir zamanda, tarayıcıya yardım sayfasının URI'sini yazarak HTML yardım sayfasını görüntüleyebilirsiniz. Örnek çalışırken istemci geçerli etkinliğin durumunu yazar.

3. Örneği sonlandırmak için bir tuşa basın.