WCF的宿主可以是 Windows 服務、COM+應用程式、WAS(Windows Activation Services,Windows進程激活服務)或IIS、Windows應用程式,或簡單的控制台應用程式及任何.net程式。 ...
一、WCF服務應用程式與WCF服務庫
我們在平時開發的過程中常用的項目類型有“WCF 服務應用程式”和“WCF服務庫”。
WCF服務應用程式,是一個可以執行的程式,它有獨立的進程,WCF服務類協定的定義,可以直接看到運行的效果。
WCF服務庫,可以認為是一個包含WCF服務以及協定定義的類庫。不能直接運行,你可以在其他項目里引用,在宿主里啟用托管這個庫,有點類似於我們在Web/windows項目中應用的類庫。考慮WCF服務設計的時候,服務類的定義為單獨的庫,可以為其它項目使用。提高代碼的復用性。
當然你也可以修改這些代碼,比如把WCF服務程式里的類,移到一個單獨的類庫里,或是把類庫里的類移到WCF服務程式中。
二、寄宿概述
通過前面的介紹我們知道,WCF在運行時必寄宿在“宿主程式”之上,WCF本身不能夠獨自運行(每個WCF服務必須宿主在一個Windows進程中)。.net 提供了多種宿主供WCF運行,WCF還是非常靈活的。
WCF的宿主可以是 Windows 服務、COM+應用程式、WAS(Windows Activation Services,Windows進程激活服務)或IIS、Windows應用程式,或簡單的控制台應用程式及任何.net程式。
三、創建WCF服務庫為多種寄宿做準備
1) 打開Visual Studio 2015,在菜單上點擊文件—>新建—>項目—>WCF服務應用程式。在彈出界面的“名稱”對應的文本框中輸入“WcfServiceLib”,然後點擊“確定”按鈕。如下圖。
2) 把Visual Studio 2015自動生成的兩個文件(IService1.cs、Service1.cs)刪除。
3) 滑鼠右鍵查看項目屬性。如下圖所示。
4) 查看WcfServiceLib項目的引用,我們會發現“WCF類庫項目”與我們平時建立的 “類庫項目”都是類庫,只不過多了WCF的類庫項目在新建時多了兩個dll的引用(System.ServiceModel.dll、 System.Runtime.Serialization.dll)和一個自動生成的配置文件(該配置文件只用於調試時使用,在WCF寄宿以後會應用宿 主的配置文件與其他應用程式通信)。如下圖。
5) 服務端我們還和第一個教程一樣(IBookService介面與BookSservice實現),創建IBookService介面。代碼如下。
using System; using System.Collections.Generic; using System.Linq; using System.Runtime.Serialization; using System.ServiceModel; using System.Text; namespace WcfServiceLib { // 註意: 使用“重構”菜單上的“重命名”命令,可以同時更改代碼和配置文件中的介面名“IBookService”。 [ServiceContract] public interface IBookService { [OperationContract] string GetBook(string Id); } }
6) 實現IBookService介面,代碼如下。
using System; using System.Collections.Generic; using System.Linq; using System.Runtime.Serialization; using System.ServiceModel; using System.Text; namespace WcfServiceLib { // 註意: 使用“重構”菜單上的“重命名”命令,可以同時更改代碼、svc 和配置文件中的類名“BookService”。 // 註意: 為了啟動 WCF 測試客戶端以測試此服務,請在解決方案資源管理器中選擇 BookService.svc 或 BookService.svc.cs,然後開始調試。 public class BookService : IBookService { public string GetBook(string Id) { int bookId = Convert.ToInt32(Id); Books book = SetBook(bookId); string xml = XMLHelper.ToXML<Books>(book); return xml; } public Books SetBook(int Id) { Books book = new Books(); book.BookID = Id; book.AuthorID = 1; book.Category = "IBM"; book.Price = 39.99M; book.Numberofcopies = 25; book.Name = "DB2資料庫性能調整和優"; book.PublishDate = new DateTime(2015, 2, 23); return book; } } }
7) 由於Visual Studio 2015預設生成的app.config中的配置信息是以IService來寫的配置,現在的為IBookService,所以配置文件有三處要修改.修改。如下圖。
修改後的配置文件。
<?xml version="1.0" encoding="utf-8" ?> <configuration> <appSettings> <add key="aspnet:UseTaskFriendlySynchronizationContext" value="true" /> </appSettings> <system.web> <compilation debug="true" /> </system.web> <!-- 部署服務庫項目時,必須將配置文件的內容添加到 主機的 app.config 文件中。System.Configuration 不支持庫的配置文件。 --> <system.serviceModel> <services> <service name="WcfServiceLib.BookService"> <host> <baseAddresses> <add baseAddress = "http://127.0.0.1:8888/WcfServiceLib/BookService/" /> </baseAddresses> </host> <!-- Service Endpoints --> <!-- 除非完全限定,否則地址相對於上面提供的基址--> <endpoint address="" binding="basicHttpBinding" contract="WcfServiceLib.IBookService"> <!-- 部署時,應刪除或替換下列標識元素,以反映 用來運行所部署服務的標識。刪除之後,WCF 將 自動推斷相應標識。 --> <identity> <dns value="localhost"/> </identity> </endpoint> <!-- Metadata Endpoints --> <!-- 元數據交換終結點供相應的服務用於向客戶端做自我介紹。 --> <!-- 此終結點不使用安全綁定,應在部署前確保其安全或將其刪除--> <endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange"/> </service> </services> <behaviors> <serviceBehaviors> <behavior> <!-- 為避免泄漏元數據信息, 請在部署前將以下值設置為 false --> <serviceMetadata httpGetEnabled="True" httpsGetEnabled="True"/> <!-- 要接收故障異常詳細信息以進行調試, 請將以下值設置為 true。在部署前設置為 false 以避免泄漏異常信息 --> <serviceDebug includeExceptionDetailInFaults="False" /> </behavior> </serviceBehaviors> </behaviors> </system.serviceModel> </configuration>
8) 在Visual Studio 2015中點擊“F5“運行程式。效果如下圖所示,則說明成功。
9) 使用滑鼠左鍵,雙擊GetBook方法,在ID值中輸入5,如下圖。
10) 在輸入完ID值之後,點擊,調用按鈕,如下圖。在出現的提示信息框中點擊“確定”按鈕。
11) 調用成功的結果。如下圖。