WCF客戶(hù)端具體搭建方法解析
我們?cè)谝幌盗械奈恼轮袨榇蠹以敿?xì)介紹了有關(guān)WCF的相關(guān)基礎(chǔ)內(nèi)容,相信大家應(yīng)該可以通過(guò)我們介紹的內(nèi)容能夠充分掌握這一工具的應(yīng)用方法。在這里我們繼續(xù)對(duì)WCF客戶(hù)端的相關(guān)應(yīng)用方法做一個(gè)介紹。#t#
搭建WCF客戶(hù)端,最重要就是要遵循服務(wù)端的契約,客戶(hù)端通過(guò)代理(Proxy)來(lái)訪問(wèn)服務(wù)端點(diǎn),而并不關(guān)心服務(wù)端的具體實(shí)現(xiàn)。代理要做的就是通過(guò)與服務(wù)端確認(rèn)通訊協(xié)議,并通過(guò)信道(channels)交換數(shù)據(jù)。在服務(wù)端,ServiceHost會(huì)為每個(gè)端點(diǎn)創(chuàng)建一個(gè)信道偵聽(tīng)器,由偵聽(tīng)器產(chǎn)生信道。而客戶(hù)端代理則產(chǎn)生一個(gè)信道發(fā)生器,產(chǎn)生客戶(hù)端信道。只有在服務(wù)端信道和客戶(hù)端信道一致的情況下,雙方才允許進(jìn)行通訊。信道會(huì)對(duì)通訊過(guò)程進(jìn)行監(jiān)控,保障通訊的安全性。
為了簡(jiǎn)單的完成一個(gè)WCF客戶(hù)端,微軟為我們準(zhǔn)備了一個(gè)小工具,就是Service Model Metadata Utility。這個(gè)工具能幫你快速的從服務(wù)地址中生成客戶(hù)代理和配置文件。
首先允許服務(wù)器端程序,等服務(wù)啟動(dòng)后。在VS2008命令行窗口中輸入如下命令:svcutil.exe http://localhost:8080/MyWCF 回車(chē)后得到如下頁(yè)面。
從上面畫(huà)面中可以看到,wcf為客戶(hù)端生成了一個(gè)客戶(hù)代理類(lèi)TemperatureService.cs和一個(gè)配置文件output.config??蛻?hù)端只需要整合這兩個(gè)文件就可以與服務(wù)端通訊了。我們來(lái)看看這兩個(gè)文件的內(nèi)容:
- TemperatureService.cs
- // < auto-generated>
- // 此代碼由工具生成。
- // 運(yùn)行時(shí)版本:2.0.50727.3053
- //
- // 對(duì)此文件的更改可能會(huì)導(dǎo)致不正確的行為,并且如果
- // 重新生成代碼,這些更改將會(huì)丟失。
- // < /auto-generated>
- [System.CodeDom.Compiler.GeneratedCodeAttribute
("System.ServiceModel", "3.0.0.0")]- [System.ServiceModel.ServiceContractAttribute
(ConfigurationName = "IContract")]- public interface IContract
- {
- [System.ServiceModel.OperationContractAttribute(Action =
"http://tempuri.org/IContract/GetFahrenheit", ReplyAction =
"http://tempuri.org/IContract/GetFahrenheitResponse")]- float GetFahrenheit(float celsius);
- }
- [System.CodeDom.Compiler.GeneratedCodeAttribute
("System.ServiceModel", "3.0.0.0")]- public interface IContractChannel : IContract, System.
ServiceModel.IClientChannel- {
- }
- [System.Diagnostics.DebuggerStepThroughAttribute()]
- [System.CodeDom.Compiler.GeneratedCodeAttribute("System.
ServiceModel", "3.0.0.0")]- public partial class ContractClient : System.ServiceModel.
ClientBase< IContract>, IContract- {
- public ContractClient()
- {
- }
- public ContractClient(string endpointConfigurationName) :
- base(endpointConfigurationName)
- {
- }
- public ContractClient(string endpointConfigurationName, string remoteAddress) :
- base(endpointConfigurationName, remoteAddress)
- {
- }
- public ContractClient(string endpointConfigurationName,
System.ServiceModel.EndpointAddress remoteAddress) :- base(endpointConfigurationName, remoteAddress)
- {
- }
- public ContractClient(System.ServiceModel.Channels.Binding binding,
System.ServiceModel.EndpointAddress remoteAddress) :- base(binding, remoteAddress)
- {
- }
- public float GetFahrenheit(float celsius)
- {
- return base.Channel.GetFahrenheit(celsius);
- }
- }
從這個(gè)文件可以看到,WCF客戶(hù)端實(shí)際上是繼承了兩個(gè)接口,System.ServiceModel.ClientBase< IContract>和IContract。其中IContract是服務(wù)端契約的接口。
output.config
- < ?xml version="1.0" encoding="utf-8"?>
- < configuration>
- < system.serviceModel>
- < bindings>
- < basicHttpBinding>
- < binding name="BasicHttpBinding_IContract" closeTimeout="00:01:00"
- openTimeout="00:01:00" receiveTimeout="00:10:00" sendTimeout="00:01:00"
- allowCookies="false" bypassProxyOnLocal="false"
hostNameComparisonMode="StrongWildcard"- maxBufferSize="65536" maxBufferPoolSize="524288"
maxReceivedMessageSize="65536"- messageEncoding="Text" textEncoding="utf-8" transferMode="Buffered"
- useDefaultWebProxy="true">
- < readerQuotas maxDepth="32" maxStringContentLength="8192"
maxArrayLength="16384"- maxBytesPerRead="4096" maxNameTableCharCount="16384" />
- < security mode="None">
- < transport clientCredentialType="None" proxyCredentialType="None"
- realm="" />
- < message clientCredentialType="UserName" algorithmSuite="Default" />
- < /security>
- < /binding>
- < /basicHttpBinding>
- < /bindings>
- < client>
- < endpoint address="http://localhost:8080/MyWCF"
binding="basicHttpBinding"- bindingConfiguration="BasicHttpBinding_IContract" contract="IContract"
- name="BasicHttpBinding_IContract" />
- < /client>
- < /system.serviceModel>
- < /configuration>
output.config文件則定義了和服務(wù)端匹配的endpoint,有了這兩個(gè)文件,***要做的事情就是將其整合到WCF客戶(hù)端程序中,其步驟如下:
1)建立一個(gè)空白解決方案,方案的名稱(chēng)叫MyWCFClient,添加一個(gè)名稱(chēng)為MyWCF.Client的ConsoleApplication項(xiàng)目。在該項(xiàng)目中添加System.ServiceModel的引用。
2)另外在方案中再添加一個(gè)類(lèi)庫(kù)項(xiàng)目,項(xiàng)目名稱(chēng)叫MyWCF.ClientBase,為項(xiàng)目添加System.ServiceModel的引用,類(lèi)名改為ClientBase。將TemperatureService.cs文件中的代碼拷貝到ClientBase中的命名空間引用下。
3)在項(xiàng)目MyWCF.Client項(xiàng)目中添加一個(gè)App.config文件,將output.config文件的代碼粘貼到該文件中覆蓋原來(lái)的代碼。并為該項(xiàng)目添加對(duì)MyWCF.ClientBase項(xiàng)目和System.ServiceModel的引用。
4)在項(xiàng)目MyWCF.Client的Main方法中添加如下代碼。
- using System;
- using System.Collections.Generic;
- using System.Text;
- using MyWCF.ClientBase;
- namespace MyWCF.Client
- {
- class Program
- {
- static void Main(string[] args)
- {
- ContractClient CC = new ContractClient();
- float result = CC.GetFahrenheit(23.4f);
- Console.WriteLine("華氏溫度為{0}度!", result);
- }
- }
- }
5)客戶(hù)端代碼編寫(xiě)完成,此時(shí)請(qǐng)首先運(yùn)行服務(wù)端的MyWCF.Hosting項(xiàng)目,將服務(wù)端啟動(dòng)。
6)回到客戶(hù)端的MyWCF.Client項(xiàng)目,按Ctrl + F5執(zhí)行程序。
由此可見(jiàn),WCF客戶(hù)端由兩部分組成,一是用于同服務(wù)端確認(rèn)通訊的代理層MyWCF.ClientBase,二是客戶(hù)端的業(yè)務(wù)邏輯層MyWCF.Client。實(shí)際上,只要服務(wù)端確定后,我們就可以使用工具輕松的生成客戶(hù)端架構(gòu)。當(dāng)然,這只是WCF的一個(gè)最為簡(jiǎn)單的示例,目的是使大家對(duì)WCF的各個(gè)部件有一個(gè)大致的了解,對(duì)架構(gòu)有一個(gè)簡(jiǎn)單認(rèn)識(shí)。