作法：實作以探索 Proxy 註冊的可探索服務

發行項
06/08/2024

本主題是四個主題中的第二個，討論如何實作探索 Proxy。在上一個主題 (如何：實作以探索 Proxy) 中，您已實作探索 Proxy。在這個主題中，您會建立一個 WCF 服務，這個服務會傳送公告訊息 (Hello 和 Bye) 至探索 Proxy，使其向探索 Proxy 註冊和取消註冊其本身。

若要定義服務合約

將新的主控台應用程式專案加入至名為 DiscoveryProxyExample 的 Service 方案。
加入下列組件的參考：
1. System.ServiceModel
2. System.ServiceModel.Discovery
將新的類別加入至名為 CalculatorService 的專案。

新增下列 using 指示詞。

using System;
using System.ServiceModel;

在 CalculatorService.cs 內定義服務合約。

// Define a service contract.
[ServiceContract(Namespace = "http://Microsoft.Samples.Discovery")]
public interface ICalculatorService
{
    [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);
}

同樣地，在 CalculatorService.cs 內實作服務合約。

// Service class which implements the service contract.
public class CalculatorService : ICalculatorService
{
    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;
    }
}

若要裝載服務

開啟當您建立專案時產生的 Program.cs 檔案。

新增下列 using 指示詞。

using System;
using System.ServiceModel;
using System.ServiceModel.Description;
using System.ServiceModel.Discovery;

在 Main() 方法內加入下列程式碼：

// Define the base address of the service
Uri baseAddress = new Uri("net.tcp://localhost:9002/CalculatorService/" + Guid.NewGuid().ToString());
// Define the endpoint address where announcement messages will be sent
Uri announcementEndpointAddress = new Uri("net.tcp://localhost:9021/Announcement");

// Create the service host
ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress);
try
{
    // Add a service endpoint
    ServiceEndpoint netTcpEndpoint = serviceHost.AddServiceEndpoint(typeof(ICalculatorService),
        new NetTcpBinding(), string.Empty);

    // Create an announcement endpoint, which points to the Announcement Endpoint hosted by the proxy service.
    AnnouncementEndpoint announcementEndpoint = new AnnouncementEndpoint(new NetTcpBinding(),
        new EndpointAddress(announcementEndpointAddress));

    // Create a ServiceDiscoveryBehavior and add the announcement endpoint
    ServiceDiscoveryBehavior serviceDiscoveryBehavior = new ServiceDiscoveryBehavior();
    serviceDiscoveryBehavior.AnnouncementEndpoints.Add(announcementEndpoint);

    // Add the ServiceDiscoveryBehavior to the service host to make the service discoverable
    serviceHost.Description.Behaviors.Add(serviceDiscoveryBehavior);

    // Start listening for messages
    serviceHost.Open();

    Console.WriteLine("Calculator Service started at {0}", baseAddress);
    Console.WriteLine();
    Console.WriteLine("Press <ENTER> to terminate the service.");
    Console.WriteLine();
    Console.ReadLine();

    serviceHost.Close();
}
catch (CommunicationException e)
{
    Console.WriteLine(e.Message);
}
catch (TimeoutException e)
{
    Console.WriteLine(e.Message);
}

if (serviceHost.State != CommunicationState.Closed)
{
    Console.WriteLine("Aborting the service...");
    serviceHost.Abort();
}

您已經完成實作可探索的服務。繼續至如何：實作使用探索 Proxy 的用戶端應用程式來尋找服務。

範例

以下是本主題所使用之程式碼的完整清單。

// CalculatorService.cs
//----------------------------------------------------------------
// Copyright (c) Microsoft Corporation.  All rights reserved.
//----------------------------------------------------------------

using System;
using System.ServiceModel;

namespace Microsoft.Samples.Discovery
{
    // Define a service contract.
    [ServiceContract(Namespace = "http://Microsoft.Samples.Discovery")]
    public interface ICalculatorService
    {
        [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 which implements the service contract.
    public class CalculatorService : ICalculatorService
    {
        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;
        }
    }
}

// Program.cs
//----------------------------------------------------------------
// Copyright (c) Microsoft Corporation.  All rights reserved.
//----------------------------------------------------------------

using System;
using System.ServiceModel;
using System.ServiceModel.Description;
using System.ServiceModel.Discovery;

namespace Microsoft.Samples.Discovery
{
    class Program
    {
        public static void Main()
        {
            Uri baseAddress = new Uri("net.tcp://localhost:9002/CalculatorService/" + Guid.NewGuid().ToString());
            Uri announcementEndpointAddress = new Uri("net.tcp://localhost:9021/Announcement");

            ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress);
            try
            {
                ServiceEndpoint netTcpEndpoint = serviceHost.AddServiceEndpoint(typeof(ICalculatorService),
                    new NetTcpBinding(), string.Empty);

                // Create an announcement endpoint, which points to the Announcement Endpoint hosted by the proxy service.
                AnnouncementEndpoint announcementEndpoint = new AnnouncementEndpoint(new NetTcpBinding(),
                    new EndpointAddress(announcementEndpointAddress));

                ServiceDiscoveryBehavior serviceDiscoveryBehavior = new ServiceDiscoveryBehavior();
                serviceDiscoveryBehavior.AnnouncementEndpoints.Add(announcementEndpoint);

                // Make the service discoverable
                serviceHost.Description.Behaviors.Add(serviceDiscoveryBehavior);

                serviceHost.Open();

                Console.WriteLine("Calculator Service started at {0}", baseAddress);
                Console.WriteLine();
                Console.WriteLine("Press <ENTER> to terminate the service.");
                Console.WriteLine();
                Console.ReadLine();

                serviceHost.Close();
            }
            catch (CommunicationException e)
            {
                Console.WriteLine(e.Message);
            }
            catch (TimeoutException e)
            {
                Console.WriteLine(e.Message);
            }

            if (serviceHost.State != CommunicationState.Closed)
            {
                Console.WriteLine("Aborting the service...");
                serviceHost.Abort();
            }
        }
    }
}

共用方式為

作法：實作以探索 Proxy 註冊的可探索服務

若要定義服務合約

若要裝載服務

範例

另請參閱

其他資源