WCF RESTful Service      Interview Questions         WCF Bindings             WCF Tracing                              

Tuesday, July 3, 2012

5 Simple Steps to Enable Transactions in WCF

Transaction is basically a logical unit of work comprising of activities that all needed to be succeeded or failed, and also it must be compliant with ACID principals.

Movement of money from a bank account to another is a simple example of a transaction. In this single transaction, two operations will be performed. One account will be debited (amount will be
taken from) and other will be credited (amount will be deposited).

Enabling transactions in Windows Communication Foundation is simple and straight forward but implementation sometimes becomes difficult depending upon the scenario. For example, implementing transactions in a distributed environment will definitely require effort and more things to consider.

Now, consider we already have developed a WCF service and we wanted to enable transactions on it. So, we will follow the steps below:

  1. Add System.Transactions namespace to WCF Service project.
  2. Set TransactionFlow property of the OperationContract attribute to Mandatory.
    Available options for TransactionFlow are:
    a. Mandatory - transaction must be flowed
    b. Allowed - transaction may be flowed
    c. Not Allowed - transaction is not flowed

    For example, our WCF service contract as follows:

    [TransactionFlow(TransactionFlowOptions.Mandatory]
    void MyMethod();

  3. Now, set the OperationBehavior attribute for the implementing method.

    [OperationBehavior(TransactionScopeRequired=true, TransactionAutoComplete=true)]
    void MyMethod()
    {
    }

    TransactionScopeRequired = true means it can only be called in a transaction.
    TransactionAutoComplete = true means that if the operation completes successfully, transaction will be committed.

  4. Enable Transactions for WCF Binding being used.
    For Example, In our configuration file bindings will be as follows:

    <bindings>
      <wsHttpBinding>
         <binding name=”httpBinding”  transactionFlow=”true” />
      </ wsHttpBinding >
    </bindings>

    Remember that we must choose a binding that supports transactions i.e. netTcpBinding, netNamedPipeBinding, wsHttpBinding, wsDualHttpBinding, and wsFederationHttpBinding.
  5. Need to start the transaction from client as:

    using System.Transaction;
    Using( var transScope = new TransactionScope())
    {   

         //Calling service methods
         IMyServiceClient client = new IMyServiceClient();
         client.MyMethod();
        
         transScope.complete();
       
    }

Optionally, If we wanted to specify the Isolation level for the transaction, we can add serviceBehavior attribute to implementing class as follows:

[ServiceBehavior(TransactionIsolationLevel=System.Transaction.IsolationLevel.Serializable)]
Public class MyService : IMyService{}

This is all we need to do for enabling transactions in WCF.
There are few more things regarding "Service Instancing and Sessions" that need to be considered while working with Transactions but this basic WCF tutorial is more focused on enabling transactions in simple scenario. In my later WCF article on Windows Communication Foundation Transactions on this blog, I'll discuss those concepts in more details.

Be social and share with others via:


.NET Jobs from Indeed
Reader of this article might also be interested in:

By Imran Abdul Ghani
Software Developer (Senior)
United Arab Emirates
Imran Abdul Ghani is working as Software Developer(Senior) with extensive knowledge in Web development technologies especially C#, ASP.NET, MVC, WCF, Web API, ADO.NET Entity Framework, jQuery etc. He has several years of experience in designing/developing enterprise level applications. He is Microsoft Certified Solution Developer for .NET (MCSD.NET) since 2005. You can reach his blogging at www.webdevelopmenthelp.net & www.topwcftutorials.net.

1 comment:

  1. Hello,

    Nice.it is helpful for beginners .
    Thanks for providing such a good article...

    ReplyDelete