WCF服务端运行时架构体系详解[续篇]
终结点分发器在自己的运行时中对请求消息的处理最终肯定体现在相应操作的执行。如果从服务描述的角度来看,操作是一个OperationDescription对象。而服务端分发运行时中的操作则代表的是一个DispatchOperation对象。作为服务描述的一部分,服务所有终结点的所有操作描述(OperationDescription)在ServiceHost创建过程中被创建。而当ServiceHost被正常开始时,这些操作描述最终转换成分发操作(DispatchOperation)。而DispatchRuntime的Operations属性代表了对应终结点的所有分发操作。
目录:
一、序列化与反序列
二、调用上下文初始化
三、参数的检验
四、服务实例的释放
五、事务
六、操作的执行
七、参数和返回值的释放
八、身份模拟
总结
接下来,我们同样从可扩展的角度来分析DispatchOperation,下面的代码片断列出了所有可供扩展的属性。
{
//序列化与反序列化
public bool DeserializeRequest { get; set; }
public bool SerializeReply { get; set; }
public SynchronizedCollection<FaultContractInfo> FaultContractInfos { get; }
public IDispatchMessageFormatter Formatter { get; set; }
//执行上下文初始化
public SynchronizedCollection<ICallContextInitializer> CallContextInitializers { get; }
//参数检验
public SynchronizedCollection<IParameterInspector> ParameterInspectors { get; }
//服务实例释放
public bool ReleaseInstanceAfterCall { get; set; }
public bool ReleaseInstanceBeforeCall { get; set; }
//事务
public bool TransactionAutoComplete { get; set; }
public bool TransactionRequired { get; set; }
//操作执行
public IOperationInvoker Invoker { get; set; }
//参数/返回值的释放
public bool AutoDisposeParameters { get; set; }
//身份模拟
public ImpersonationOption Impersonation { get; set; }
}
一、序列化与反序列
我们所示的服务操作的执行最终体现在执行服务实例的某个相应的操作方法。而调用方法需要传入参数,而参数是一个个实实在在的基于某种类型的对象。但是在这之前,所有的服务调用信息被封装在消息中(对应于Message对象)。那么,在真正执行方法调用之前首要的任务就是从请求消息中提取相应的信息并将其反序列化成方法的输入参数。在另一方面,当操作方法被正确执行后,执行的结果通过方法的返回值(或者ref/out参数)来体现。如果要将执行结果正确地回复给客户端,需要将它们进行序列化成消息。
如果你阅读了《WCF技术剖析(卷1)》第5章《序列化与数据契约》,你应该很清楚WCF通过一个被称为消息格式化器(MessageFormatter)组件来完成序列化和反序列化工作。对于服务端来说,这个消息格式化器被称为分发消息格式化器(DispatchMessageFormatter),它实现了一个具有如下定义的System.ServiceModel.Dispatcher.IDispatchMessageFormatter接口。两个方法分别用于对请求消息的反序列化和对回复消息的序列化。
{
void DeserializeRequest(Message message, object[] parameters);
Message SerializeReply(MessageVersion messageVersion, object[] parameters, object result);
}
此外,与序列化相关的还具有两个布尔类型的属性DeserializeRequest和SerializeReply。从语义上我们都知道,它们分别表示是否需要进行请求消息的反序列化和回复消息的序列化。只所有要为DispatchOperation定义如此两个属性,原因在于消息的序列化反序列化并不是在任何情况下都是需要的。比如,如果操作方法具有一个唯一的类型为Message的参数,那么对请求消息的反序列化是不需要的。同理,如果操作方法的返回值(并且没有ref/out参数)类型为Message,那么就不需要进行对回复消息的序列化。
上面介绍的都是基于正常服务调用情况下的序列化和反序列化。如果异常出现,我们可以针对定义在操作上的错误契约(Fault Contract)抛出FaultException<TDetail>异常。为了顺利完成针对该异常消息信息(TDetail类型对象),需要预先确定必要的错误契约相关的信息。这些辅助性信息被风转在一个FaultContractInfo对象中,而DispatchOperation的FaultContractInfos表示与该操作所有错误契约相关的FaultContractInfo集合。
二、调用上下文初始化
每个DispatchOperation都有一个以属性CallContextInitializers表示的调用上下文初始化器(CallContextInitializer)列表。每个CallContextInitializer都实现了具有如下定义的接口ICallContextInitializer。
{
void AfterInvoke(object correlationState);
object BeforeInvoke(InstanceContext instanceContext, IClientChannel channel, Message message);
}
当目标操作方法执行前后,列表中每个CallContextInitializer的BeforeInvoke和AfterInvoke方法分别被调用,用以实现针对操作方法执行环境的初始化和清理工作。其中BeforeInvoke的返回值会被传到AfterInvoke方法中作为输入参数(correlationState)。
举个例子,在《WCF技术剖析(卷1)》的第10章,我分别采用自定义ClientMessageInspector和CallContextInitializer实现了上下文信息从客户端到服务端的自动传播。其中ClientMessageInspector用于上下文信息的发送,而CallContextInitializer用于上下文信息的接收和设置。在接下来的部分,我们还将演示如何利用这两个组件(ClientMessageInspector和CallContextInitializer)实现另一个应用场景:让服务操作执行线程的语言文化与客户但保持一致。
三、参数的检验
参数的检验涉及到另一个重要的组件,即参数检验器(ParameterInspector),它实现了一个具有如下定义的接口IParameterInspector。每个DispatchOperation具有一个ParameterInspector列表,通过属性ParameterInspectors表示。
{
void AfterCall(string operationName, object[] outputs, object returnValue, object correlationState);
object BeforeCall(string operationName, object[] inputs);
}
我们通常通过自定义ParameterInspector的方式实现操作执行前对输入参数的检验,以及操作执行后对返回值/输出参数的检验。举个例子,微软的企业库(Enterprise Library)具有验证应用程序块(Validation Application Block)。这是一个非常不错的用于数据实体验证的框架,它允许你可以单独定义针对某个实体类型的验证策略。它提供了于WCF的集成,使我们可以将这些独立的验证策略通过声明或者配置的方式应用到相应的操作上,最终实现自动的参数验证。而最终完成验证的就是自定义的ParameterInspector。
四、服务实例的释放
包含有服务实例释放的时机涉及到DispatchOperation的两个属性ReleaseInstanceBeforeCall和ReleaseInstanceAfterCall。前者表明在服务操作之前释放现有的实例并创建新的实例。后者这表示服务实例会在服务操作执行后被释放。服务实例的释放通过调用InstanceContext的ReleaseServiceInstance方法,而该方法一般来说会在最终调用之前介绍的InstanceProvider的ReleaseInstance方法。
{
//其他成员
public void ReleaseServiceInstance();
}
public interface IInstanceProvider
{
//其他成员
void ReleaseInstance(InstanceContext instanceContext, object instance);
}
public sealed class OperationBehaviorAttribute : Attribute, IOperationBehavior
{
//其他成员
public ReleaseInstanceMode ReleaseInstanceMode { get; set; }
}
public enum ReleaseInstanceMode
{
None,
BeforeCall,
AfterCall,
BeforeAndAfterCall
}
五、事务
DispatchOperation的两个布尔类型的属性TransactionRequired和TransactionAutoComplete是与事务相关。前者表示当前的操作是否应该在事务中执行,后者表示当操作执行之后是否自动提交事务。我们可以通过操作行为OperationBehaviorAttribute的TransactionScopeRequired和TransactionAutoComplete属性来控制它们。
public sealed class OperationBehaviorAttribute : Attribute, IOperationBehavior
{
//其他成员
public bool TransactionAutoComplete { get; set; }
public bool TransactionScopeRequired { get; set; }
}
六、操作的执行
操作的执行最终落在了一个被称为操作执行器(OperationInvoker)的组件上。OperationInvoker实现了具有如下定义的IOperationInvoker接口。操作具有两种不同的执行方法,即同步和异步。通过操作执行实现在Invoke方法中,而InvokeBegin/InvokeEnd则用于实现异步执行。方法中的输入参数instance和inputs分别表示用于通过InstanceProvider提供的服务实例,以及通过MessageFormatter对请求消息进行反序列化生成的输入参数。而Invoke和InvokeEnd的返回值和输出参数(outputs)表示操作执行后得到的结果。
{
object[] AllocateInputs();
object Invoke(object instance, object[] inputs, outobject[] outputs);
IAsyncResult InvokeBegin(object instance, object[] inputs, AsyncCallback callback, object state);
object InvokeEnd(object instance, outobject[] outputs, IAsyncResult result);
bool IsSynchronous { get; }
}
WCF提供两个内部(Internal)的OperationInvoker分别实现了操作的同步和异步实现,它们分别是SyncMethodInvoker和AsyncMethodInvoker。它们的实现原理其实很简单,就是采用反射的方式调用相应的操作方法。具体来说,SyncMethodInvoker和AsyncMethodInvoker通过调用操作描述(OperationDescription)的SyncMethod和BeginMethod/EndMethod实现了对操作的同步和异步调用。
{
//其他成员
public MethodInfo BeginMethod { get; set; }
public MethodInfo EndMethod { get; set; }
public MethodInfo SyncMethod { get; set; }
}
七、参数和返回值的释放
当服务操作成功执行,并且执行的结果被序列化到回复消息中,无论是作为参数的对象还是作为返回值的对象都变成了“垃圾对象”。在正常的情况下,它们最终会被垃圾回收。但是,如果这些对象引用一些需要释放的资源,就有可能造成内存泄露。
我们应该很清楚,我们在设计这种类型的时候,一般会实现IDisposable接口,并将资源释放操作实现在Dispose方法中。而DispatchOperation的AutoDisposeParameters属性决定了对于实现了IDisposable接口的类型的参数和返回值,是否需要最终调用它们的Dispose方法。
我们可以通过操作行为OperationBehaviorAttribute的同名属性控制DispatchOperation的AutoDisposeParameters属性值。在默认的情况下,DispatchOperation的AutoDisposeParameters属性为True。如果你希望直接避免参数和返回值的释放操作,你可以通过该特性将属性设置为False。
public sealed class OperationBehaviorAttribute : Attribute, IOperationBehavior
{
//其他成员
public bool AutoDisposeParameters { get; set; }
}
八、身份模拟
最后一个类型为ImpersonationOption类型的属性Impersonation在《模拟在WCF中的应用》已经详细介绍过了,用以表示是否在模拟客户端身份上下文中执行服务操作。它对应操作行为OperationBehaviorAttribute的同名属性。
public sealed class OperationBehaviorAttribute : Attribute, IOperationBehavior
{
//其他成员
public ImpersonationOption Impersonation { get; set; }
}
总结
对于一个在分发运行时表示某个具体的服务操作的DispatchOperation对象来说,它的可扩展的核心组件包括CallContextInitializer、ParameterInspector、DispatchMessageFormatter和OperationInvoker。它们在DispatchOperation如下图所示。