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

[アーティクル]
09/17/2008

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

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

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

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

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

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

サンプルを設定、ビルド、および実行するには

SQL Server 2005 Express Edition または SQL Server 2005 がインストールされていることを確認してください。サービスの App.config ファイルでは、データベース接続文字列が connectionString に指定されているか、または false に設定された appSettings usingSql 値によりデータベースとの対話が無効になっています。
ソリューションの C# 版または Visual Basic .NET 版をビルドするには、「Windows Communication Foundation サンプルのビルド」の手順に従います。
単一コンピュータ構成か複数コンピュータ構成かに応じて、「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] をクリックしてダイアログボックスを閉じます。

Footer image

Share via

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

サンプルを設定、ビルド、および実行するには

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

その他のリソース

Share via

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

サンプルを設定、ビルド、および実行するには

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

その他のリソース

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

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