Como: especificar uma associação de serviço na configuração

  • Artigo

Neste exemplo, um contrato ICalculator é definido para um serviço de calculadora básica, o serviço é implementado na classe CalculatorService e o ponto de extremidade é configurado no arquivo Web.config, em que é especificado que o serviço usa a BasicHttpBinding. Para ver uma descrição de como configurar esse serviço usando o código em vez de uma configuração, confira Como especificar uma associação de serviço no código.

Geralmente, a melhor prática é especificar as informações de associação e de endereço de maneira declarativa na configuração, em vez de imperativa no código. A definição de pontos de extremidade no código não costuma ser prática, porque as associações e os endereços de um serviço implantado normalmente são diferentes daqueles usados conforme o serviço está sendo desenvolvido. De modo geral, manter as informações de endereçamento e de associação fora do código permite a alteração sem a necessidade de compilar ou implantar novamente o aplicativo.

Todas as etapas de configuração a seguir podem ser executadas usando a Ferramenta do Editor de Configuração (SvcConfigEditor.exe).

Para obter a cópia de origem deste exemplo, confira BasicBinding.

Para especificar a BasicHttpBinding a ser usada para configurar o serviço

  1. Defina um contrato de serviço para o tipo de serviço.

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


    <ServiceContract()> _
Public Interface ICalculator
    <OperationContract()> _
    Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double
    <OperationContract()> _
    Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double
    <OperationContract()> _
    Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double
    <OperationContract()> _
    Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double
End Interface

  2. Implemente o contrato de serviço em uma classe de serviço.

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


    Public Class CalculatorService
    Implements ICalculator
    Public Function Add(ByVal n1 As Double, _
                        ByVal n2 As Double) As Double Implements ICalculator.Add
        Return n1 + n2
    End Function
    Public Function Subtract(ByVal n1 As Double, _
                             ByVal n2 As Double) As Double Implements ICalculator.Subtract
        Return n1 - n2
    End Function
    Public Function Multiply(ByVal n1 As Double, _
                             ByVal n2 As Double) As Double Implements ICalculator.Multiply
        Return n1 * n2
    End Function
    Public Function Divide(ByVal n1 As Double, _
                           ByVal n2 As Double) As Double Implements ICalculator.Divide
        Return n1 / n2
    End Function
End Class

    Observação

    As informações de endereço ou de associação não são especificadas na implementação do serviço. Além disso, o código não precisa ser escrito para buscar essas informações no arquivo de configuração.

  3. Crie um arquivo Web.config para configurar um ponto de extremidade para o CalculatorService que usa a WSHttpBinding.

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

        <!-- Leave the address blank to be populated by default -->
        <!-- from the hosting environment,in this case IIS, so -->
        <!-- the address will just be that of the IIS Virtual -->
        <!-- Directory. -->

        <!-- Specify the binding configuration name for that -->
        <!-- binding type. This is optional but useful if you -->
        <!-- want to modify the properties of the binding. -->
        <!-- The bindingConfiguration name Binding1 is defined -->
        <!-- below in the bindings element. -->
        <endpoint
            address=""
            binding="wsHttpBinding"  
            bindingConfiguration="Binding1"  
            contract="ICalculator" />  
      </service>  
    </services>  
    <bindings>  
      <wsHttpBinding>  
        <binding name="Binding1">  
          <!-- Binding property values can be modified here. -->  
          <!-- See the next procedure. -->  
        </binding>  
      </wsHttpBinding>  
   </bindings>  
  </system.serviceModel>  
</configuration>

  4. Crie um arquivo Service.svc que contenha a linha a seguir e coloque-o no diretório virtual do IIS (Serviços de Informações da Internet).

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

Para modificar os valores padrão das propriedades de associação

  1. Para modificar um dos valores de propriedade padrão do elemento WSHttpBinding, crie um nome de configuração de associação, <binding name="Binding1">, dentro do elemento <wsHttpBinding> e defina os novos valores para os atributos da associação neste elemento de associação. Por exemplo, para alterar os valores de tempo limite padrão abertos e fechados de um minuto a dois minutos, adicione o conteúdo a seguir ao arquivo de configuração.

    <wsHttpBinding>  
  <binding name="Binding1"  
           closeTimeout="00:02:00"  
           openTimeout="00:02:00">  
  </binding>  
</wsHttpBinding>

Confira também