WCF入門教程之Windows通訊接口
概述
WCF:Windows Communication Foundation ,Windows通信基礎(chǔ)。
SOP:Service Orientation Architechture,面向服務(wù)的架構(gòu)。
WebService是以BasicHttpBing方式運行的WCF。
方案結(jié)構(gòu):
1、創(chuàng)建解決方案WCFService
依次添加四個項目,如上圖,Client和Hosting為控制臺應(yīng)用程序,Service和Service.Interface均為類庫。
2、引用關(guān)系
- Service.Interface:定義服務(wù)契約(Service Contract)接口,引用WCF核心庫System.ServiceModel.dll;
- Service:定義服務(wù)的項目,由于需要實現(xiàn)具體的服務(wù),而服務(wù)契約在Service.Interface中,所以要引用Service.Interface項目;
- Hosting:服務(wù)宿主的控制臺程序,需要引用Service.Interface和Service項目,同時還要引用System.ServiceModel.dll類庫:
- Client:一個控制臺應(yīng)用程序的客戶端,需要引用Service.ServiceModel類庫。
一、Contracts協(xié)定
一個類庫項目,定義服務(wù)契約。
服務(wù)契約抽象了服務(wù)的所有操作,一般契約為接口形式存在。
//服務(wù)協(xié)定 [ServiceContract(Name = "ICalculator", Namespace = "http://SampleWcfTest")] //webservice描述文件用的portType命名空間 //CallbackContract =typeof(ICallBack),//雙工時的返回協(xié)定 //ConfigurationName = "Calculator",//配置文件重的服務(wù)名 //ProtectionLevel = System.Net.Security.ProtectionLevel.EncryptAndSign,//保護等級 //SessionMode = SessionMode.Allowed//設(shè)置會話的支持模式 public interface ICalculator { //操作協(xié)定 [OperationContract] double Add(double n1, double n2); }
二、Services服務(wù)
一個類庫項目,提供對契約的實現(xiàn)。
public class Calculator : ICalculator { public double Add(double n1, double n2) { double result = n1 + n2; Console.WriteLine("Received Add({0},{1})", n1, n2); // Code added to write output to the console window. Console.WriteLine("Return: {0}", result); return result; } }
VS的“WCF服務(wù)庫項目”自動生成了svc文件和對應(yīng)的svc.cs文件以及App.config文件,運行此項目,會自動啟動“WCF服務(wù)主機”和“WCF測試客戶端”窗口
三、ServiceHost自我服務(wù)宿主
一個控制臺項目,通過自我寄宿的方式作為Sevice項目服務(wù)的宿主。寄宿進程為ServiceHost1.exe。
服務(wù)寄宿的目的是開啟一個進程,為WCF服務(wù)提供一個運行環(huán)境,并為服務(wù)添加一個或者多個終結(jié)點,然后暴漏給服務(wù)消費者。
WCF服務(wù)需要一個運行著的宿主進程,服務(wù)寄宿就是給服務(wù)指定一個宿主的過程。、
終結(jié)點(EndPoint)
WCF采用基于終結(jié)點(EndPoint)的通信手段。終結(jié)點有地址(Address),綁定(Binding)和契約(Contract)三部分組成,三要素也可以記作:EndPoint=ABC。
一個終結(jié)點包含了通信所必須的所有信息,具體如下:
- Address:地址決定了服務(wù)的位置,解決了尋址的問題;
- Binding:綁定實現(xiàn)了通信的所有細節(jié),包括網(wǎng)絡(luò)傳輸,消息編碼,以及其他為實現(xiàn)某種功能(比如傳輸安全,可靠消息傳輸,事務(wù)等)對消息進行的相應(yīng)處理。
WCF中具有一系列的系統(tǒng)定義綁定,比如BasicHttpBinding,WSHttpBinding和NetTcpBinding,WSHttpBinding、NetMsmqBindiing等; - Contract:契約是對服務(wù)操作的抽象,也是對消息交換模式以及消息結(jié)構(gòu)的定義。
1、編碼方式
//承載服務(wù)的宿主 using (ServiceHost selfHost = new ServiceHost(typeof(Calculator))) { try { //添加服務(wù)終結(jié)點 selfHost.AddServiceEndpoint(typeof(ICalculator), new WSHttpBinding(), new Uri("http://localhost:8000/GettingStarted/")); //添加服務(wù)元數(shù)據(jù)行為 if (selfHost.Description.Behaviors.Find() == null) { ServiceMetadataBehavior smb = new ServiceMetadataBehavior(); smb.HttpGetEnabled = true; smb.HttpGetUrl = new Uri("http://localhost:8000/GettingStarted/metadata") selfHost.Description.Behaviors.Add(smb); } selfHost.Open(); Console.WriteLine("The service is ready."); Console.WriteLine("input to terminate service."); Console.WriteLine(); while ("exit" == Console.ReadLine()) { selfHost.Close(); } } catch (CommunicationException ex) { Console.WriteLine(ex.Message); selfHost.Abort(); } }
2、配置文件方式
打開Hosting項目中的app.config,添加以下代碼即可。
可直接右鍵點擊config文件選擇“編輯WCF配置”菜單,或通過VS的“工具”菜單,選擇“WCF Service配置編輯器”菜單編輯配置文件。
<configuration> <startup> <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" /> </startup> <system.serviceModel> 服務(wù) <service name="Service.CalculatorService" behaviorConfiguration="metadataBehavior"> <endpoint address="http://127.0.0.1:1111/GettingStarted" binding="wsHttpBinding" contract="Service.Interface.ICalculator"></endpoint> </service> </services> 行為 <serviceBehaviors> <behavior name="metadataBehavior"> <serviceMetadata httpGetEnabled="true" httpGetUrl="http://127.0.0.1:1111/GettingStarted/metadata"/> </behavior> </serviceBehaviors> </behaviors> </system.serviceModel> </configuration>
Hosting代碼修改如下:
using (ServiceHost host = new ServiceHost(typeof(CalculatorService))) { host.Opened += delegate { Console.Write("CalculatorService已經(jīng)啟動,按任意鍵終止服務(wù)"); }; host.Open(); Console.Read(); }
四、IIS宿主
一個Web應(yīng)用程序,通過IIS寄宿的方式將服務(wù)寄宿于IIS中,
寄宿進程為w3wp.exe。WAS激活服務(wù):Window Activation Services。
1、創(chuàng)建WCF服務(wù)文件:CalculatorService.svc:
<%@ ServiceHost Sevice=”GettingStarted.CalculatorService” %>
2、配置文件
與app.config相比,web.config無EndPointAddress?服務(wù)的地址為.svc所在的地址,默認的元數(shù)據(jù)為…../CalculatorService.svc?ws…
<system.serviceModel> <services> <service name="GettingStarted.CalculatorService" behaviorConfiguration="metadataBehavior" > <endpoint address="CalculatorService" binding="wsHttpBinding" contract="Calculator"/> </service> </services> <behaviors> <serviceBehaviors> <behavior name="metadataBehavior" > <serviceMetadata httpGetEnabled="true" /> </behavior> </serviceBehaviors> </behaviors> </system.serviceModel>
五、實現(xiàn)Rest 風格的web服務(wù)
可以使用 WCF REST 編程模型。
默認WebHttpBinding。
在協(xié)定的實現(xiàn)方式上添加 WebGet或者WebInvoke屬性
[OperationContract] [WebInvoke(UriTemplate = "div?x={x}&y={y}")] long Divide(long x, long y); [OperationContract] [WebGet(UriTemplate = "hello?name={name}")] string SayHello(string name);
舉例2:
[ServiceContract] public interface ITestService { [OperationContract] [WebInvoke(Method = "POST", UriTemplate = "Test1", RequestFormat = WebMessageFormat.Json, ResponseFormat = WebMessageFormat.Json, BodyStyle = WebMessageBodyStyle.Wrapped)] string Test1(string userName, string password); [OperationContract] [WebGet(UriTemplate = "Test/{id}", RequestFormat = WebMessageFormat.Json, ResponseFormat = WebMessageFormat.Json, BodyStyle = WebMessageBodyStyle.Bare)] string Test(string id); }
六、使用預(yù)配置的主機類WebServiceHost
使用WebServiceHost類
Uri baseAddress = new Uri("http://localhost:8000/"); WebServiceHost svcHost = new WebServiceHost(typeof(CalcService), baseAddress); try { svcHost.Open(); Console.WriteLine("Service is running"); Console.WriteLine("Press enter to quit..."); Console.ReadLine(); svcHost.Close(); } catch (CommunicationException cex) { Console.WriteLine("An exception occurred: {0}", cex.Message); svcHost.Abort(); }
3、調(diào)用:
http://…/div?x=1&y=2
七、client:一個客戶端
1、使用VS“添加服務(wù)引用”生成的CalculatorServiceClient
CalculatorServiceClient基類是System.ServiceModel.ClientBase,該基類封裝了ChannelFactory
using (CalculatorServiceClient proxy = new CalculatorServiceClient()) { double result = proxy.Add(1, 2); Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result); }
2、不用添加服務(wù)引用,使用ChannelFactory方式
//using (ChannelFactory channelFactory = new ChannelFactory(new WSHttpBinding(), "<a rel="external nofollow" target="_blank">http://127.0.0.1</a>:1111/CalculatorService"))//構(gòu)造函數(shù)中指定了終結(jié)點的ABC三要素, using (ChannelFactory channelFactory = new ChannelFactory("CalculatorService"))//通過配置文件來進行,對應(yīng)的為config 文件中終結(jié)點的name { ICalculator proxy = channelFactory.CreateChannel(); using (proxy as IDisposale) { Console.WriteLine("x+y={2} when x={0} and y={1}", 1, 2, proxy.Add(1, 2)); } }
配置文件:
<configuration> <system.serviceModel> <client> <endpoint name="CalculatorService" address="http://127.0.0.1:1111/CalculatorService" binding="wsHttpBinding" contract="Service.Interface.ICalculator" /> </client> </system.serviceModel> </configuration>
八、綁定類型
WCF中常用的binding方式:
1. 基于HTTP的綁定
BasicHttpBinding、WSHttpBinding、WSDualHttpBinding和WSFederationHttpBinding選項適合于通過XML Web服務(wù)協(xié)議提供契約類型。顯然,如果需要使該服務(wù)可適用于更多場合(多種操作系統(tǒng)和多種編程語言),這些就是需要關(guān)注的綁定,因為所有這些綁定類型都基于XML表示編碼數(shù)據(jù)并且使用HTTP傳送數(shù)據(jù)。
在下面清單中,注意到可以在代碼中表示W(wǎng)CF綁定(通過System.ServiceModel名稱空間中的類類型),或者作為在*.config文件中定義的XML屬性表示W(wǎng)CF綁定。
- BasicHttpBinding:用于綁定符合WS-Basic Profile(WS-I Basic Profile 1.1)的WCF服務(wù)。該綁定使用HTTP作為傳送方式,并且使用Text/XML作為默認消息編碼。用于兼容舊的Web ASMX 服務(wù)。
BasicHttpBinding是所有以Web服務(wù)為中心的協(xié)議中最簡單的協(xié)議。特別是,該綁定將確保WCF服務(wù)符合由WS-I定義的名為WS-I Basic Profile 1.1的規(guī)范。 - WSHttpBinding:類似于BasicHttpBinding,但是提供了更多的Web服務(wù)特性。該綁定添加對事務(wù)、可靠消息發(fā)送和WS-Addressing的支持。
WSHttpBinding協(xié)議不僅集成了對WS-*規(guī)范(事務(wù)、安全性和可靠會話)子集的支持,而且支持使用消息傳輸優(yōu)化機制(Message Transmission Optimization Mechanism,MTOM)處理二進制數(shù)據(jù)編碼的能力。 - WSDualHttpBinding:類似于WSHttpBinding,但是用于與雙向契約結(jié)合使用(例如,服務(wù)和客戶可以來回發(fā)送消息)。該綁定只支持SOAP安全性,并且需要可靠的消息發(fā)送。
WSDualHttpBinding的主要優(yōu)點是它添加了允許調(diào)用者和發(fā)送方使用雙向消息發(fā)送(duplex messaging)通信的能力,這是一種表示調(diào)用者和發(fā)送方可以參加雙向會談的流行方法。在選擇WSDualHttpBinding時,可以與WCF發(fā)布/訂閱事件模型建立關(guān)聯(lián)。 - WSFederationHttpBinding:安全的和可互操作的綁定,該綁定支持WS-Federation協(xié)議,并且允許位于聯(lián)盟內(nèi)的組織有效地驗證和授權(quán)用戶
WSFederationHttpBinding是基于Web服務(wù)的協(xié)議,在安全性最為重要時就需要使用該協(xié)議。該綁定支持WS-Trust、WS-Security和WS-SecureConversation規(guī)范,通過WCF CardSpace API表示這些規(guī)范。 - WebHttpBinding:用于通過HTTP(非SOAP)請求提供的服務(wù)隊腳本客戶端有用,如ASPNet AJAX。
2. 基于TCP的綁定
如果正在構(gòu)建一個分布式系統(tǒng),該系統(tǒng)涉及使用.NET 3.0/3.5庫配置的一組連網(wǎng)機器(換句話說,所有機器都運行Windows XP、Windows Server 2003或Windows Vista),就可以通過繞開Web服務(wù)綁定并選擇使用TCP綁定來增強性能,TCP綁定確保以緊湊二進制格式(而不是XML)編碼所有數(shù)據(jù)。同樣,在使用下表的的綁定時,客戶和主機必須是.NET應(yīng)用程序。
- NetNamedPipeBinding:用于相同機器上不同.NET應(yīng)用程序之間通信的安全的、可靠的、優(yōu)化的綁定。
NetNamedPipeBinding支持事務(wù)、可靠的會話和安全的通信,但是它不能夠執(zhí)行跨機器的調(diào)用。如果您正在尋找在相同機器上的WCF應(yīng)用程序之間推動數(shù)據(jù)(例如,跨越應(yīng)用程序的域通信)的最快速方法,NetNamedPipeBinding綁定就是最佳的選擇。 - NetPeerTcpBinding:為對等(P2P)網(wǎng)絡(luò)應(yīng)用程序提供安全的綁定。
至于NetPeerTcpBinding,可查閱.NET Framework 3.5 SDK文檔以了解關(guān)于P2P連網(wǎng)的細節(jié)。 - NetTcpBinding:適合于不同機器上.NET應(yīng)用程序之間通信的安全的、優(yōu)化的綁定。
NetTcpBinding類使用TCP在客戶和WCF服務(wù)之間移動二進制數(shù)據(jù)。前面提及,這將導(dǎo)致比Web服務(wù)協(xié)議更佳的性能,但是只限于內(nèi)部應(yīng)用程序解決方案。此外,NetTcpBinding支持事務(wù)、可靠的會話和安全的通信。
3. 基于MSMQ的綁定
- MsmqIntegrationBinding:該綁定可用于允許WCF應(yīng)用程序向已有的MSMQ應(yīng)用程序發(fā)送消息以及從這種應(yīng)用程序接收消息,這種應(yīng)用程序使用COM、本地C++或定義在System.Messaging名稱空間中的類型
- NetMsmqBinding:這個排隊的綁定適合于不同機器上的.NET應(yīng)用程序之間的通信
注:二進制編碼格式使用TCP、IPC、MSMQ可以獲取最佳性能,但是它是以犧牲互操作性為代價,因為它只支持WCF到WCF的通信。
到此這篇關(guān)于WCF入門教程之Windows通訊接口的文章就介紹到這了。希望對大家的學習有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
C# http系列之以form-data方式上傳多個文件及鍵值對集合到遠程服務(wù)器
這篇文章主要介紹了C# http系列之以form-data方式上傳多個文件及鍵值對集合到遠程服務(wù)器,需要的朋友可以參考下2019-08-08C# HttpClient 如何使用 Consul 發(fā)現(xiàn)服務(wù)
這篇文章主要介紹了C# HttpClient 如何使用 Consul 發(fā)現(xiàn)服務(wù),幫助大家更好的理解和使用c#,感興趣的朋友可以了解下2021-02-02C#中WPF內(nèi)存回收與釋放LierdaCracker的實現(xiàn)
本文主要介紹了C#中WPF內(nèi)存回收與釋放LierdaCracker的實現(xiàn),文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2022-07-07