WCF开发的几个频骤
在這里我就用一個據(jù)于一個簡單的場景:服務(wù)端為客服端提供獲取客戶信息的一個接口讀取客戶信息,來完成WCF開發(fā)入門的六個步驟。
1.?????? 定義WCF服務(wù)契約
A.????? 項目引用節(jié)點右鍵添加System.ServiceModel引用。
B.????? 在代碼文件里,添加以下命名空間的引用
using System.ServiceModel;
using System;
C.????? 新建一個命為ICustomerService 接口,并添加一個獲取客戶信息的方法定義名為CustomerInfomation,返回字符串類型的客戶信息。
D.???? 為接口ICustomerService添加ServiceContract的屬性修飾使它成為WCF服務(wù)中公開的接口。
E.????? 為方法CustomerInfomation添加OperationContract的屬性修飾使它成為WCF服務(wù)公開接口中公開的成員。
F.????? 代碼:
?1 using System;
?2
?3 using System.ServiceModel;
?4
?5 namespace ConWCF
?6
?7 {?? [ServiceContract(Namespace = "http://microsoft.servicemodel.samples/")]
?8
?9???? public interface ICustomerService
10
11???? {
12
13???????? [OperationContract]
14
15???????? String CustomerInformation();
16
17???? }
18
19 }
20
2.?????? 實現(xiàn)WCF服務(wù)契約
實現(xiàn)WCF服務(wù)契約很簡單,就是實現(xiàn)上一步聚定義的WCF服務(wù)契約定義的接口就可以。下面看代碼
?1 using System;
?2
?3 using System.ServiceModel;
?4
?5 namespace ConWCF
?6
?7 {?? [ServiceContract(Namespace = "http://microsoft.servicemodel.samples/")]
?8
?9???? public interface ICustomerService
10
11???? {
12
13???????? [OperationContract]
14
15???????? String CustomerInformation();
16
17???? }
18
19???? public class CustomerService:ICustomerService
20
21???? {
22
23???????? #region ICustomerService 成員
24
25???????? public string CustomerInformation()
26
27???????? {
28
29???????????? return "這是客戶的信息!";
30
31???????? }
32
33???????? #endregion
34
35???? }
36
37 }
38
39
3.?????? 啟動WCF服務(wù)
A.添加一個應(yīng)用程序配置文件,文件件名為App.config。
B.配置WCF服務(wù)的基本地址,如下所示
<host>
?????????????????????? <baseAddresses>
??????????????????????????? <addbaseAddress="http://localhost:8000/conwcfr%22/>
?????????????????????? </baseAddresses>
?????????????????? </host>
C.配置WCF服務(wù)的端口。Address=“”,意思就是使用上面配置的基本地址,當(dāng)然也可以在這里指定。Bingding=“wsHttpBinding”,意思是WCF服務(wù)使用的是HTTP協(xié)議。再接下來就是配置WCF服務(wù)契約了(命名空間.服務(wù)契約接口名),?contract中的值就是上面定義的接口,如下所示:
<endpoint? address=""
???????????????????????????? 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ù)啟動時,在IE欄中輸入: http://localhost:8000/conwcfr,將會收到一些幫助的提示信息。
G.異常:配置文件中的服務(wù)名稱一定是:命名空間.實現(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.
這個異常搞得我昏了半天,害得我以為從IIS、端口到配置環(huán)境排除錯誤,就是搞不明白為什么會跟類的命稱聯(lián)系起來。不過,最終也解決了。
4.?????? 創(chuàng)建一個基本的WCF客服端
WCF服務(wù)端創(chuàng)建好啊,創(chuàng)建客戶端就容易多了,直接用SVCUTIL 命令行工具去完成代碼的生成。我安裝了WINDOWS SDK,其帶了一個CMDShell 命令行工具,打開后就可以運行SVCUTIL命令,這個命令是運行于 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ù)端地址,注意運行命令時必須確定WCF服務(wù)端正在運行中。
5.?????? WCF客服端基本配置
WCF客戶端配置就是配置調(diào)用WCF服務(wù)端的協(xié)議,輸傳寬帶,服務(wù)地址,安全等等信息。下面就上一步驟命令自動生成的配置文件。
?1 <?xml version="1.0" encoding="utf-8"?>
?2 <configuration>
?3???? <system.serviceModel>
?4???????? <bindings>
?5???????????? <wsHttpBinding>
?6???????????????? <binding name="WSHttpBinding_ICustomerService" closeTimeout="00:01:00"
?7???????????????????? openTimeout="00:01:00" receiveTimeout="00:10:00" sendTimeout="00:01:00"
?8???????????????????? bypassProxyOnLocal="false" transactionFlow="false" hostNameComparisonMode="StrongWildcard"
?9???????????????????? maxBufferPoolSize="524288" maxReceivedMessageSize="65536"
10???????????????????? messageEncoding="Text" textEncoding="utf-8" useDefaultWebProxy="true"
11???????????????????? allowCookies="false">
12???????????????????? <readerQuotas maxDepth="32" maxStringContentLength="8192" maxArrayLength="16384"
13???????????????????????? maxBytesPerRead="4096" maxNameTableCharCount="16384" />
14???????????????????? <reliableSession ordered="true" inactivityTimeout="00:10:00"
15???????????????????????? enabled="false" />
16???????????????????? <security mode="Message">
17???????????????????????? <transport clientCredentialType="Windows" proxyCredentialType="None"
18???????????????????????????? realm="" />
19???????????????????????? <message clientCredentialType="Windows" negotiateServiceCredential="true"
20???????????????????????????? algorithmSuite="Default" establishSecurityContext="true" />
21???????????????????? </security>
22???????????????? </binding>
23???????????? </wsHttpBinding>
24???????? </bindings>
25???????? <client>
26???????????? <endpoint address="http://localhost:8000/conwcfr" binding="wsHttpBinding"
27???????????????? bindingConfiguration="WSHttpBinding_ICustomerService" contract="ICustomerService"
28???????????????? name="WSHttpBinding_ICustomerService">
29???????????????? <identity>
30???????????????????? <userPrincipalName value="30DA1D0B1D1E4D2\Administrator" />
31???????????????? </identity>
32???????????? </endpoint>
33???????? </client>
34???? </system.serviceModel>
35 </configuration>
6.?????? 使用WCF客戶端
在客戶端項目中項目引用節(jié)點右鍵添加System.ServiceModel引用.
添加第四部中創(chuàng)建的客戶端代碼文件和配置文件。
客戶端調(diào)用服務(wù)端的服務(wù),只要創(chuàng)建生成客戶端類的實例就可調(diào)用了,但要確認(rèn)服務(wù)端正在起用狀態(tài),如下
?1using System;
?2
?3namespace ConWCFCustomerClient
?4
?5{
?6
?7??? class Program
?8
?9??? {
10
11??????? static void Main(string[] args)
12
13??????? {
14
15??????????? CustomerServiceClient client = new CustomerServiceClient();
16
17??????????? string message=client.CustomerInformation();
18
19??????????? Console.WriteLine(message);
20
21??????????? Console.Read();
22
23??????? }
24
25??? }
26
27}
28
總結(jié)
以上是生活随笔為你收集整理的WCF开发的几个频骤的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 烟花的由来和寓意(烟花的由来)
- 下一篇: WCF系列(二) -- 使用配置文件构建