サービストランザクションの動作

[アーティクル]
05/10/2023

Transactions のサンプルでは、クライアント調整トランザクションの使用方法と、サービストランザクションの動作を制御する ServiceBehaviorAttribute と OperationBehaviorAttribute の設定方法を示します。このサンプルは、電卓サービスを実装する概要サンプルに基づきますが、データベーステーブルで実行された操作のサーバーログを維持するために拡張されています。サーバーログテーブルへの書き込みを保存するかどうかは、クライアント調整トランザクションの結果によって異なります。クライアントトランザクションが完了しない場合は、Web サービストランザクションにより、データベースへの更新はコミットされません。

Note

このサンプルのセットアップ手順とビルド手順については、この記事の最後を参照してください。

サービスのコントラクトでは、すべての操作でトランザクションを要求に応じてフローする必要があることを、次のように定義します。

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

受信トランザクションフローを有効にするには、transactionFlow 属性が true に設定されているシステム指定の wsHttpBinding を使用して、サービスを構成します。このバインディングは、相互操作可能な WSAtomicTransactionOctober2004 プロトコルを使用します。

<bindings>
  <wsHttpBinding>
    <binding name="transactionalBinding" transactionFlow="true" />
  </wsHttpBinding>
</bindings>

サービスへの接続とトランザクションの起動後、クライアントは次のようにそのトランザクションのスコープに含まれるいくつかのサービス処理にアクセスして、そのトランザクションを完了して接続を終了します。

// Create a client
CalculatorClient client = new CalculatorClient();

// Create a transaction scope with the default isolation level of Serializable
using (TransactionScope tx = new TransactionScope())
{
    Console.WriteLine("Starting transaction");

    // Call the Add service operation.
    double value = 100.00D;
    Console.WriteLine("  Adding {0}, running total={1}",
                                        value, client.Add(value));

    // Call the Subtract service operation.
    value = 45.00D;
    Console.WriteLine("  Subtracting {0}, running total={1}",
                                        value, client.Subtract(value));

    // Call the Multiply service operation.
    value = 9.00D;
    Console.WriteLine("  Multiplying by {0}, running total={1}",
                                        value, client.Multiply(value));

    // Call the Divide service operation.
    value = 15.00D;
    Console.WriteLine("  Dividing by {0}, running total={1}",
                                        value, client.Divide(value));

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

Console.WriteLine("Transaction committed");

// Closing the client gracefully closes the connection and cleans up resources
client.Close();

サービス側には、次のようにサービストランザクションの動作に影響を及ぼす 3 つの属性があります。

ServiceBehaviorAttribute :
- TransactionTimeout プロパティは、トランザクションが完了する必要のある期間を指定します。このサンプルでは、30 秒に設定されています。
- TransactionIsolationLevel プロパティは、サービスがサポートする分離レベルを指定します。クライアントの分離レベルと一致する必要があります。
- ReleaseServiceInstanceOnTransactionComplete プロパティは、トランザクションが完了したときにサービスインスタンスを再利用するかどうかを指定します。 false に設定すると、サービスは操作要求全体で同じサービスインスタンスを保持します。この設定は、現在高を保持するために必要です。 true に設定すると、各アクションが完了するたびに新しいインスタンスが生成されます。
- TransactionAutoCompleteOnSessionClose プロパティは、セッションの終了時に未解決のトランザクションを完了するかどうかを指定します。 false に設定すると、個別の操作で OperationBehaviorAttribute.TransactionAutoComplete プロパティを true に設定するか、または OperationContext.SetTransactionComplete() メソッドを明示的に呼び出して、トランザクションを完了する必要があります。このサンプルでは、両方の方法を示します。
ServiceContractAttribute :
- SessionMode プロパティは、適切な要求を相互に関連付けて論理セッションに格納するかどうかを指定します。このサービスには、OperationBehaviorAttribute TransactionAutoComplete プロパティが false に設定されている操作 (乗算および除算) が含まれているため、SessionMode.Required を指定する必要があります。たとえば、乗算操作ではトランザクションは完了せず、後で呼び出される除算操作により、SetTransactionComplete メソッドを使用して完了します。したがってこのサービスでは、これらの操作が同じセッション内で発生するかどうかを決定できる必要があります。
OperationBehaviorAttribute :
- TransactionScopeRequired プロパティは、操作のアクションをトランザクションスコープ内で実行する必要があるかどうかを指定します。このプロパティは、このサンプルのすべての操作で true に設定されています。クライアントはそのトランザクションをすべての操作にフローするため、アクションはクライアントトランザクションのスコープ内で発生します。
- TransactionAutoComplete プロパティは、未処理の例外が発生しなかった場合にメソッドが実行中のトランザクションが自動的に完了するかどうかを指定します。前述のように、このプロパティは加算操作および減算操作では true に設定されていますが、乗算操作および除算操作では false に設定されています。加算操作と減算操作は、これらのアクションを自動的に完了し、除算操作は、SetTransactionComplete メソッドを明示的に呼び出すことによってアクションを完了します。乗算操作はアクションを完了せず、アクションを完了するために除算などを後で呼び出す必要があり、この呼び出しに依存しています。

属性サービスの実装は、次のとおりです。

[ServiceBehavior(
    TransactionIsolationLevel = System.Transactions.IsolationLevel.Serializable,
    TransactionTimeout = "00:00:30",
    ReleaseServiceInstanceOnTransactionComplete = false,
    TransactionAutoCompleteOnSessionClose = false)]
public class CalculatorService : ICalculator
{
    double runningTotal;

    public CalculatorService()
    {
        Console.WriteLine("Creating new service instance...");
    }

    [OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = true)]
    public double Add(double n)
    {
        RecordToLog(String.Format(CultureInfo.CurrentCulture, "Adding {0} to {1}", n, runningTotal));
        runningTotal = runningTotal + n;
        return runningTotal;
    }

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

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

    [OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = false)]
    public double Divide(double n)
    {
        RecordToLog(String.Format(CultureInfo.CurrentCulture, "Dividing {0} by {1}", runningTotal, n));
        runningTotal = runningTotal / n;
        OperationContext.Current.SetTransactionComplete();
        return runningTotal;
    }

    // Logging method omitted for brevity
}

このサンプルを実行すると、操作要求および応答がクライアントのコンソールウィンドウに表示されます。クライアントをシャットダウンするには、クライアントウィンドウで Enter キーを押します。

Starting transaction
Performing calculations...
  Adding 100, running total=100
  Subtracting 45, running total=55
  Multiplying by 9, running total=495
  Dividing by 15, running total=33
  Completing transaction
Transaction committed
Press <ENTER> to terminate client.

サービス操作要求のログ記録は、サービスのコンソールウィンドウに表示されます。クライアントをシャットダウンするには、クライアントウィンドウで Enter キーを押します。

Press <ENTER> to terminate service.
Creating new service instance...
  Writing row 1 to database: Adding 100 to 0
  Writing row 2 to database: Subtracting 45 from 100
  Writing row 3 to database: Multiplying 55 by 9
  Writing row 4 to database: Dividing 495 by 15

サービスは計算の現在高を保持することに加え、インスタンス (このサンプルでは 1 つのインスタンス) の作成を報告し、データベースのログに操作要求を記録します。すべての要求はクライアントトランザクションをフローするため、トランザクションの完了に失敗した場合、すべてのデータベース操作がロールバックされます。これについては、次のようないくつかの方法で示すことができます。

クライアントの tx.Complete() への呼び出しをコメント化して再実行します。これによってクライアントは、トランザクションを完了せずにトランザクションスコープを終了します。
除算サービス操作への呼び出しをコメント化します。これによって、乗算操作により初期化されたアクションの完了が回避され、したがって、クライアントのトランザクションの完了も最終的に失敗します。
未処理の例外を、クライアントのトランザクションスコープ内の任意の場所にスローします。これによってクライアントのトランザクションの完了が同様に回避されます。

これらの結果、スコープ内で実行される操作はコミットされず、データベースに保持されている行数はインクリメントしません。

Note

ビルドプロセスの一貫として、データベースファイルが bin フォルダにコピーされます。このデータベースファイルのコピーを調べ、Visual Studio プロジェクトに格納されているファイルではなく、ログに保存されている行を監視する必要があります。

サンプルをセットアップ、ビルド、および実行するには

SQL Server 2005 Express Edition または SQL Server 2005 がインストールされていることを確認してください。サービスの App.config ファイルでは、データベース接続文字列が connectionString に指定されているか、または usingSql に設定された appSettings false 値によりデータベースとの対話が無効になっています。
ソリューションの C# 版または Visual Basic .NET 版をビルドするには、「 Building the Windows Communication Foundation Samples」の手順に従います。
単一または複数コンピューター構成でサンプルを実行するには、「Windows Communication Foundation サンプルの実行」の手順に従います。

サンプルを別のコンピューターで実行する場合は、Microsoft 分散トランザクションコーディネーター (MSDTC) を構成してネットワークトランザクションフローを有効にし、WsatConfig.exe ツールを使用して Windows Communication Foundation (WCF) トランザクションネットワークサポートを有効にする必要があります。

分散トランザクションコーディネータ (MSDTC) を構成してサンプルを別のコンピュータで実行できるようにするには

サービスコンピューターで、受信ネットワークトランザクションを許可するように MSDTC を構成します。
1. [スタート] ボタンをクリックし、 [コントロールパネル] 、 [管理ツール] の順にポイントしてから、 [コンポーネントサービス] をクリックします。
2. [マイコンピューター] を右クリックし、 [プロパティ] を選択します。
3. [MSDTC] タブの [セキュリティの構成] をクリックします。
4. [ネットワーク DTC アクセス] および [受信を許可する] チェックボックスをオンにします。
5. [はい] をクリックして MS DTC サービスを再起動した後、 [OK] をクリックします。
6. [OK] をクリックしてダイアログボックスを閉じます。
サービスコンピューターおよびクライアントコンピューターで、Windows ファイアウォールを構成します。例外アプリケーションのリストに、Microsoft 分散トランザクションコーディネーター (MSDTC) を追加します。
1. Windows ファイアウォールアプリケーションをコントロールパネルから実行します。
2. [例外] タブの [プログラムの追加] をクリックします。
3. C:\WINDOWS\System32 フォルダーに移動します。
4. Msdtc.exe を選択して [開く] をクリックします。
5. [OK] をクリックして [プログラムの追加] ダイアログボックスを閉じ、 [OK] をもう一度クリックして Windows ファイアウォールアプレットを閉じます。
クライアントコンピューターで、送信ネットワークトランザクションを許可するよう MSDTC を構成します。
1. [スタート] ボタンをクリックし、 [コントロールパネル] 、 [管理ツール] の順にポイントしてから、 [コンポーネントサービス] をクリックします。
2. [マイコンピューター] を右クリックし、 [プロパティ] を選択します。
3. [MSDTC] タブの [セキュリティの構成] をクリックします。
4. [ネットワーク DTC アクセス] および [送信を許可する] チェックボックスをオンにします。
5. [はい] をクリックして MS DTC サービスを再起動した後、 [OK] をクリックします。
6. [OK] をクリックしてダイアログボックスを閉じます。

次の方法で共有

サービストランザクションの動作

サンプルをセットアップ、ビルド、および実行するには

分散トランザクションコーディネータ (MSDTC) を構成してサンプルを別のコンピュータで実行できるようにするには

その他のリソース

次の方法で共有

サービス トランザクションの動作

サンプルをセットアップ、ビルド、および実行するには

分散トランザクション コーディネータ (MSDTC) を構成してサンプルを別のコンピュータで実行できるようにするには

その他のリソース

サービストランザクションの動作

分散トランザクションコーディネータ (MSDTC) を構成してサンプルを別のコンピュータで実行できるようにするには