WCF是DotNet體系中很重要的一項技術(shù),但是組內(nèi)很多組員通過書籍自學(xué)的時候感覺涉及面太廣、配置文件太復(fù)雜,新名詞太多、抓不到頭緒,有感于此,決定進行一次組內(nèi)技術(shù)培訓(xùn),順便把培訓(xùn)講義整理到blog上來。不求大而全,而是要讓初學(xué)者快速入門,因此想入實例入手,并刻意隱藏一些初期用不到的內(nèi)容,以降低入門門檻。有任何錯誤歡迎指正。
注:本系列文章基于.Net Framework 3.5,以教程的最后會歸納一下到了4.0中有哪些差異。
----------------------- 分隔線 -----------------------
第一篇:入門,構(gòu)建第一個WCF程序
1、服務(wù)端
建立一個控制臺應(yīng)用程序作為Server,新建一個接口IData作為服務(wù)契約。這個契約接口一會兒也要放到Client端,這樣雙方才能遵循相同的標(biāo)準(zhǔn)。別忘了添加對System.ServiceModel的引用。
using System;
using System.ServiceModel;
using System.Text;
namespace Server
{
///
/// 用ServiceContract來標(biāo)記此接口是WCF的服務(wù)契約,可以像WebService一樣指定一個Namespace,如果不指定,就是默認的http://tempuri.org
///
[ServiceContract(Namespace="WCF.Demo")]
public interface IData
{
///
/// 用OperationContract來標(biāo)記此方法是操作契約
///
[OperationContract]
string SayHello(string userName);
}
}
針對這個接口建立實現(xiàn)類,這個類才是真正干活的,工作在服務(wù)端,不出現(xiàn)在客戶端:
using System;
using System.Text;
namespace Server
{
///
/// 實現(xiàn)IData接口,此處不需要寫契約標(biāo)記
///
public class DataProvider : IData
{
public string SayHello(string userName)
{
return string.Format("Hello {0}.", userName);
}
}
}
為工程添加一個App.config文件,這里面要定義與服務(wù)發(fā)布相關(guān)的參數(shù)。WCF中常見的做法是用代碼寫服務(wù)邏輯,但是用配置文件來定義服務(wù)發(fā)布方式,這樣做的好處是松散耦合。
萬事具備,只剩最后一步了,將服務(wù)發(fā)布出去:
using System;
using System.ServiceModel;
namespace Server
{
class Program
{
static void Main(string[] args)
{
//定義一個ServiceHost,注意參數(shù)中要使用契約實現(xiàn)類而不是接口
using(ServiceHost host = new ServiceHost(typeof(Server.DataProvider)))
{
host.Open();
Console.WriteLine("Service Running ...");
Console.ReadKey();
host.Close();
}
}
}
}
有人可能會問服務(wù)發(fā)布到哪去了?沒指定地址呀?這是一個初學(xué)者容易搞不明白的地方。
是的,此時App.config中的定義就發(fā)揮作用了,由于ServiceHost中指定對Server.DataProvider類服務(wù),而App.config中定義了name="Server.DataProvider"的service,其下有endpoint,定義了綁定方式是basicHttpBinding,而http方式的baseAddress只有一個,就是 http://localhost:8080/wcf。
編譯運行,屏幕顯示Service Running ... 就是正常跑起來了,此時如果用命令行 netstat -ano | findstr "8080" 看一下,應(yīng)該有如下輸出:
TCP 0.0.0.0:8080 0.0.0.0:0 LISTENING 4
TCP [::]:8080 [::]:0 LISTENING 4
表示我們的程序已經(jīng)在TCP 8080端口開始監(jiān)聽了。值得注意的是PID是4,這是系統(tǒng)進程而不是我們自己的進程,這說明WCF程序?qū)ν馓峁〩TTP服務(wù)時,是借用了系統(tǒng)功能(http.sys)。
此時如果我們用瀏覽器訪問一下 http://localhost:8080/wcf,不報錯,但是會提示“當(dāng)前已禁用此服務(wù)的元數(shù)據(jù)發(fā)布”,這是由于默認不允許以http get方式獲取服務(wù)的WSDL,我們不用管它,不影響后面的使用,以后的章節(jié)中我們再來看這個問題。
2、客戶端
再建立一個控制臺應(yīng)用程序作為Client,把Server中的接口IData拷過來,因為這是服務(wù)契約。
為工程添加一個App.config文件,這里面要定義客戶端訪問的相關(guān)參數(shù),這里我去掉了一些用不上的參數(shù),以保持配置文件簡單,防止各位看暈了頭。
然后寫代碼,來調(diào)用Server端發(fā)布的SayHello方法:
using System;
using System.ServiceModel;
using System.ServiceModel.Channels;
namespace Client
{
class Program
{
static void Main(string[] args)
{
//客戶端訪問有多種方式,此處只顯示一種
//利用ChannelFactory的CreateChannel方法創(chuàng)建一個IData的代理對象,其中參數(shù)“DataService”就是剛才在App.config中定義的endpoint的名稱
var proxy = new ChannelFactory
("DataService").CreateChannel(); //調(diào)用SayHello方法
Console.WriteLine(proxy.SayHello("WCF"));
//用完后一定要關(guān)閉,因為服務(wù)端有大連接數(shù),不關(guān)閉會在一定時間內(nèi)一直占著有效連接
((IChannel)proxy).Close();
}
}
}
編譯運行,屏幕應(yīng)能正常打印出“Hello WCF.”。第一個入門demo就搞定了,應(yīng)該還是比較簡單的。只是App.config的配置有些復(fù)雜,后面我們會看到,其實也可以不要配置,直接用代碼搞定,不過從松散耦合的角度講不建議這么做。
另外有需要云服務(wù)器可以了解下創(chuàng)新互聯(lián)scvps.cn,海內(nèi)外云服務(wù)器15元起步,三天無理由+7*72小時售后在線,公司持有idc許可證,提供“云服務(wù)器、裸金屬服務(wù)器、高防服務(wù)器、香港服務(wù)器、美國服務(wù)器、虛擬主機、免備案服務(wù)器”等云主機租用服務(wù)以及企業(yè)上云的綜合解決方案,具有“安全穩(wěn)定、簡單易用、服務(wù)可用性高、性價比高”等特點與優(yōu)勢,專為企業(yè)上云打造定制,能夠滿足用戶豐富、多元化的應(yīng)用場景需求。