Partilhar via

Sessão confiável de vinculação personalizada

  • Artigo

O exemplo ReliableSession demonstra como configurar uma associação personalizada com vários elementos de transporte e codificação de mensagens, especialmente permitindo sessões confiáveis. Uma ligação personalizada é definida por uma lista ordenada de elementos de ligação discretos.

Detalhes da amostra

Sessões confiáveis fornecem recursos para mensagens e sessões confiáveis. Mensagens confiáveis repetem a comunicação em caso de falha e permitem que garantias de entrega, como a chegada de mensagens em ordem, sejam especificadas. 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. O 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.

Nota

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

A ordenação dos elementos de vinculação é importante na definição de uma associação personalizada, porque cada um representa uma camada na pilha de canais (consulte Ligações personalizadas).

A configuração de serviço para o exemplo é definida conforme mostrado no exemplo de código a seguir.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>
    <services>
      <service
          name="Microsoft.ServiceModel.Samples.CalculatorService"
          behaviorConfiguration="CalculatorServiceBehavior">
        <!-- This endpoint is exposed at the base address provided by host: http://localhost/servicemodelsamples/service.svc  -->
        <!-- specify customBinding binding and a binding configuration to use -->
        <endpoint address=""
                  binding="customBinding"
                  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>

    <!-- custom binding configuration - configures HTTP transport, reliable sessions -->
    <bindings>
      <customBinding>
        <binding name="Binding1">
          <reliableSession />
          <security authenticationMode="SecureConversation"
                     requireSecurityContextCancellation="true">
          </security>
          <compositeDuplex />
          <oneWay />
          <textMessageEncoding messageVersion="Soap12WSAddressing10" writeEncoding="utf-8" />
          <httpTransport authenticationScheme="Anonymous" bypassProxyOnLocal="false"
                        hostNameComparisonMode="StrongWildcard"
                        proxyAuthenticationScheme="Anonymous" realm=""
                        useDefaultWebProxy="true" />
        </binding>
      </customBinding>
    </bindings>

    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->
    <behaviors>
      <serviceBehaviors>
        <behavior name="CalculatorServiceBehavior">
          <serviceMetadata httpGetEnabled="True"/>
          <serviceDebug includeExceptionDetailInFaults="False" />
        </behavior>
      </serviceBehaviors>
    </behaviors>

  </system.serviceModel>

</configuration>

Ao executar em um cenário entre máquinas, você deve alterar o endereço do ponto de extremidade do cliente para refletir o nome do host do serviço.

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.

    Importante

    Ao executar o cliente em uma configuração entre máquinas, certifique-se de substituir "localhost" no address atributo do elemento endpoint<> e no clientBaseAddress atributo do< compositeDuplex> pelo nome da máquina apropriada, conforme mostrado no exemplo a seguir.

    <endpoint name = ""
address="http://service_machine_name/servicemodelsamples/service.svc" />
<compositeDuplex clientBaseAddress="http://client_machine_name:8000/myClient/" />