基本示例

项目
06/08/2023

基本发现示例演示如何使服务可发现以及如何搜索和调用可发现服务。此示例由两个项目组成：服务项目和客户端项目。

注意

此示例在代码中实现发现。有关在配置中实现发现的示例，请参阅配置。

服务

这是一个简单计算器服务实现。与发现相关的代码可以在 Main 中找到，其中向服务主机添加了一个 ServiceDiscoveryBehavior，并且添加了一个 UdpDiscoveryEndpoint，如下面的代码所示。

using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress))
{
    serviceHost.AddServiceEndpoint(typeof(ICalculatorService), new
      WSHttpBinding(), String.Empty);

    // Make the service discoverable over UDP multicast
    serviceHost.Description.Behaviors.Add(new ServiceDiscoveryBehavior());
    serviceHost.AddServiceEndpoint(new UdpDiscoveryEndpoint());

    serviceHost.Open();
    // ...
}

客户端

客户端使用 DynamicEndpoint 定位服务。标准终结点 DynamicEndpoint 在打开客户端时解析服务的终结点。在本例中，DynamicEndpoint 基于服务协定查找服务。默认情况下，DynamicEndpoint 对 UdpDiscoveryEndpoint 进行搜索。定位到服务终结点后，客户端便通过指定绑定连接到服务。

public static void Main()
{
   DynamicEndpoint dynamicEndpoint = new DynamicEndpoint( ContractDescription.GetContract(typeof(ICalculatorService)), new WSHttpBinding());
   // ...
}

客户端定义一个名为 InvokeCalculatorService 方法，该方法使用 DiscoveryClient 类搜索服务。 DynamicEndpoint 继承自 ServiceEndpoint，因此可以传递给 InvokeCalculatorService 方法。本示例随后使用 DynamicEndpoint 创建 CalculatorServiceClient 的实例并调用计算器服务的各个操作。

static void InvokeCalculatorService(ServiceEndpoint serviceEndpoint)
{
   // Create a client
   CalculatorServiceClient client = new CalculatorServiceClient(serviceEndpoint);

   Console.WriteLine("Invoking CalculatorService");
   Console.WriteLine();

   double value1 = 100.00D;
   double value2 = 15.99D;

   // Call the Add service operation.
   double result = client.Add(value1, value2);
   Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);

   // Call the Subtract service operation.
   result = client.Subtract(value1, value2);
   Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);

   // Call the Multiply service operation.
   result = client.Multiply(value1, value2);
   Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);

   // Call the Divide service operation.
   result = client.Divide(value1, value2);
   Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);
   Console.WriteLine();

   //Closing the client gracefully closes the connection and cleans up resources
   client.Close();
}

使用此示例

此示例使用 HTTP 终结点，若要运行此示例，必须添加正确的 URL ACL。有关详细信息，请参阅配置 HTTP 和 HTTPS。使用提升的特权执行下面的命令应添加相应的 ACL。如果该命令无效，则可能需要使用你的域和用户名替换以下自变量。 netsh http add urlacl url=http://+:8000/ user=%DOMAIN%\%UserName%
使用 Visual Studio 打开 Basic.sln 并生成示例。
运行 service.exe 应用程序。
服务启动后，运行 client.exe。
观察客户端是否能够在不知道服务地址的情况下找到服务。

基本示例

服务

客户端

使用此示例

其他资源