Mise en mémoire tampon de la réception

Cette rubrique s'applique à Windows Workflow Foundation 4.

Cet exemple montre comment installer et configurer la fonctionnalité de mise en mémoire tampon de la réception dans Windows Workflow Foundation (WF). La mise en mémoire tampon de la réception permet à l'auteur de workflow de créer un workflow sans devoir s'inquiéter de l'ordre dans lequel les messages sont reçus. La fonctionnalité de mise en mémoire tampon de la réception met les messages en mémoire tampon localement et les remet lorsque le workflow est prêt à les recevoir.

Montre

Traitement des messages dans le désordre à l'aide de la mise en mémoire tampon de la réception avec les activités de messagerie.

Remarque :

Les exemples peuvent déjà être installés sur votre ordinateur. Recherchez le répertoire (par défaut) suivant avant de continuer. <LecteurInstall>:\WF_WCF_Samples Si ce répertoire n'existe pas, rendez-vous sur la page (éventuellement en anglais) des exemples Windows Communication Foundation (WCF) et Windows Workflow Foundation (WF) pour .NET Framework 4 pour télécharger tous les exemples Windows Communication Foundation (WCF) et WF. Cet exemple se trouve dans le répertoire suivant. <LecteurInstall>:\WF_WCF_Samples\WF\Basic\Services\BufferedReceive

Discussion

Dans cet exemple, un service Windows Communication Foundation (WCF) est implémenté à l'aide de WF et a une séquence d'activités Receive. Ce workflow modélise un processus d'approbation d'un emprunt simple où le workflow attend trois notifications pour qu'un emprunt soit approuvé. Une application cliente Windows Communication Foundation (WCF) envoie trois notifications corrélées dans l'ordre inverse de celui attendu par le service. Étant donné que la fonctionnalité de mise en mémoire tampon de la réception est activée au niveau du service, chaque message dans le désordre est mis en mémoire tampon au niveau du service et traité lorsque le workflow est prêt à le recevoir.

La fonctionnalité de mise en mémoire tampon de la réception nécessitant la prise en charge de ReceiveContent à partir de la liaison, le service utilise NetMsmqBinding. Aucune configuration spéciale n'étant requise pour la liaison, les valeurs par défaut sont utilisées.

<endpoint address ="net.msmq://localhost/private/LoanService/Service1.xamlx"
                  binding="netMsmqBinding"
                  contract="ILoanService"/>

Le service expose également des métadonnées pour le service à l'aide de ServiceMetadataBehavior.

De la même façon, le point de terminaison de client est configuré à l'aide de NetMsmqBinding. La configuration et le code client sont générés à l'aide de la fonctionnalité Ajouter une référence de service de Visual Studio. L'exemple suivant est le point de terminaison de client généré dans le fichier App.config.

<endpoint address="net.msmq://localhost/private/LoanService/Service1.xamlx"
                binding="netMsmqBinding" bindingConfiguration="NetMsmqBinding_ILoanService"
                contract="ServiceReference1.ILoanService" name="NetMsmqBinding_ILoanService" />

Cet exemple requiert que les composants Windows suivants soient activés :

1. services Internet (IIS) 6.0

2. Compatibilité avec la gestion services Internet (IIS) 6.0 , Compatibilité avec la métabase et la configuration

3. Services World Wide Web, Fonctionnalités de développement d'applications et ASP.NET

4. Serveur de file d'attente Microsoft Message Queue (MSMQ)

Pour configurer et générer l'exemple

1. À une invite de commandes Visual Studio 2010, inscrivez ASP.NET en tapant aspnet_regiis –I et appuyez sur ENTRÉE.

2. Exécutez Visual Studio 2010 en tant qu'administrateur.

3. Ouvrez LoanService.sln.

4. Lorsque vous êtes invité à créer les répertoires virtuels pour le projet LoanService, sélectionnez Oui.

Pour configurer les files d'attente de service

1. Appuyez sur F5 pour exécuter l'application LoanClient qui crée les files d'attente et active le service défini dans Service1.xamlx.

2. Ouvrez la console Gestion de l'ordinateur en exécutant Compmgmt.msc à partir d'une invite de commandes.

3. Dans la console Gestion de l'ordinateur, développez Service, Applications, Message Queuing, Files d'attente privées.

4. Cliquez avec le bouton droit sur la file d'attente loanservice/service1.xamlx et sélectionnez Propriétés.

5. Sélectionnez l'onglet Sécurité et ajoutez pour Tout le monde les autorisations Recevoir un message, Lire le message et Envoyer un message.

6. Ouvrez le Gestionnaire services Internet (IIS) 6.0 .

7. Naviguez jusqu'à Serveur, Sites, Site Web par défaut, Privé, LoanService, puis sélectionnez Options avancées.

8. Remplacez la valeur de Protocoles activés par http, net.msmq.

Pour exécuter l'exemple

1. Naviguez jusqu'à https://localhost/private/loanservice/service1.xamlx pour vérifier que le service s'exécute.

2. Appuyez sur F5 pour exécuter l'application LoanClient. Une fois le workflow terminé, un fichier out.txt doit être enregistré dans C:\Inbox qui contient le résultat de l'échange de messages.

Pour nettoyer

1. Ouvrez la console Gestion de l'ordinateur en exécutant Compmgmt.msc à partir d'une invite de commandes.

2. Développez Services et applications, Message Queuing, Files d'attente privées.

3. Supprimez la file d'attente loanservice/service1.xamlx.

4. Supprimez le répertoire C:\Inbox.

Remarque :

Les exemples peuvent déjà être installés sur votre ordinateur. Recherchez le répertoire (par défaut) suivant avant de continuer. <LecteurInstall>:\WF_WCF_Samples Si ce répertoire n'existe pas, rendez-vous sur la page (éventuellement en anglais) des exemples Windows Communication Foundation (WCF) et Windows Workflow Foundation (WF) pour .NET Framework 4 pour télécharger tous les exemples Windows Communication Foundation (WCF) et WF. Cet exemple se trouve dans le répertoire suivant. <LecteurInstall>:\WF_WCF_Samples\WF\Basic\Services\BufferedReceive