Postupy: Zadání klientské vazby v konfiguraci

Článek
03/05/2024

V tomto příkladu se vytvoří konzolová aplikace klienta pro použití služby kalkulačky a vazba pro tohoto klienta se zadává deklarativní v konfiguraci. Klient přistupuje k CalculatorServicerozhraní , který implementuje ICalculator rozhraní, a jak služba, tak klient používají BasicHttpBinding třídu.

Uvedený postup předpokládá, že je spuštěná služba kalkulačky. Informace o tom, jak vytvořit službu, naleznete v tématu Postupy: Určení vazby služby v konfiguraci. Používá také nástroj ServiceModel Metadata Utility (Svcutil.exe), který windows Communication Foundation (WCF) poskytuje k automatickému generování klientských komponent. Nástroj vygeneruje klientský kód a konfiguraci pro přístup ke službě.

Klient je sestavený ve dvou částech. Svcutil.exe vygeneruje ClientCalculator rozhraní, které implementuje ICalculator . Tato klientská aplikace je pak vytvořena vytvořením instance ClientCalculator.

Osvědčeným postupem je obvykle deklarativní určení informací o vazbě a adresách v konfiguraci, nikoli imperativním způsobem v kódu. Definování koncových bodů v kódu obvykle není praktické, protože vazby a adresy nasazené služby se obvykle liší od těch, které se používají při vývoji služby. Obecněji platí, že udržování vazby a adresování informací mimo kód umožňuje jejich změnu, aniž by bylo nutné aplikaci znovu zkompilovat nebo znovu nasadit.

Všechny následující kroky konfigurace můžete provést pomocí nástroje Editor konfigurace (SvcConfigEditor.exe).

Zdrojovou kopii tohoto příkladu najdete v ukázce BasicBinding .

Určení vazby klienta v konfiguraci

K vygenerování kódu z metadat služby použijte Svcutil.exe z příkazového řádku.
```
Svcutil.exe <service's Metadata Exchange (MEX) address or HTTP GET address>
```

Klient, který je vygenerován, obsahuje ICalculator rozhraní, které definuje kontrakt služby, který musí implementace klienta splňovat.

[System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0")]
[System.ServiceModel.ServiceContractAttribute(Namespace="http://Microsoft.ServiceModel.Samples", ConfigurationName="Microsoft.ServiceModel.Samples.ICalculator")]
public interface ICalculator
{

    [System.ServiceModel.OperationContractAttribute(Action="http://Microsoft.ServiceModel.Samples/ICalculator/Add", ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/AddResponse")]
    double Add(double n1, double n2);

    [System.ServiceModel.OperationContractAttribute(Action="http://Microsoft.ServiceModel.Samples/ICalculator/Subtract", ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/SubtractResponse")]
    double Subtract(double n1, double n2);

    [System.ServiceModel.OperationContractAttribute(Action="http://Microsoft.ServiceModel.Samples/ICalculator/Multiply", ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/MultiplyResponse")]
    double Multiply(double n1, double n2);

    [System.ServiceModel.OperationContractAttribute(Action="http://Microsoft.ServiceModel.Samples/ICalculator/Divide", ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/DivideResponse")]
    double Divide(double n1, double n2);
}

[ServiceContract]
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);
}

Vygenerovaný klient také obsahuje implementaci ClientCalculator.

[System.Diagnostics.DebuggerStepThroughAttribute()]
[System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0")]
public partial class CalculatorClient : System.ServiceModel.ClientBase<Microsoft.ServiceModel.Samples.ICalculator>, Microsoft.ServiceModel.Samples.ICalculator
{

    public CalculatorClient()
    {
    }

    public CalculatorClient(string endpointConfigurationName) :
            base(endpointConfigurationName)
    {
    }

    public CalculatorClient(string endpointConfigurationName, string remoteAddress) :
            base(endpointConfigurationName, remoteAddress)
    {
    }

    public CalculatorClient(string endpointConfigurationName, System.ServiceModel.EndpointAddress remoteAddress) :
            base(endpointConfigurationName, remoteAddress)
    {
    }

    public CalculatorClient(System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress remoteAddress) :
            base(binding, remoteAddress)
    {
    }

    public double Add(double n1, double n2)
    {
        return base.Channel.Add(n1, n2);
    }

    public double Subtract(double n1, double n2)
    {
        return base.Channel.Subtract(n1, n2);
    }

    public double Multiply(double n1, double n2)
    {
        return base.Channel.Multiply(n1, n2);
    }

    public double Divide(double n1, double n2)
    {
        return base.Channel.Divide(n1, n2);
    }
}

public class CalculatorService : ICalculator
{
   public double Add(double n1, double n2)
   {
      return n1 + n2;
   }
   public double Subtract(double n1, double n2)
   {
      return n1 - n2;
   }
   public double Multiply(double n1, double n2)
   {
      return n1 * n2;
   }
   public double Divide(double n1, double n2)
   {
      return n1 / n2;
   }
}

Svcutil.exe také vygeneruje konfiguraci pro klienta, který používá BasicHttpBinding třídu. Při použití sady Visual Studio pojmenujte tento soubor App.config. Všimněte si, že informace o adrese a vazbě nejsou zadány nikde uvnitř implementace služby. Kód také nemusí být zapsán pro načtení informací z konfiguračního souboru.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>

    <client>
      <endpoint 
          name=""
          address="http://localhost/servicemodelsamples/service.svc" 
          binding="basicHttpBinding" 
          contract="Microsoft.ServiceModel.Samples.ICalculator" />
    </client>

    <bindings>
      <basicHttpBinding/>
    </bindings>

  </system.serviceModel>

</configuration>

Vytvořte instanci ClientCalculator aplikace a pak volejte operace služby.


using System;
using System.ServiceModel;

namespace Microsoft.ServiceModel.Samples
{

    //Client implementation code.
    class Client
    {
        static void Main()
        {
            // Create a client with given client endpoint configuration
            CalculatorClient client = new CalculatorClient();

            // 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);

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

            Console.WriteLine();
            Console.WriteLine("Press <ENTER> to terminate client.");
            Console.ReadLine();
        }
    }
}

Zkompilujte a spusťte klienta.

Viz také

Používání vazeb ke konfiguraci služeb a klientů

Sdílet prostřednictvím

Postupy: Zadání klientské vazby v konfiguraci

Určení vazby klienta v konfiguraci

Viz také

Další materiály