Procedimiento para intercambiar mensajes dentro de una sesión confiable

Artículo
04/06/2023

En este tema se describen los pasos necesarios para habilitar una sesión confiable utilizando uno de los enlaces proporcionados por el sistema que admiten este tipo de sesión, pero no de forma predeterminada. Puede habilitar una sesión confiable de manera imperativa mediante código o de manera declarativa en el archivo de configuración. Este procedimiento utiliza los archivos de configuración de cliente y servicio para habilitar la sesión confiable y para estipular que los mensajes lleguen en el mismo orden en el que se enviaron.

La parte clave de este procedimiento es que el elemento de configuración del punto de conexión contiene un atributo bindingConfiguration que hace referencia a una configuración de enlace denominada Binding1. El elemento de configuración <binding> hace referencia a este nombre para habilitar sesiones confiables estableciendo el atributo enabled del elemento <reliableSession> en true. Especifica las garantías de entrega ordenada de la sesión confiable estableciendo el atributo ordered en true.

Para la copia de origen de este ejemplo, consulte Sesión confiable de WS.

Configuración del servicio con WSHttpBinding para utilizar una sesión confiable

Defina un contrato de servicios para el tipo de servicio.

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

Implemente el contrato de servicios en una clase de servicio. Observe que la información de enlace o dirección no se especifica en ninguna parte de la implementación del servicio. No es necesario escribir código para recuperar la información de enlace o dirección del archivo de configuración.

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;
    }
}

Cree un archivo Web.config para configurar un punto de conexión para CalculatorService que use WSHttpBinding con la sesión confiable habilitada y la entrega ordenada de mensajes requerida.

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

    <services>
      <service name="Microsoft.ServiceModel.Samples.CalculatorService">

        <!--
             This endpoint is exposed at the base address provided by
             host: http://localhost/servicemodelsamples/service.svc

             Specify wsHttpBinding binding and a binding configuration
             to use
        -->
        <endpoint address=""
                  binding="wsHttpBinding"
                  bindingConfiguration="Binding1"
                  contract="Microsoft.ServiceModel.Samples.ICalculator" />

        <!--
          The mex endpoint is exposed at
          http://localhost/servicemodelsamples/service.svc/mex
        -->
        <endpoint address="mex"
                  binding="mexHttpBinding"
                  contract="IMetadataExchange" />
      </service>
    </services>

    <!--
         Configures WSHttpBinding for reliable sessions with ordered
         delivery.
    -->
    <bindings>
      <wsHttpBinding>
        <binding name="Binding1">
          <reliableSession enabled="true" ordered="true" />
        </binding>
      </wsHttpBinding>
    </bindings>

  </system.serviceModel>
</configuration>

Cree un archivo Service.svc que contenga la línea:

<%@ServiceHost language=c# Service="CalculatorService" %>

Coloque el archivo Service.svc en el directorio virtual de Internet Information Services (IIS).

Configuración del cliente con WSHttpBinding para utilizar una sesión confiable

Use ServiceModel Metadata Utility Tool (Svcutil.exe) desde la línea de comandos para generar código a partir de los metadatos del servicio:
```
Svcutil.exe <service's Metadata Exchange (MEX) address or HTTP GET address>
```

El cliente generado contiene la interfaz ICalculator que define el contrato de servicio que debe cumplir la implementación del cliente.

//Generated interface defining the ICalculator contract	
[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);
}

La aplicación de cliente generada también contiene la implementación de ClientCalculator. Observe que la información de enlace y dirección no se especifica en ninguna parte de la implementación del servicio. No es necesario escribir código para recuperar la información de enlace o dirección del archivo de configuración.

// Implementation of the CalculatorClient
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);
    }
}

Svcutil.exe también genera la configuración para el cliente que utiliza la clase WSHttpBinding. Asigne un nombre al archivo de configuración App.config al usar Visual Studio.

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

    <client>
      <!-- 
        Specify wsHttpBinding binding and a binding configuration 
        to use
      -->
      <endpoint 
          address="http://localhost/servicemodelsamples/service.svc" 
          binding="wsHttpBinding" 
          bindingConfiguration="Binding1" 
          contract="Microsoft.ServiceModel.Samples.ICalculator" />
    </client>

    <!-- 
      Configures WSHttpBinding for reliable sessions with ordered 
      delivery
    -->
    <bindings>
      <wsHttpBinding>
        <binding name="Binding1">
          <reliableSession enabled="true" ordered="true" />
        </binding>
      </wsHttpBinding>
    </bindings>

  </system.serviceModel>
</configuration>

Cree una instancia de ClientCalculator en una aplicación y, luego, llame a las operaciones de servicio.

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

Compile y ejecute el cliente.

Ejemplo

Algunos de los enlaces proporcionados por el sistema admiten de forma predeterminada las sesiones confiables. Entre ellas se incluyen las siguientes:

Para ver un ejemplo de cómo crear un enlace personalizado que admita sesiones confiables, consulte Creación de un enlace de sesión confiable personalizado con HTTPS.

Consulte también

Sesiones de confianza

Compartir vía

Procedimiento para intercambiar mensajes dentro de una sesión confiable

Configuración del servicio con WSHttpBinding para utilizar una sesión confiable

Configuración del cliente con WSHttpBinding para utilizar una sesión confiable

Ejemplo

Consulte también

Recursos adicionales