WCF入門教程

   這一系列文章的內(nèi)容是從MSDN中COPY過來的，講述的是最簡單的WCF程序示例：如何在控制臺應(yīng)用程序?qū)崿F(xiàn)和承載WCF服務(wù)，以及如何創(chuàng)建、配置和使用WCF客戶端。

   文章主體可分為兩部分，分別介紹服務(wù)器端和客戶端的編程實現(xiàn)。細分的話，可以分為六項任務(wù)。

專注于為中小企業(yè)提供成都網(wǎng)站設(shè)計、網(wǎng)站制作服務(wù),電腦端+手機端+微信端的三站合一,更高效的管理,為中小企業(yè)巴彥淖爾免費做網(wǎng)站提供優(yōu)質(zhì)的服務(wù)。我們立足成都，凝聚了一批互聯(lián)網(wǎng)行業(yè)人才，有力地推動了上千余家企業(yè)的穩(wěn)健成長，幫助中小企業(yè)通過網(wǎng)站建設(shè)實現(xiàn)規(guī)模擴充和轉(zhuǎn)變。

· 服務(wù)器端

定義WCF服務(wù)協(xié)定（任務(wù)一）

  這是創(chuàng)建基本 Windows Communication Foundation (WCF) 服務(wù)和可以使用該服務(wù)的客戶端所需的六項任務(wù)中的第一項任務(wù)。

   創(chuàng)建基本 WCF 服務(wù)時，第一項任務(wù)是為與外界共享的服務(wù)創(chuàng)建協(xié)定，并在其中描述如何與該服務(wù)進行通信。

   具體步驟為：

   1、 創(chuàng)建新的控制臺應(yīng)用程序項目。 在“新建項目”對話框中，選中“Visual Basic”或“Visual C#”，并選擇“控制臺應(yīng)用程序”模板，并命名為Service。 使用默認的位置。

   2、將默認的Service 命名空間更改為 Microsoft.ServiceModel.Samples。

   3、為項目提供對 System.ServiceModel 命名空間的引用：右擊“解決方案資源管理器”中的“Service”項目，選擇“添加引用”項，在彈出的對話框中的“.NET”選項卡里的“組件名稱”中選擇“System.ServiceModel”，然后單擊“確定”。

   下面是編程步驟：

   1、為 System.ServiceModel 命名空間添加一個 using 語句。

      using System.ServiceModel;

   2、創(chuàng)建一個新的ICalculator 接口，并將 ServiceContractAttribute 屬性應(yīng)用于該接口，并將 Namespace 值設(shè)置為“http://Microsoft.ServiceModel.Samples”。 此命名空間指定該服務(wù)在計算機上的路徑，并構(gòu)成該服務(wù)的基址部分。 請注意，在通過采用方括號表示法的屬性來批注接口或類時，該屬性類可以從其名稱中去掉“Attribute”部分。

    [ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]

    public interface ICalculator

   3、在接口中創(chuàng)建方法聲明，并將 OperationContractAttribute 屬性應(yīng)用于每個要作為公共 WCF 協(xié)定的一部分公開的方法。

   [OperationContract]

   double Add(double n1, double n2);

   [OperationContract]

   double Subtract(double n1, double n2);

   [OperationContract]

   double Multiply(double n1, double n2);

   [OperationContract]

   double Divide(double n1, double n2);

   下面是創(chuàng)建服務(wù)協(xié)定的完整代碼段：

using System;

// Add the using statement for the Sytem.ServiceModel namespace

using System.ServiceModel;

namespace Microsoft.ServiceModel.Samples

{

  //  Define a service contract.

  [ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]

  public interface ICalculator

  {

    //  Create the method declaration for the contract.

    [OperationContract]

    double Add(double n1, double n2);

    [OperationContract]

    double Subtract(double n1, double n2);

    [OperationContract]

    double Multiply(double n1, double n2);

    [OperationContract]

    double Divide(double n1, double n2);

  }

}

........（整個服務(wù)器端的代碼未完，等講完任務(wù)三時，再給出完整代碼）

實現(xiàn)WCF服務(wù)協(xié)定（任務(wù)二）

   1、創(chuàng)建一個新 CalculatorService 類，該類從用戶定義的 ICalculator 接口繼承而來并實現(xiàn)該接口定義的協(xié)定功能。

   public class CalculatorService : ICalculator

   2、實現(xiàn)每個算術(shù)運算符的功能。

public double Add(double n1, double n2)

{

    double result = n1 + n2;

    Console.WriteLine("Received Add({0},{1})", n1, n2);

    // Code added to write output to the console window.

    Console.WriteLine("Return: {0}", result);

    return result;

}

public double Subtract(double n1, double n2)

{

    double result = n1 - n2;

    Console.WriteLine("Received Subtract({0},{1})", n1, n2);

    Console.WriteLine("Return: {0}", result);

    return result;

}

public double Multiply(double n1, double n2)

{

    double result = n1 * n2;

    Console.WriteLine("Received Multiply({0},{1})", n1, n2);

    Console.WriteLine("Return: {0}", result);

    return result;

}

public double Divide(double n1, double n2)

{

    double result = n1 / n2;

    Console.WriteLine("Received Divide({0},{1})", n1, n2);

    Console.WriteLine("Return: {0}", result);

    return result;

}

   在創(chuàng)建和實現(xiàn)了服務(wù)協(xié)定后，下一步是運行該服務(wù)。 運行服務(wù)由三個步驟組成：配置、承載和打開服務(wù)。

配置、承載和運行服務(wù)（任務(wù)三）

• 為服務(wù)配置基址

    為服務(wù)的基址創(chuàng)建 Uri 實例。 此 URI 指定 HTTP 方案、本地計算機、端口號 8000，以及服務(wù)協(xié)定中為服務(wù)命名空間指定的服務(wù)路徑ServiceModelSample/Services。

    Uri baseAddress = new Uri("http://localhost:8000/ServiceModelSamples/Service");

• 承載服務(wù)

1. 創(chuàng)建一個新的 ServiceHost 實例以承載服務(wù)。 必須指定實現(xiàn)服務(wù)協(xié)定和基址的類型。 對于此示例，我們將基址指定為http://localhost:8000/ServiceModelSamples/Services，并將 CalculatorService 指定為實現(xiàn)服務(wù)協(xié)定的類型。

ServiceHost selfHost = new ServiceHost(typeof(CalculatorService), baseAddress);

2. 添加一個捕獲 CommunicationException 的 try-catch 語句，并在接下來的三個步驟中將該代碼添加到 try 塊中。

3. 添加公開服務(wù)的終結(jié)點。 為此，必須指定終結(jié)點公開的協(xié)議、綁定和終結(jié)點的地址。 此例中，將 ICalculator 指定為協(xié)定，將 WSHttpBinding 指定為綁定，并將 CalculatorService 指定為地址。 在這里請注意，我們指定的是相對地址。 終結(jié)點的完整地址是基址和終結(jié)點地址的組合。 在此例中，完整地址是 http://localhost:8000/ServiceModelSamples/Services/CalculatorService。

selfHost.AddServiceEndpoint(     typeof(ICalculator),     new WSHttpBinding(),     "CalculatorService");

4. 啟用元數(shù)據(jù)交換。 為此，必須添加服務(wù)元數(shù)據(jù)行為。 首先創(chuàng)建一個 ServiceMetadataBehavior 實例，將 HttpGetEnabled 屬性設(shè)置為 true，然后為服務(wù)添加新行為。

ServiceMetadataBehavior smb = new ServiceMetadataBehavior(); smb.HttpGetEnabled = true; selfHost.Description.Behaviors.Add(smb);

5. 打開 ServiceHost 并等待傳入消息。 用戶按 Enter 鍵時，關(guān)閉 ServiceHost。

    selfHost.Open();

    Console.WriteLine("The service is ready.");

    Console.WriteLine("Press  to terminate service.");

    Console.WriteLine();

    Console.ReadLine();

    // Close the ServiceHostBase to shutdown the service.

    selfHost.Close();

    下面是服務(wù)器端（即“Service”項目中program.cs文件中）的完整程序代碼：

using System;

using System.ServiceModel;

using System.ServiceModel.Description;

namespace Microsoft.ServiceModel.Samples

{

    // Define a service contract.

    [ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]

    public interface ICalculator

    {

        [OperationContract]

        double Add(double n1, double n2);

        [OperationContract]

        double Subtract(double n1, double n2);

        [OperationContract]

        double Multiply(double n1, double n2);

        [OperationContract]

        double Divide(double n1, double n2);

    }

    // Service class that implements the service contract.

    // Added code to write output to the console window.

    public class CalculatorService : ICalculator

    {

        public double Add(double n1, double n2)

        {

            double result = n1 + n2;

            Console.WriteLine("Received Add({0},{1})", n1, n2);

            Console.WriteLine("Return: {0}", result);

            return result;

        }

        public double Subtract(double n1, double n2)

        {

            double result = n1 - n2;

            Console.WriteLine("Received Subtract({0},{1})", n1, n2);

            Console.WriteLine("Return: {0}", result);

            return result;

        }

        public double Multiply(double n1, double n2)

        {

            double result = n1 * n2;

            Console.WriteLine("Received Multiply({0},{1})", n1, n2);

            Console.WriteLine("Return: {0}", result);

            return result;

        }

        public double Divide(double n1, double n2)

        {

            double result = n1 / n2;

            Console.WriteLine("Received Divide({0},{1})", n1, n2);

            Console.WriteLine("Return: {0}", result);

            return result;

        }

    }

    class Program

    {

        static void Main(string[] args)

        {

            // Create a URI to serve as the base address.

            Uri baseAddress = new Uri("http://localhost:8000/ServiceModelSamples/Service");

            // Create ServiceHost

            ServiceHost selfHost = new ServiceHost(typeof(CalculatorService), baseAddress);

            try

            {

                 //  Add a service endpoint.

                selfHost.AddServiceEndpoint(

                    typeof(ICalculator),

                    new WSHttpBinding(),

                    "CalculatorService");

                // Enable metadata exchange.

                ServiceMetadataBehavior smb = new ServiceMetadataBehavior();

                smb.HttpGetEnabled = true;

                selfHost.Description.Behaviors.Add(smb);

                // Start (and then stop) the service.

                selfHost.Open();

                Console.WriteLine("The service is ready.");

                Console.WriteLine("Press  to terminate service.");

                Console.WriteLine();

                Console.ReadLine();

                // Close the ServiceHostBase to shutdown the service.

                selfHost.Close();

            }

            catch (CommunicationException ce)

            {

                Console.WriteLine("An exception occurred: {0}", ce.Message);

                selfHost.Abort();

            }

        }

    }

}

若要運行服務(wù)，啟動項目文件夾下bin目錄中的 Service.exe即可。

 前面三篇文章是講服務(wù)器端的部署和運行，下面講講客戶端如何配置和使用。

創(chuàng)建WCF客戶端（任務(wù)四）

1. 通過執(zhí)行以下步驟，在 Visual Studio 2005 中為客戶端創(chuàng)建新項目：

1. 在包含該服務(wù)（之前文章所述的服務(wù)）的同一解決方案中的“解決方案資源管理器”（位于右上角）中，右擊當前解決方案，然后選擇“添加新項目”。

2. 在“添加新項目”對話框中，選擇“Visual Basic”或“Visual C#”，選擇“控制臺應(yīng)用程序”模板，然后將其命名為 Client。 使用默認的位置。

3. 單擊“確定”。

2. 為項目提供對 System.ServiceModel 命名空間的引用：在“解決方案資源管理器”中右擊“Service”項目，從“.NET”選項卡上的“組件名稱”列中選擇“System.ServiceModel”，然后單擊“確定”。

3. 為 System.ServiceModel 命名空間添加 using 語句：using System.ServiceModel;

4. 啟動在前面的步驟中創(chuàng)建的服務(wù)。（即打開在服務(wù)器項目中生成的Service.exe可執(zhí)行文件）

5. 通過執(zhí)行以下步驟，使用適當?shù)拈_關(guān)運行Service Model Metadata Utility Tool (SvcUtil.exe) 以創(chuàng)建客戶端代碼和配置文件：

1. 通過選擇“開始”菜單中的“Microsoft Windows SDK”項下的“CMD Shell”，啟動 Windows SDK 控制臺會話。

2. 導(dǎo)航到要放置客戶端代碼的目錄。 如果使用默認設(shè)置創(chuàng)建 Client 項目，則目錄為 C:Documents and Settings<用戶名>DocumentsVisual Studio 2008ProjectsServiceClient。

3. 將命令行工具Service Model Metadata Utility Tool (SvcUtil.exe) 與適當?shù)拈_關(guān)一起使用以創(chuàng)建客戶端代碼。 下面的示例生成服務(wù)的代碼文件和配置文件。

svcutil.exe /language:cs /out:generatedProxy.cs /config:app.config http://localhost:8000/ServiceModelSamples/service

6. 在 Visual Studio 中將生成的代理添加到 Client 項目中，方法是在“解決方案資源管理器”中右擊“Client”并選擇“添加現(xiàn)有項”。 然后選擇在上一步中生成的 generatedProxy.cs 文件。

配置WCF客戶端（任務(wù)五）

    在 Visual Studio 中，將在前一過程中生成的 App.config 配置文件添加到客戶端項目中。 在“解決方案資源管理器”中右擊該客戶端，選擇“添加現(xiàn)有項”，然后從 C:Documents and Settings<用戶名>DocumentsVisual Studio 2008ProjectsServiceClientin 目錄中選擇 App.config 配置文件。

    將app.config添加到項目中后，就算是完成了wcf客戶端的配置。因為具體的配置信息，我們在使用svcutil.exe工具時，它就幫我們配置好并寫入了app.config文件。

使用WCF客戶端（任務(wù)六）

1、為要調(diào)用的服務(wù)的基址創(chuàng)建 EndpointAddress 實例，然后創(chuàng)建 WCF Client 對象。

    //Create an endpoint address and an instance of the WCF Client.

    EndpointAddress epAddress = new EndpointAddress("http://localhost:8000/ServiceModelSamples/Service/CalculatorService");

    CalculatorClient client = new CalculatorClient(new WSHttpBinding(), epAddress);

2、從 Client 內(nèi)調(diào)用客戶端操作。

// Call the service operations.

// Call the Add service operation.

double value1 = 100.00D;

double value2 = 15.99D;

double result = client.Add(value1, value2);

Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);

// Call the Subtract service operation.

value1 = 145.00D;

value2 = 76.54D;

result = client.Subtract(value1, value2);

Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);

// Call the Multiply service operation.

value1 = 9.00D;

value2 = 81.25D;

result = client.Multiply(value1, value2);

Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);

// Call the Divide service operation.

value1 = 22.00D;

value2 = 7.00D;

result = client.Divide(value1, value2);

Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);

3、在 WCF 客戶端上調(diào)用 Close。

// Closing the client gracefully closes the connection and cleans up resources.

client.Close();

下面是客戶端的完整代碼：

using System;

using System.Collections.Generic;

using System.Text;

using System.ServiceModel;

namespace ServiceModelSamples

{

    class Client

    {

        static void Main()

        {

    //Step 1: Create an endpoint address and an instance of the WCF Client.

            EndpointAddress epAddress = new EndpointAddress("http://localhost:8000/ServiceModelSamples/Service/CalculatorService");

            CalculatorClient client = new CalculatorClient(new WSHttpBinding(), epAddress);

            // Step 2: Call the service operations.

            // Call the Add service operation.

            double value1 = 100.00D;

            double value2 = 15.99D;

            double result = client.Add(value1, value2);

            Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);

            // Call the Subtract service operation.

            value1 = 145.00D;

            value2 = 76.54D;

            result = client.Subtract(value1, value2);

            Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);

            // Call the Multiply service operation.

            value1 = 9.00D;

            value2 = 81.25D;

            result = client.Multiply(value1, value2);

            Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);

            // Call the Divide service operation.

            value1 = 22.00D;

            value2 = 7.00D;

            result = client.Divide(value1, value2);

            Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);

            //Step 3: Closing the client gracefully closes the connection and cleans up resources.

            client.Close();

            Console.WriteLine();

            Console.WriteLine("Press  to terminate client.");

            Console.ReadLine();

        }

    }

}

若要啟動客戶端，請在“開始”菜單中的“Microsoft Windows SDK”項下選擇“CMD Shell”，從而啟動 Windows SDK 控制臺會話。 定位至 C:Documents and Settings<用戶名>DocumentsVisual Studio 2008ProjectsServiceClientobjDebug 目錄，鍵入 client，然后按Enter。 操作請求和響應(yīng)將出現(xiàn)在客戶端控制臺窗口中，如下所示。

Add(100,15.99) = 115.99

Subtract(145,76.54) = 68.46

Multiply(9,81.25) = 731.25

Divide(22,7) = 3.14285714285714

Press  to terminate client.

本文標題：WCF入門-創(chuàng)新互聯(lián)
當前網(wǎng)址：http://weahome.cn/article/shpjo.html