簡單實(shí)現(xiàn)WCF基礎(chǔ)開發(fā)
WCF是微軟的一個(gè)通信編程框架。很多人可能對于這樣的一款新框架了解的還不是很全面。開發(fā)人員可以通過這款框架實(shí)現(xiàn)跨平臺可靠的互聯(lián)網(wǎng)解決方案。#t#
在這里我就用一個(gè)據(jù)于一個(gè)簡單的場景:服務(wù)端為客服端提供獲取客戶信息的一個(gè)接口讀取客戶信息,來完成WCF基礎(chǔ)開發(fā)的六個(gè)步驟。
WCF基礎(chǔ)開發(fā)1. 定義WCF服務(wù)契約
A. 項(xiàng)目引用節(jié)點(diǎn)右鍵添加System.ServiceModel引用。
B. 在代碼文件里,添加以下命名空間的引用
using System.ServiceModel;
using System;
C. 新建一個(gè)命為ICustomerService 接口,并添加一個(gè)獲取客戶信息的方法定義名為CustomerInfomation,返回字符串類型的客戶信息。
D. 為接口ICustomerService添加ServiceContract的屬性修飾使它成為WCF服務(wù)中公開的接口。
E. 為方法CustomerInfomation添加OperationContract的屬性修飾使它成為WCF服務(wù)公開接口中公開的成員。
F. 代碼:
- using System;
- using System.ServiceModel;
- namespace ConWCF
- { [ServiceContract(Namespace =
"http://Microsoft.Service
Model.Samples")]- public interface CustomerService
- {
- [OperationContract]
- String CustomerInformation();
- }
- }
WCF基礎(chǔ)開發(fā)2. 實(shí)現(xiàn)WCF服務(wù)契約
實(shí)現(xiàn)WCF服務(wù)契約很簡單,就是實(shí)現(xiàn)上一步聚定義的WCF服務(wù)契約定義的接口就可以。下面看代碼
- using System;
- using System.ServiceModel;
- namespace ConWCF
- { [ServiceContract(Namespace =
"http://Microsoft.ServiceModel.Samples")]- public interface ICustomerService
- {
- [OperationContract]
- String CustomerInformation();
- }
- public class CustomerService:
ICustomerService- {
- #region ICustomerService 成員
- public string CustomerInformation()
- {
- return "這是客戶的信息!";
- }
- #endregion
- }
- }
WCF基礎(chǔ)開發(fā)3. 啟動WCF服務(wù)
A.添加一個(gè)應(yīng)用程序配置文件,文件件名為App.config。
B.配置WCF服務(wù)的基本地址,如下所示
- < host>
- < baseAddresses>
- < addbaseAddressaddbaseAddress=
"http://localhost:8000/conwcfr"/>- < /baseAddresses>
- < /host>
C.配置WCF服務(wù)的端口。Address=“”,意思就是使用上面配置的基本地址,當(dāng)然也可以在這里指定。Bingding=“wsHttpBinding”,意思是WCF服務(wù)使用的是HTTP協(xié)議。再接下來就是配置WCF服務(wù)契約了(命名空間.服務(wù)契約接口名),如下所示:
- < endpointaddressendpointaddress=""
- binding="wsHttpBinding"
- contract="ConWCF.ICustomerService" />
D.配置文件
E.啟動服服就簡單了
- ServiceHost host = new
ServiceHost(typeof(CustomerService));- host.Open();
- Console.WriteLine("客戶信息服務(wù)已啟動");
- Console.WriteLine("按任意鍵結(jié)束服務(wù)!");
- Console.Read();
- host.Close();
F.當(dāng)服務(wù)啟動時(shí),在IE欄中輸入: http://localhost:8000/conwcfr,將會收到一些幫助的提示信息。
G.異常:配置文件中的服務(wù)名稱一定是:命名空間.實(shí)現(xiàn)WCF服務(wù)契約類的名稱,否則將會發(fā)生找到不配置的異常。
- < service name=
"ConWCF.CustomerService"
異常信息: Service 'ConWCF.CustomerService' has zero application (non-infrastructure) endpoints. This might be because no configuration file was found for your application, or because no service element matching the service name could be found in the configuration file, or because no endpoints were defined in the service element.
這個(gè)異常搞得我昏了半天,害得我以為從IIS、端口到配置環(huán)境排除錯(cuò)誤,就是搞不明白為什么會跟類的命稱聯(lián)系起來。不過,最終也解決了。
WCF基礎(chǔ)開發(fā)4. 創(chuàng)建一個(gè)基本的WCF客服端
WCF服務(wù)端創(chuàng)建好啊,創(chuàng)建客戶端就容易多了,直接用SVCUTIL 命令行工具去完成代碼的生成。我安裝了WINDOWS SDK,其帶了一個(gè)CMDShell 命令行工具,打開后就可以運(yùn)行SVCUTIL命令,這個(gè)命令是運(yùn)行于 framework 3.0以上環(huán)境。查看詳細(xì)幫助信息可以輸入:svcutil /?,回車。
1. 啟動上幾步驟創(chuàng)建好的WCF服務(wù)端。
2. 在CMDShell工具中用CD 轉(zhuǎn)到你要存放客戶端代碼的目錄下,輸入以下命令生成代碼和配置文件。
D:"client>svcutil /language:c# /out:CustomerClient.cs /config:app.config http:/
/localhost:8000/conwcfr
上面命令指定了要生成代碼的語言,代碼文件和配置文件名,WCF服務(wù)端地址,注意運(yùn)行命令時(shí)必須確定WCF服務(wù)端正在運(yùn)行中。
WCF基礎(chǔ)開發(fā)5. WCF客服端基本配置
WCF客戶端配置就是配置調(diào)用WCF服務(wù)端的協(xié)議,輸傳寬帶,服務(wù)地址,安全等等信息。下面就上一步驟命令自動生成的配置文件。
- < ?xml version="1.0" encoding="utf-8"?>
- < configuration>
- < system.serviceModel>
- < bindings>
- < wsHttpBinding>
- < binding name="WSHttpBinding_
ICustomerService" closeTimeout="00:01:00"- openTimeout="00:01:00" receiveTimeout=
"00:10:00" sendTimeout="00:01:00"- bypassProxyOnLocal="false"
transactionFlow="false" hostName
ComparisonMode="StrongWildcard"- maxBufferPoolSize="524288" maxRece
ivedMessageSize="65536"- messageEncoding="Text" textEncoding
="utf-8" useDefaultWebProxy="true"- allowCookies="false">
- < readerQuotas maxDepth="32" maxStr
ingContentLength="8192"
maxArrayLength="16384"- maxBytesPerRead="4096" maxNameTab
leCharCount="16384" />- < reliableSession ordered="true"
inactivityTimeout="00:10:00"- enabled="false" />
- < security mode="Message">
- < transport clientCredentialType=
"Windows" proxyCredentialType="None"- realm="" />
- < message clientCredentialType=
"Windows" negotiateServiceCredential="true"- algorithmSuite="Default"
establishSecurityContext="true" />- < /security>
- < /binding>
- < /wsHttpBinding>
- < /bindings>
- < client>
- < endpoint address="http:
//localhost:8000/conwcfr"
binding="wsHttpBinding"- bindingConfiguration="WSHttpBinding
_ICustomerService" contract="ICustomerService"- name="WSHttpBinding_ICustomerService">
- < identity>
- < userPrincipalName value=
"30DA1D0B1D1E4D2\Administrator" />- < /identity>
- < /endpoint>
- < /client>
- < /system.serviceModel>
- < /configuration>
WCF基礎(chǔ)開發(fā)6. 使用WCF客戶端
在客戶端項(xiàng)目中項(xiàng)目引用節(jié)點(diǎn)右鍵添加System.ServiceModel引用.
添加第四部中創(chuàng)建的客戶端代碼文件和配置文件。
客戶端調(diào)用服務(wù)端的服務(wù),只要創(chuàng)建生成客戶端類的實(shí)例就可調(diào)用了,但要確認(rèn)服務(wù)端正在起用狀態(tài),如下
- using System;
- namespace ConWCFCustomerClient
- {
- class Program
- {
- static void Main(string[] args)
- {
- CustomerServiceClient client =
new CustomerServiceClient();- string message=client.
CustomerInformation();- Console.WriteLine(message);
- Console.Read();
- }
- }
- }