虽然WCF负责事务传播及两阶段提交协议的管理工做,可是 她不知道事务是否应该提交或终止。这须要根服务告诉WCF应该什么时候启动两阶段提交协议、是提交仍是终止。WCF提供了两种编程模式来对事务的结果进行投票,即声明式和显式模式。编程
声明式投票
WCF能够代替服务自动完成提交或终止事务的投票。自动投票是经过OpreationBehavior的TransactionAutoComplete属性来控制的。ui
TransactionAutoComplete属性的默认值为true,能够以下使用:spa
//服务端代码必须置于服务中执行 [OperationBehavior(TransactionScopeRequired = true,
TransactionAutoComplete=true)] public void CSMethod() { //获取当前事务对象 Transaction transaction = Transaction.Current; }当这个属性设置为true时,若是操做里没有未处理的异常,则WCF将会自动提交事务。若是存在异常,WCF将会投票终止事务。注意,即便WCF必须经过捕获异常来终止事务,它也是会从新抛出异常,以便异常沿着调用链传播。设计
为了依赖自动投票,必须把服务的TransactionScopeRequired 属性设置为true,由于自动投票只有在WCF为服务设置了事务环境时才有用。code
在TransactionScopeRequired设置为true时,要尽可能避免捕获和处理异常,显式避免终止事务。对象
//服务端代码必须置于服务中执行 [OperationBehavior(TransactionScopeRequired = true)] public void CSMethod() { try { ... } catch { Transactionn.Current.Rollback(); } }虽然服务捕获了一次异常,但操做仍会引起异常,这是由于WCF会在客户端抛出现像AbortedException同样的异常。WCF是会这样作 的,由于服务也许是包含多个服务、机器和站点事务的一部分。blog
明确投票
当TransactionAutoComplete设置为false时,须要使用明确投票。事件
当禁止声明式投票时,默认状况下,不管是否发生异常,WCF将会自动终止全部的事务,你须要明确使用操做上下文的SetTransactionComplete()方法来提交事务。事务
public sealed class OperationContext : IExtensibleObject<OperationContext> { //...... // 摘要: // 提交当前正在执行的事务。 // // 异常: // System.InvalidOperationException: // 上下文中没有任何事务。 public void SetTransactionComplete(); }确保在调用SetTransactionComplete()以后没有再执行任何操做,特别是事务性工做。资源
[OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete=false)] public void CSMethod() { try { OperationContext.Current.SetTransactionComplete(); } catch (Exception) { throw; } }若是调用后尝试执行任何事务性工做,即便访问OperationContext.Current,WCF就会抛出相关的异常并终止事务。
明确投票是为投票须要依赖其它信息(包括异常和错误)的状况而设计的。可是,对于大部分应用程序与服务来讲,应该选择简单的声明式投票方式。
终止事务
事务什么时候结束是由事务发起者决定的。根服务能够调用其它服务并把事务传播给它们。注意,下游服务只能使用对事务投票,不能提交完成事务。只有根事务能够同时投票和提交完成事务。
当非事务型客户端发起事务时,事务会在客户销毁事务对象时结束。
当事务试图访问其它事务占有的资源管理器且须要占用好久时可能会发生死锁。为了解决这个问题,事务必须可以在必定的超时事件(默认60s)内自动终止事务。一旦终止事务,任何传播事务到服务的操做都会致使异常。
超时的服务行为属性,并且服务上的全部终结点的全部操做使用相同的超时事件。能够经过ServiceBehaviorAttribute的TransactionTimeout属性来设置超时时间。
例如,下面设计30s超时的代码:
[ServiceBehavior(TransactionTimeout="00:00:30")] public class ClientServiceTransaction : IClientServiceTransaction {......}也能够在宿主配置文件里经过定义服务的自定义行为来配置事务超时事件。
...... <behaviors> <serviceBehaviors> <behavior> <serviceMetadata httpGetEnabled="false" httpsGetEnabled="false"/> <serviceDebug includeExceptionDetailInFaults="true"/> <serviceTimeouts transactionTimeout="00:00:30"/> </behavior> </serviceBehaviors> </behaviors> ......以上事务超时的最大值为10min。能够经过机器配置文件来指定超过10分钟的最大值,如40分钟,如下是对machine.config的配置:
...... <system.transactions> <mechineSettings maxTimeout = "00:40:00"/> </system.transactions> ......