Partager via

WS Transaction Flow

  • Article

Cet exemple illustre l'utilisation d'une transaction coordonnée par le client et des options de client et de serveur pour le flux de transaction, à l'aide du protocole WS-Atomic Transaction ou OleTransactions. Cet exemple est basé sur l'Getting Started, exemple, qui implémente un service de calculatrice. Toutefois, les opérations sont attribuées pour montrer l'utilisation de TransactionFlowAttribute avec l'énumération TransactionFlowOption afin de déterminer le degré d'activation du flux de transaction. Dans l'étendue de la transaction passée, un journal des opérations demandées est écrit dans une base de données et est conservé jusqu'à ce que la transaction coordonnée par le client soit terminée. Si la transaction cliente ne se termine pas, la transaction de service Web garantit que les mises à jour appropriées de la base de données ne sont pas validées.

ms752261.note(fr-fr,VS.90).gifRemarque :
La procédure d'installation ainsi que les instructions de génération relatives à cet exemple figurent en fin de rubrique.

Après avoir initialisé une connexion au service et une transaction, le client accède à plusieurs opérations de service. Le contrat de service est défini comme suit avec chacune des opérations qui montrent un paramètre différent pour TransactionFlowOption.

[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]
public interface ICalculator
{
    [OperationContract]
    [TransactionFlow(TransactionFlowOption.Mandatory)]
    double Add(double n1, double n2);
    [OperationContract]
    [TransactionFlow(TransactionFlowOption.Allowed)]
    double Subtract(double n1, double n2);
    [OperationContract]
    [TransactionFlow(TransactionFlowOption.NotAllowed)]
    double Multiply(double n1, double n2);
    [OperationContract]
    double Divide(double n1, double n2); 
}

Cela permet de définir les opérations dans l'ordre dans lequel elles seront traitées :

  • Une demande d'opération Add doit inclure une transaction passée.
  • Une demande d'opération Subtract peut inclure une transaction passée.
  • Une demande d'opération Multiply ne doit pas inclure de transaction passée par l'intermédiaire du paramètre NotAllowed explicite.
  • Une demande d'opération Divide ne doit pas inclure de transaction passée par omission d'un attribut TransactionFlow.

Pour que le flux de transaction soit activé, les liaisons avec la propriété <transactionFlow> activée doivent être utilisées en plus des attributs d'opération appropriés. Dans cet exemple, la configuration du service expose un point de terminaison TCP et un point de terminaison HTTP en plus du point de terminaison d'échange de métadonnées. Le point de terminaison TCP et le point de terminaison HTTP utilisent les liaisons suivantes, la propriété <transactionFlow> étant activée pour chacune d'elles.

<bindings>
  <netTcpBinding>
    <binding name="transactionalOleTransactionsTcpBinding"
             transactionFlow="true"
             transactionProtocol="OleTransactions"/>
  </netTcpBinding>
  <wsHttpBinding>
    <binding name="transactionalWsatHttpBinding"
             transactionFlow="true" />
  </wsHttpBinding>
</bindings>
ms752261.note(fr-fr,VS.90).gifRemarque :
netTcpBinding fourni par le système autorise la spécification de transactionProtocol alors que wsHttpBinding fourni par le système utilise uniquement le protocole WSAtomicTransactionOctober2004 plus interopérable. Le protocole OleTransactions est disponible uniquement pour les clients Windows Communication Foundation (WCF).

Pour la classe qui implémente l'interface ICalculator, toutes les méthodes sont attribuées avec la propriété TransactionScopeRequired définie sur true. Ce paramètre déclare que toutes les actions prises dans la méthode se produisent dans l'étendue d'une transaction. Dans ce cas, les actions prises incluent l'enregistrement dans la base de données journal. Si la demande d'opération inclut une transaction passée, les actions se produisent alors dans l'étendue de la transaction entrante ou une nouvelle étendue de transaction est automatiquement générée.

ms752261.note(fr-fr,VS.90).gifRemarque :
La propriété TransactionScopeRequired définit le comportement local appliqué aux implémentations de méthode de service et ne définit pas la capacité du client à transmettre la transaction, ni l'obligation de cette transmission. 

// Service class that implements the service contract.
[ServiceBehavior(TransactionIsolationLevel = System.Transactions.IsolationLevel.Serializable)]
public class CalculatorService : ICalculator
{
    [OperationBehavior(TransactionScopeRequired = true)]
    public double Add(double n1, double n2)
    {
        RecordToLog(String.Format(CultureInfo.CurrentCulture, "Adding {0} to {1}", n1, n2));
        return n1 + n2;
    }

    [OperationBehavior(TransactionScopeRequired = true)]
    public double Subtract(double n1, double n2)
    {
        RecordToLog(String.Format(CultureInfo.CurrentCulture, "Subtracting {0} from {1}", n2, n1));
        return n1 - n2;
    }

    [OperationBehavior(TransactionScopeRequired = true)]
    public double Multiply(double n1, double n2)
    {
        RecordToLog(String.Format(CultureInfo.CurrentCulture, "Multiplying {0} by {1}", n1, n2));
        return n1 * n2;
    }

    [OperationBehavior(TransactionScopeRequired = true)]
    public double Divide(double n1, double n2)
    {
        RecordToLog(String.Format(CultureInfo.CurrentCulture, "Dividing {0} by {1}", n1, n2));
        return n1 / n2;
    }

    // Logging method omitted for brevity
}

Sur le client, les paramètres TransactionFlowOption du service sur les opérations sont répercutés dans la définition générée du client de l'interface ICalculator. De plus, les paramètres de la propriété transactionFlow du service sont répercutés dans la configuration de l'application du client. Le client peut sélectionner le transport et le protocole en sélectionnant le endpointConfigurationName approprié.

// Create a client using either wsat or oletx endpoint configurations
CalculatorClient client = new CalculatorClient("WSAtomicTransaction_endpoint");
// CalculatorClient client = new CalculatorClient("OleTransactions_endpoint");
ms752261.note(fr-fr,VS.90).gifRemarque :
Le comportement observé de cet exemple est le même, quel que soit le protocole ou le transport choisi.

Une fois la connexion au service initialisée, le client crée un TransactionScope autour des appels aux opérations de service.

// Start a transaction scope
using (TransactionScope tx =
            new TransactionScope(TransactionScopeOption.RequiresNew))
{
    Console.WriteLine("Starting transaction");

    // Call the Add service operation
    //  - generatedClient will flow the required active transaction
    double value1 = 100.00D;
    double value2 = 15.99D;
    double result = client.Add(value1, value2);
    Console.WriteLine("  Add({0},{1}) = {2}", value1, value2, result);

    // Call the Subtract service operation
    //  - generatedClient will flow the allowed active transaction
    value1 = 145.00D;
    value2 = 76.54D;
    result = client.Subtract(value1, value2);
    Console.WriteLine("  Subtract({0},{1}) = {2}", value1, value2, result);

    // Start a transaction scope that suppresses the current transaction
    using (TransactionScope txSuppress =
                new TransactionScope(TransactionScopeOption.Suppress))
    {
        // Call the Subtract service operation
        //  - the active transaction is suppressed from the generatedClient
        //    and no transaction will flow
        value1 = 21.05D;
        value2 = 42.16D;
        result = client.Subtract(value1, value2);
        Console.WriteLine("  Subtract({0},{1}) = {2}", value1, value2, result);

        // Complete the suppressed scope
        txSuppress.Complete();
    }

    // Call the Multiply service operation
    // - generatedClient will not flow the active transaction
    value1 = 9.00D;
    value2 = 81.25D;
    result = client.Multiply(value1, value2);
    Console.WriteLine("  Multiply({0},{1}) = {2}", value1, value2, result);

    // Call the Divide service operation.
    // - generatedClient will not flow the active transaction
    value1 = 22.00D;
    value2 = 7.00D;
    result = client.Divide(value1, value2);
    Console.WriteLine("  Divide({0},{1}) = {2}", value1, value2, result);

    // Complete the transaction scope
    Console.WriteLine("  Completing transaction");
    tx.Complete();
}

Console.WriteLine("Transaction committed");

Les appels aux opérations sont comme suit :

  • La demande Add transmet la transaction requise au service et les actions du service se produisent dans la portée de la transaction du client.
  • La première demande Subtract transmet également la transaction autorisée au service et, de nouveau, les actions du service se produisent dans la portée de la transaction du client.
  • La seconde demande Subtract est effectuée dans une nouvelle portée de transaction déclarée avec l'option TransactionScopeOption.Suppress. Cela supprime la transaction externe initiale du client et la demande ne transmet pas de transaction au service. Cette approche permet à un client de choisir explicitement de ne pas transmettre une transaction à un service lorsque cela n'est pas obligatoire et de se protéger également contre toute transmission. Les actions du service se produisent dans l'étendue d'une transaction nouvelle et non connectée.
  • La demande Multiply ne transmet pas de transaction au service, car la définition générée du client de l'interface ICalculator inclut un TransactionFlowAttribute ayant la valeur TransactionFlowOption NotAllowed.
  • La demande Divide ne transmet pas de transaction au service, car la définition générée du client de l'interface ICalculator n'inclut pas de TransactionFlowAttribute. Les actions du service se produisent encore dans l'étendue d'une autre transaction nouvelle et non connectée.

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 l'arrêter.

Starting transaction
  Add(100,15.99) = 115.99
  Subtract(145,76.54) = 68.46
  Subtract(21.05,42.16) = -21.11
  Multiply(9,81.25) = 731.25
  Divide(22,7) = 3.14285714285714
  Completing transaction
Transaction committed
Press <ENTER> to terminate client.

Le journal des demandes faites à l'opération de service est visible dans la fenêtre de console du service. Appuyez sur ENTER dans la fenêtre du client pour l'arrêter.

Press <ENTER> to terminate the service.
  Writing row to database: Adding 100 to 15.99
  Writing row to database: Subtracting 76.54 from 145
  Writing row to database: Subtracting 42.16 from 21.05
  Writing row to database: Multiplying 9 by 81.25
  Writing row to database: Dividing 22 by 7

Après une exécution réussie, l'étendue de transaction du client se termine et toutes les actions prises dans cette étendue sont validées. En particulier, les 5 enregistrements distingués sont conservés dans la base de données du service. Les deux premiers se sont produits dans l'étendue de la transaction du client.

Si une exception s'est produite dans le TransactionScope du client, la transaction ne peut alors pas se terminer. Les enregistrements consignés dans cette étendue ne sont alors par validés dans la base de données. Pour observer cet effet, répétez l'exécution de l'exemple après avoir commenté l'appel pour qu'il termine le TransactionScope externe. Sur cette exécution, seules les 3 dernières actions (demandes de la seconde Subtract, Multiply et Divide) sont enregistrées, car la transaction cliente ne leur a pas été transmise.

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

  1. Assurez-vous d'avoir installé SQL Server 2005 Express Edition ou SQL Server 2005. Dans le fichier App.config du service, la base de données connectionString peut être définie ou les interactions de la base de données peuvent être désactivées en affectant la valeur false à l'appSettings usingSql.

  2. Pour générer l'édition C# ou Visual Basic .NET de la solution, conformez-vous aux instructions figurant dans la rubrique Génération des exemples Windows Communication Foundation.

  3. Utilisez l'outil WsatConfig.exe du Kit de développement logiciel Windows pour activer la gestion réseau des transactions WCF.

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

Si vous exécutez l'exemple sur le même ordinateur ou sur des ordinateurs différents, vous devez configurer Microsoft Distributed Transaction Coordinator (MSDTC) pour activer le flux de transaction réseau et utiliser l'outil WsatConfig.exe pour activer la gestion réseau des transactions WCF.

Pour configurer Microsoft Distributed Transaction Coordinator (MSDTC) de manière à prendre en charge l'exécution de l'exemple

  1. Sur l'ordinateur de service, configurez MSDTC pour autoriser des transactions réseau entrantes.

    1. Dans le menu Démarrer, naviguez jusqu'au Panneau de configuration, puis allez dans Outils d'administration et Services de composants.
    2. Ouvrez le dossier Ordinateurs.
    3. Cliquez avec le bouton droit sur Poste de travail, puis sélectionnez Propriétés.
    4. Sous l'onglet MSDTC, cliquez sur Configuration de la sécurité.
    5. Cochez Accès DTC réseau et Autoriser les transactions entrantes.
    6. Cliquez sur OK, puis cliquez sur Oui pour redémarrer le service MSDTC.
    7. Cliquez sur OK pour fermer la boîte de dialogue.

  2. Sur l'ordinateur du service et l'ordinateur du client, configurez le Pare-feu Windows pour inclure le Microsoft Distributed Transaction Coordinator (MSDTC) à la liste des exceptions :

    1. Exécutez l'application de Pare-feu Windows à partir du Panneau de configuration.
    2. Cliquez sur Ajouter un programme sous l'onglet Exceptions.
    3. Naviguez jusqu'au dossier C:\WINDOWS\System32.
    4. Sélectionnez Msdtc.exe et cliquez sur Ouvrir.
    5. Cliquez sur OK pour fermer la boîte de dialogue Ajouter un programme et cliquez à nouveau sur OK pour fermer l'applet du Pare-feu Windows.

  3. Sur l'ordinateur du client, configurez MSDTC pour autoriser les transactions réseau sortantes :

    1. Dans le menu Démarrer, naviguez jusqu'au Control Panel, Outils d'administration et Services de composants.
    2. Cliquez avec le bouton droit sur Poste de travail, puis sélectionnez Propriétés.
    3. Sous l'onglet MSDTC, cliquez sur Configuration de la sécurité.
    4. Cochez Accès DTC réseau et Autoriser les transactions sortantes.
    5. Cliquez sur OK, puis cliquez sur Oui pour redémarrer le service MSDTC.
    6. Cliquez sur OK pour fermer la boîte de dialogue.

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