Sessão WS Reliable

O exemplo wsReliableSession demonstra o uso de sessões confiáveis. Sessões confiáveis fornecem suporte para mensagens e sessões confiáveis. Mensagens confiáveis repetem a comunicação em caso de falha e permitem que garantias de entrega sejam especificadas, como a chegada de mensagens na ordem. As sessões mantêm o estado dos clientes entre chamadas. O exemplo implementa sessões para manter o estado do cliente e especifica garantias de entrega no pedido.

Este exemplo é baseado na Introdução que implementa um serviço de calculadora. Os recursos de sessão confiáveis são habilitados e configurados nos arquivos de configuração do aplicativo para o cliente e o serviço.

Neste exemplo, o serviço é hospedado no IIS (Serviços de Informações da Internet) e o cliente é um aplicativo de console (.exe).

Nota

O procedimento de configuração e as instruções de compilação para este exemplo estão localizados no final deste tópico.

O exemplo usa o wsHttpBinding. A associação é especificada nos arquivos de configuração para o cliente e o serviço. O tipo de binding associação é especificado no atributo do elemento de ponto de extremidade, conforme mostrado na configuração de exemplo a seguir.

<endpoint address=""
          binding="wsHttpBinding"
          bindingConfiguration="Binding1"
          contract="Microsoft.ServiceModel.Samples.ICalculator" />

O ponto de extremidade contém um bindingConfiguration atributo que faz referência a uma configuração de vinculação chamada "Binding1". A configuração de vinculação permite sessões confiáveis definindo o enabled<atributo de reliableSession> como .true As garantias de entrega para sessões ordenadas são controladas definindo o atributo ordered como true ou false. A predefinição é true.

<bindings>
    <wsHttpBinding>
        <binding name="Binding1">
            <reliableSession enabled="true" />
        </binding>
    </wsHttpBinding>
</bindings>

A classe de implementação de serviço implementa PerSession a instanciação para manter uma instância de classe separada para cada cliente, conforme mostrado no código de exemplo a seguir.

[ServiceBehavior(InstanceContextMode=InstanceContextMode.PerSession)] public class CalculatorService : ICalculator
{
    ...
}

Quando você executa o exemplo, as solicitações de operação e as respostas são exibidas na janela do console do cliente. Pressione ENTER na janela do cliente para desligar o cliente.

Add(100,15.99) = 115.99
Subtract(145,76.54) = 68.46
Multiply(9,81.25) = 731.25
Divide(22,7) = 3.14285714285714

Press <ENTER> to terminate client.

Para configurar, compilar e executar o exemplo

  1. Instale o ASP.NET 4.0 usando o seguinte comando.

    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable
    
  2. Certifique-se de ter executado o procedimento de instalação única para os exemplos do Windows Communication Foundation.

  3. Para criar a edição C# ou Visual Basic .NET da solução, siga as instruções em Criando os exemplos do Windows Communication Foundation.

  4. Para executar o exemplo em uma configuração de máquina única ou cruzada, siga as instruções em Executando os exemplos do Windows Communication Foundation.