Procédure : spécifier une liaison de service dans la configuration

  • Article

Dans cet exemple, un contrat ICalculator est défini pour un service de calculatrice de base, le service est implémenté dans la classe CalculatorService, puis son point de terminaison est configuré dans le fichier Web.config, où il est spécifié que le service utilise BasicHttpBinding. Pour obtenir une description de la configuration de ce service à l’aide de code plutôt que d’une configuration, consultez Procédure : Spécifier une liaison de service dans le code.

Il est généralement conseillé de spécifier de façon déclarative les informations de liaison et d'adresse dans la configuration plutôt que de manière impérative dans le code. La définition de points de terminaison dans le code est généralement peu pratique car les liaisons et les adresses pour un service déployé sont en général différentes de celles utilisées au cours du développement du service. Plus généralement, le fait de laisser les informations de liaison et d’adresse hors du code leur permet de changer sans nécessiter de recompilation ou de redéploiement de l’application.

L’outil Configuration Editor Tool (SvcConfigEditor.exe) permet d’effectuer toutes les étapes de configuration suivantes.

Pour obtenir une copie de la source de cet exemple, consultez BasicBinding.

Pour spécifier le BasicHttpBinding à utiliser pour configurer le service

  1. Définissez un contrat de service pour le type de service.

    [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. Implémentez le contrat de service dans une classe de service.

    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

    Notes

    Les informations de liaison ou d'adresse ne sont pas spécifiées dans l'implémentation du service. De plus, il n'est pas nécessaire d'écrire du code pour extraire ces informations du fichier de configuration.

  3. Créez un fichier Web.config pour configurer un point de terminaison pour le CalculatorService qui utilise le 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. Créez un fichier Service.svc qui contient la ligne suivante et placez-le dans votre répertoire virtuel des services Internet (IIS).

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

Pour modifier les valeurs par défaut des propriétés de liaison

  1. Pour modifier l’une des valeurs de propriété par défaut de WSHttpBinding, créez un nom de configuration de liaison - <binding name="Binding1"> - dans l’élément <wsHttpBinding> et définissez les nouvelles valeurs des attributs de la liaison dans cet élément de liaison. Par exemple, pour modifier les valeurs par défaut de délai d'attente d'ouverture et de fermeture de 1 minute à 2 minutes, ajoutez le code suivant au fichier de configuration.

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

Voir aussi