Programming WCF Services翻译笔记（八）
本文在IT168已发表：http://tech.it168.com/msoft/2007-10-25/200710251312468.shtml
分步操作
WCF提供了一种被称之为分步操作（Demarcating Operation）的方法，以应对服务契约的操作需要指定执行顺序的情况。分步操作是使用OperationContract特性的IsInitiating和IsTerminating属性：
[AttributeUsage(AttributeTargets.Method)]
public sealed class OperationContractAttribute : Attribute
{
public bool IsInitiating
{get;set;}
public bool IsTerminating
{get;set;}
//More members
}
一个分步操作的应用如下：
[ServiceContract(SessionMode = SessionMode.Required)]
interface IOrderManager
{
[OperationContract]
void SetCustomerId(int customerId);
[OperationContract(IsInitiating = false)]
void AddItem(int itemId);
[OperationContract(IsInitiating = false)]
decimal GetTotal( );
[OperationContract(IsInitiating = false,IsTerminating = true)]
bool ProcessOrders( );
}
此时，操作AddItem()、GetTotal()以及ProcessOrder()都不能是启动会话的第一个操作。同时，ProcessOrder()操作则会成为终止会话的操作。这与业务的要求是一脉相承的。
IsInitiating属性的默认值为true，IsTerminating属性的默认值则为false。
如果IsInitiating值为true，并不必然代表该操作必然是启动会话的第一个操作。如果其它相同设置的操作首先被调用，就会启动一个会话，而原操作则在调用时被加入会话，成为会话的一部分。但如果IsTermination的值为true，则代表该操作必须是终止会话的操作。虽然在服务契约定义时，允许将多个操作的IsTerminating值设置为true，但一旦调用了IsTerminating值为true的方法，就不能再调用服务实例的其它方法，除非在客户端重新创建一个代理对象。此外，即使操作的IsTermination值为true，它也可以是启动会话的第一个操作，但在操作执行后它会终止会话。因此，如下的两个操作定义是等效的：
[OperationContract(IsTerminating = true)]
void StartAndEndSession();
[OperationContract(IsInitiating=true, IsTerminating = true)]
void StartAndEndSession();
然而，如下的两个操作则是不等效的，因为后者要求该操作不能为启动会话的第一个操作：
[OperationContract(IsTerminating = true)]
void StartAndEndSession();
[OperationContract(IsInitiating=false, IsTerminating = true)]
void StartAndEndSession();
实例停用（Instance Deactivation）
实例停用只针对会话服务而言。单例服务虽然也可以应用，但却无效。
“会话实际要做的不仅是关联客户端消息，同时还要关联托管了服务的上下文。启动会话时，宿主会创建一个新的上下文。会话终止时，上下文也随之而终止。默认情况下，上下文的生命周期与发布的服务实例的生命周期相同。然而，出于优化的目的，WCF为服务设计者提供了一个分离两种生命周期的选项，该选项允许WCF独立地停用实例，而不必依赖于它的上下文。实际上，WCF还允许不包含实例的上下文存在，如下图所示。”
这种实例管理技术称为上下文停用（Context Deactivation）。控制上下文停用的最常见办法是通过OperationBehavior特性的ReleaseInstanceMode属性：
public enum ReleaseInstanceMode
{
None,
BeforeCall,
AfterCall,
BeforeAndAfterCall,
}
[AttributeUsage(AttributeTargets.Method)]
public sealed class OperationBehaviorAttribute : Attribute,...
{
public ReleaseInstanceMode ReleaseInstanceMode
{get;set;}
//More members
}
“通常，我们只需要将实例停用应用到部分服务方法上，而不是全部方法；或者为不同的方法设置不同的值。”例如：
class MyService : IMyContract,IDisposable
{
[OperationBehavior(ReleaseInstanceMode = ReleaseInstanceMode.AfterCall)]
public void MyMethod( )
{...}
public void MyOtherMethod( )
{...}
public void Dispose( )
{...}
}
ReleaseInstanceMode属性的默认值为ReleaseInstanceMode.None。关于ReleaseInstanceMode属性值，以下四张图片足以说明它们的工作方式：
ReleaseInstanceMode.None
ReleaseInstanceMode.BeforeCall
ReleaseInstanceMode.AfterCall
ReleaseInstanceMode.BeforeAndAfterCall
准确地选择ReleaseInstanceMode，可以有效地提高系统的性能，优化内存以及资源的利用。
除了可以通过应用OperationBehaviorAttribute应用ReleaseInstanceMode，也可以通过编程方式在服务的操作中显式地完成对实例的停止。方法是利用InstanceContext的ReleaseServiceInstance()方法：
class MyService : IMyContract,IDisposable
{
public void MyMethod( )
{
//Do some work then
OperationContext.Current.InstanceContext.ReleaseServiceInstance( );
}
public void Dispose( )
{...}
}
这两种实现实例停止的方式还可以结合使用，例如在应用了OperationBehavior特性，并将ReleaseInstanceMode设置为BeforeCall的方法中，如果显式调用ReleaseServiceInstance()方法，其效果就相当于将ReleaseInstanceMode设置为BeforeAndAfterCall。
限流（Throttling）
限流“允许开发者限制客户端连接数以及服务的负荷。限流可以避免服务的最大化，以及分配与使用重要资源的最大化。引入限流技术后，一旦超出配置的设置值，WCF就会自动地将等待处理的调用者放入到队列中，然后依次从队列中取出。在队列中等待处理调用时，如果客户端的调用超时，客户端就会获得一个TimeoutException异常。每个服务类型都可以应用限流技术，也就是说，它会影响到服务的所有实例以及服务类型的所有终结点。实现方式是为限流与服务使用的每个通道分发器建立关联。”
限流由ServiceThrottlingBehavior类定义，包括三个重要的属性：MaxConcurrentCalls、MaxConcurrentSessions、MaxConcurrentInstances，它们分别的默认值为16，10和Int.MaxValue。
在翻译过程中，我在查阅MSDN时，发现MaxConcurrentSessions的默认值为64，这让我感觉很奇怪，莫非作者在这里出现了错误。然而经过我仔细地查阅相关资料，发现在WCF的早期版本中，MaxConcurrentSessions的默认值确实为64，但在2006年6月的CTP版本中已经被修改为16。
设置限流值可以通过配置文件，也可以通过编码方式。前者例如：
<system.serviceModel>
<services>
<service name = "MyService" behaviorConfiguration = "ThrottledBehavior">
...
</service>
</services>
<behaviors>
<serviceBehaviors>
<behavior name = "ThrottledBehavior">
<serviceThrottling
maxConcurrentCalls = "12"
maxConcurrentSessions = "34"
maxConcurrentInstances = "56"
/>
</behavior>
</serviceBehaviors>
</behaviors>
</system.serviceModel>
WCF并没有提供关于限流的特性。但实现该特性的方法非常简单，如下内容是我定义的关于限流的特性，本书并没有提供：
public class ServiceThrottlingAttribute : Attribute, IServiceBehavior
{
private ServiceThrottlingBehavior throttle;
public ServiceThrottlingAttribute(
int maxConcurrentCalls,
int maxConcurrentInstances,
int maxConcurrentSessions)
{
this.throttle = new ServiceThrottlingBehavior();
throttle.MaxConcurrentCalls = maxConcurrentCalls;
throttle.MaxConcurrentInstances = maxConcurrentInstances;
throttle.MaxConcurrentSessions = maxConcurrentSessions;
}
#region IServiceBehavior Members
void IServiceBehavior.AddBindingParameters(ServiceDescription serviceDescription,
ServiceHostBase serviceHostBase,
System.Collections.ObjectModel.Collection<ServiceEndpoint> endpoints,
System.ServiceModel.Channels.BindingParameterCollection bindingParameters)
{ }
void IServiceBehavior.ApplyDispatchBehavior(ServiceDescription serviceDescription,
ServiceHostBase serviceHostBase)
{
ServiceThrottlingBehavior currentThrottle = serviceDescription.Behaviors.Find<ServiceThrottlingBehavior>();
if (currentThrottle == null)
{
serviceDescription.Behaviors.Add(this.throttle);
}
}
void IServiceBehavior.Validate(ServiceDescription serviceDescription,
ServiceHostBase serviceHostBase)
{ }
#endregion
}
定义的ServiceThrottlingAttribute特性继承了Attribute，并实现了IServiceBehavior接口。在特性内，则使用了ServiceThrottlingBehavior类，以设置限流的相关值。如果要配置服务的限流值，就可以应用该特性，例如：
[ServiceThrottling(12, 34, 56)]
class MyService : IMyContract,IDisposable
{
public void MyMethod( )
{
ChannelDispatcher dispatcher = OperationContext.Current.Host.ChannelDispatchers[0] as ChannelDispatcher;
ServiceThrottle serviceThrottle = dispatcher.ServiceThrottle;
Trace.WriteLine("MaxConcurrentCalls = " + serviceThrottle.MaxConcurrentCalls);
Trace.WriteLine("MaxSessions = " + serviceThrottle.MaxConcurrentSessions);
Trace.WriteLine("MaxInstances = " + serviceThrottle.MaxConcurrentInstances);
}
}
则输出结果为：
MaxConcurrentCalls = 12
MaxSessions = 56
MaxInstances = 34
分步操作
WCF提供了一种被称之为分步操作（Demarcating Operation）的方法，以应对服务契约的操作需要指定执行顺序的情况。分步操作是使用OperationContract特性的IsInitiating和IsTerminating属性：
[AttributeUsage(AttributeTargets.Method)]
public sealed class OperationContractAttribute : Attribute
{
public bool IsInitiating
{get;set;}
public bool IsTerminating
{get;set;}
//More members
}
一个分步操作的应用如下：
[ServiceContract(SessionMode = SessionMode.Required)]
interface IOrderManager
{
[OperationContract]
void SetCustomerId(int customerId);
[OperationContract(IsInitiating = false)]
void AddItem(int itemId);
[OperationContract(IsInitiating = false)]
decimal GetTotal( );
[OperationContract(IsInitiating = false,IsTerminating = true)]
bool ProcessOrders( );
}
此时，操作AddItem()、GetTotal()以及ProcessOrder()都不能是启动会话的第一个操作。同时，ProcessOrder()操作则会成为终止会话的操作。这与业务的要求是一脉相承的。
IsInitiating属性的默认值为true，IsTerminating属性的默认值则为false。
如果IsInitiating值为true，并不必然代表该操作必然是启动会话的第一个操作。如果其它相同设置的操作首先被调用，就会启动一个会话，而原操作则在调用时被加入会话，成为会话的一部分。但如果IsTermination的值为true，则代表该操作必须是终止会话的操作。虽然在服务契约定义时，允许将多个操作的IsTerminating值设置为true，但一旦调用了IsTerminating值为true的方法，就不能再调用服务实例的其它方法，除非在客户端重新创建一个代理对象。此外，即使操作的IsTermination值为true，它也可以是启动会话的第一个操作，但在操作执行后它会终止会话。因此，如下的两个操作定义是等效的：
[OperationContract(IsTerminating = true)]
void StartAndEndSession();
[OperationContract(IsInitiating=true, IsTerminating = true)]
void StartAndEndSession();
然而，如下的两个操作则是不等效的，因为后者要求该操作不能为启动会话的第一个操作：
[OperationContract(IsTerminating = true)]
void StartAndEndSession();
[OperationContract(IsInitiating=false, IsTerminating = true)]
void StartAndEndSession();
实例停用（Instance Deactivation）
实例停用只针对会话服务而言。单例服务虽然也可以应用，但却无效。
“会话实际要做的不仅是关联客户端消息，同时还要关联托管了服务的上下文。启动会话时，宿主会创建一个新的上下文。会话终止时，上下文也随之而终止。默认情况下，上下文的生命周期与发布的服务实例的生命周期相同。然而，出于优化的目的，WCF为服务设计者提供了一个分离两种生命周期的选项，该选项允许WCF独立地停用实例，而不必依赖于它的上下文。实际上，WCF还允许不包含实例的上下文存在，如下图所示。”
这种实例管理技术称为上下文停用（Context Deactivation）。控制上下文停用的最常见办法是通过OperationBehavior特性的ReleaseInstanceMode属性：
public enum ReleaseInstanceMode
{
None,
BeforeCall,
AfterCall,
BeforeAndAfterCall,
}
[AttributeUsage(AttributeTargets.Method)]
public sealed class OperationBehaviorAttribute : Attribute,...
{
public ReleaseInstanceMode ReleaseInstanceMode
{get;set;}
//More members
}
“通常，我们只需要将实例停用应用到部分服务方法上，而不是全部方法；或者为不同的方法设置不同的值。”例如：
class MyService : IMyContract,IDisposable
{
[OperationBehavior(ReleaseInstanceMode = ReleaseInstanceMode.AfterCall)]
public void MyMethod( )
{...}
public void MyOtherMethod( )
{...}
public void Dispose( )
{...}
}
ReleaseInstanceMode属性的默认值为ReleaseInstanceMode.None。关于ReleaseInstanceMode属性值，以下四张图片足以说明它们的工作方式：
ReleaseInstanceMode.None
ReleaseInstanceMode.BeforeCall
ReleaseInstanceMode.AfterCall
ReleaseInstanceMode.BeforeAndAfterCall
准确地选择ReleaseInstanceMode，可以有效地提高系统的性能，优化内存以及资源的利用。
除了可以通过应用OperationBehaviorAttribute应用ReleaseInstanceMode，也可以通过编程方式在服务的操作中显式地完成对实例的停止。方法是利用InstanceContext的ReleaseServiceInstance()方法：
class MyService : IMyContract,IDisposable
{
public void MyMethod( )
{
//Do some work then
OperationContext.Current.InstanceContext.ReleaseServiceInstance( );
}
public void Dispose( )
{...}
}
这两种实现实例停止的方式还可以结合使用，例如在应用了OperationBehavior特性，并将ReleaseInstanceMode设置为BeforeCall的方法中，如果显式调用ReleaseServiceInstance()方法，其效果就相当于将ReleaseInstanceMode设置为BeforeAndAfterCall。
限流（Throttling）
限流“允许开发者限制客户端连接数以及服务的负荷。限流可以避免服务的最大化，以及分配与使用重要资源的最大化。引入限流技术后，一旦超出配置的设置值，WCF就会自动地将等待处理的调用者放入到队列中，然后依次从队列中取出。在队列中等待处理调用时，如果客户端的调用超时，客户端就会获得一个TimeoutException异常。每个服务类型都可以应用限流技术，也就是说，它会影响到服务的所有实例以及服务类型的所有终结点。实现方式是为限流与服务使用的每个通道分发器建立关联。”
限流由ServiceThrottlingBehavior类定义，包括三个重要的属性：MaxConcurrentCalls、MaxConcurrentSessions、MaxConcurrentInstances，它们分别的默认值为16，10和Int.MaxValue。
在翻译过程中，我在查阅MSDN时，发现MaxConcurrentSessions的默认值为64，这让我感觉很奇怪，莫非作者在这里出现了错误。然而经过我仔细地查阅相关资料，发现在WCF的早期版本中，MaxConcurrentSessions的默认值确实为64，但在2006年6月的CTP版本中已经被修改为16。
设置限流值可以通过配置文件，也可以通过编码方式。前者例如：
<system.serviceModel>
<services>
<service name = "MyService" behaviorConfiguration = "ThrottledBehavior">
...
</service>
</services>
<behaviors>
<serviceBehaviors>
<behavior name = "ThrottledBehavior">
<serviceThrottling
maxConcurrentCalls = "12"
maxConcurrentSessions = "34"
maxConcurrentInstances = "56"
/>
</behavior>
</serviceBehaviors>
</behaviors>
</system.serviceModel>
WCF并没有提供关于限流的特性。但实现该特性的方法非常简单，如下内容是我定义的关于限流的特性，本书并没有提供：
public class ServiceThrottlingAttribute : Attribute, IServiceBehavior
{
private ServiceThrottlingBehavior throttle;
public ServiceThrottlingAttribute(
int maxConcurrentCalls,
int maxConcurrentInstances,
int maxConcurrentSessions)
{
this.throttle = new ServiceThrottlingBehavior();
throttle.MaxConcurrentCalls = maxConcurrentCalls;
throttle.MaxConcurrentInstances = maxConcurrentInstances;
throttle.MaxConcurrentSessions = maxConcurrentSessions;
}
#region IServiceBehavior Members
void IServiceBehavior.AddBindingParameters(ServiceDescription serviceDescription,
ServiceHostBase serviceHostBase,
System.Collections.ObjectModel.Collection<ServiceEndpoint> endpoints,
System.ServiceModel.Channels.BindingParameterCollection bindingParameters)
{ }
void IServiceBehavior.ApplyDispatchBehavior(ServiceDescription serviceDescription,
ServiceHostBase serviceHostBase)
{
ServiceThrottlingBehavior currentThrottle = serviceDescription.Behaviors.Find<ServiceThrottlingBehavior>();
if (currentThrottle == null)
{
serviceDescription.Behaviors.Add(this.throttle);
}
}
void IServiceBehavior.Validate(ServiceDescription serviceDescription,
ServiceHostBase serviceHostBase)
{ }
#endregion
}
定义的ServiceThrottlingAttribute特性继承了Attribute，并实现了IServiceBehavior接口。在特性内，则使用了ServiceThrottlingBehavior类，以设置限流的相关值。如果要配置服务的限流值，就可以应用该特性，例如：
[ServiceThrottling(12, 34, 56)]
class MyService : IMyContract,IDisposable
{
public void MyMethod( )
{
ChannelDispatcher dispatcher = OperationContext.Current.Host.ChannelDispatchers[0] as ChannelDispatcher;
ServiceThrottle serviceThrottle = dispatcher.ServiceThrottle;
Trace.WriteLine("MaxConcurrentCalls = " + serviceThrottle.MaxConcurrentCalls);
Trace.WriteLine("MaxSessions = " + serviceThrottle.MaxConcurrentSessions);
Trace.WriteLine("MaxInstances = " + serviceThrottle.MaxConcurrentInstances);
}
}
则输出结果为：
MaxConcurrentCalls = 12
MaxSessions = 56
MaxInstances = 34
