WCF學習之旅—WCF寄宿前的准備（八）

一、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) 調用成功的結果。如下圖。