Route by Body

Cet exemple montre comment implémenter un service qui accepte des objets de message avec toute action SOAP. Cet exemple est basé sur Getting Started, exemple qui implémente un service de calculatrice. Le service implémente une opération Calculate unique qui accepte un paramètre de demande Message et retourne une réponse Message.

Dans cet exemple, le client est une application console (.exe) et le service est hébergé dans IIS.

Remarque :
La procédure d'installation ainsi que les instructions de génération relatives à cet exemple figurent en fin de rubrique.

L'exemple illustre la distribution des messages selon le contenu du corps. Le modèle de service Windows Communication Foundation (WCF) intégré de distribution des messages est basé sur les actions de message. Toutefois, il existe de nombreux services Web qui définissent toutes leurs opérations avec l'action="". Il est impossible de générer un service reposant sur WSDL qui continue à distribuer des messages de demande selon les informations d'action. Cet exemple montre un contrat de service basé sur WSDL (WSDL est contenu dans Service.wsdl, lui-même inclus dans l'exemple). Il s'agit d'un contrat de service de calculatrice, semblable à celui utilisé dans Getting Started, exemple. Toutefois, le [OperationContract] spécifie Action="" pour toutes les opérations.

[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples"),  
                 XmlSerializerFormat, DispatchByBodyBehavior]
    public interface ICalculator
    {
        [OperationContract(Action="")]
        double Add(double n1, double n2);
        [OperationContract(Action = "")]
        double Subtract(double n1, double n2);
        [OperationContract(Action = "")]
        double Multiply(double n1, double n2);
        [OperationContract(Action = "")]
        double Divide(double n1, double n2);
    }

Selon le contrat, le service requiert le comportement de distribution personnalisé DispatchByBodyBehavior pour autoriser les messages à être distribués entre des opérations. Ce comportement de distribution initialise le sélecteur d'opération personnalisé DispatchByBodyElementOperationSelector avec une table des noms d'opération indexés par le QName des éléments wrapper respectifs. DispatchByBodyElementOperationSelector consulte la balise de début du premier enfant du corps et sélectionne l'opération à l'aide de la table susmentionnée.

Le client utilise un proxy généré automatiquement du WSDL exporté par le service à l'aide de l'Service Metadata Utility Tool (Svcutil.exe).

svcutil.exe  /n:http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples /uxs https://localhost/servicemodelsamples/service.svc?wsdl /out:generatedProxy.cs

Le fait que les actions de toutes les opérations soient vides n'a aucun impact sur le code client, à l'exception des paramètres d'action du proxy généré automatiquement.

Le code client effectue plusieurs calculs. Lorsque vous exécutez l'exemple, les demandes et réponses d'opération s'affichent dans la fenêtre de console cliente. Appuyez sur ENTER dans la fenêtre du client pour arrêter le client.

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.

Pour configurer, générer et exécuter l'exemple

1. Assurez-vous d'avoir effectué la procédure indiquée à la section Procédure d'installation unique pour les exemples Windows Communication Foundation.

2. Pour générer la solution, suivez les instructions indiquées dans la rubrique Génération des exemples Windows Communication Foundation.

3. Pour exécuter l'exemple dans une configuration à un ou plusieurs ordinateurs, suivez les instructions indiquées dans Exécution des exemples Windows Communication Foundation.

Send comments about this topic to Microsoft.
© 2007 Microsoft Corporation. All rights reserved.