WCF - 实例管理

WCF 用于将一组消息(客户端请求)绑定到服务实例的一组技术称为实例管理。WCF 支持三种类型的实例激活,本章将对此进行讨论。

每次调用服务

每次调用服务是 WCF 的默认实例激活模式。当 WCF 服务配置为每次调用服务时,将为客户端调用或请求正在进行的时间跨度创建一个 CLR 对象。CLR 代表公共语言运行时,它包括 WCF 中的服务实例。

在每次调用服务中,每个客户端请求都会实现一个新的专用服务实例,与其他类型的实例激活相比,其内存消耗较少。

需要将 InstanceContextMode 属性设置为 InstanceContextMode.PerCall,以指示 WCF 服务充当每次调用服务。InstanceContextMode 属性属于 ServiceBehavior 属性。因此,每个调用的服务可以配置如下 −

[ServiceContract]
interface IMyContract
{...}
[ServiceBehavior (InstanceContextMode = InstanceContextMode.PerCall)]
class MyService : IMyContract
{...} 

此处将服务表示为IMyContract。下图显示了每次调用服务实例激活的过程。

Wcf 实例管理每次调用服务

实现每次调用服务

[DataContract]
class Param {....}

[ServiceContract]
interface IMyContract {
   [OperationContract]
   void MyMethod(Param objectIdentifier);
}
class MyPerCallService : IMyContract, IDisposable {
   public void MyMethod(Param objectIdentifier) {
      GetState(objectIdentifier); 
      DoWork();
      SaveState(objectIdentifier);
   }
   
   void GetState(Param objectIdentifier) {....}
   void DoWork() {....}
   void SaveState(Param objectIdentifier) {....}
   public void Dispose() {....}
}

此处,Param 是针对上述示例发明的伪类型参数。

每会话服务

在 WCF 的这种激活模式中,两个实体(即客户端和特定服务实例)之间维持私有或机密会话。每会话服务也称为私有会话服务,它提供一个新的服务实例,该实例专用于每个客户端请求,并且独立于与该会话感知服务相关的所有其他实例。

要启动每会话服务,需要将 InstanceContextMode 属性设置为 PerSession。在这里,服务实例在整个会话期间都保留在内存中。

激活模式的可扩展性受到损害,因为配置的服务无法支持除少数(或可能多达几百个)之外的任何其他未完成客户端,因为每个专用服务实例都涉及成本。

每会话服务可以配置为 −

[ServiceBehavior (InstanceContextMode = InstanceContextMode.PerSession)]
class MyService : IMyContract
{...}

per-session 服务的过程可以如下图所示 − 进行描述

Wcf Instance Management Per Session Service

以下代码显示了为使用私有会话而配置的契约和服务。输出表明客户端确实获得了一个专用服务实例。

服务代码

[ServiceContract(Session = true)]
interface IMyContract {
   [OperationContract]
   void MyMethod();
}

[ServiceBehavior(InstanceContextMode = InstanceContextMode.PerSession)]
class MyService : IMyContract, IDisposable {
   int m_Counter = 0; MyService() {Console.WriteLine("MyService.MyService()"); }
   
   public void MyMethod() {
      m_Counter++;
      Console.WriteLine("Counter = " + m_Counter);
   }
   public void Dispose() { 
      Console.WriteLine("MyService.Dispose()"); 
   }
}

Client Code

MyContractProxy proxy = new MyContractProxy(); proxy.MyMethod(); proxy.MyMethod(); 
proxy.Close();

输出

MyService.MyService() Counter = 1 Counter = 2 MyService.Dispose()

单例服务

在 WCF 的这种激活模式下,所有彼此独立的客户端请求都会连接到同一个已知的单个实例,而不管它们与服务端点的连接如何。只有当主机关闭时,才会释放单例服务。

此服务仅在主机创建时创建一次。如果主机未提供任何单例实例,则服务返回 NULL。当每个方法调用中的工作量很少并且后台没有待处理的操作时,激活模式处于最佳状态。

需要将 InstanceContextMode 属性设置为 InstanceContextMode.Single 才能启动此单例服务。

因此,可以将单例服务配置为−

[ServiceBehavior(InstanceContextMode = InstanceContextMode.Single)]
class MySingleton : ...
{...}

Singleton 服务的过程如下图所示 −

Wcf 实例管理单例服务

以下代码用于初始化和托管单例实例。

服务代码

[ServiceContract]
interface IMyContract {
   [OperationContract]
   void MyMethod( );
}
[ServiceBehavior(InstanceContextMode = InstanceContextMode.Single)]
class MySingleton : IMyContract {
   int m_Counter = 0;
   
   public int Counter {
      get {
         return m_Counter;
      }
      set {
         m_Counter = value;
      }
   }
   public void MyMethod( ) {
      m_Counter++;
      Trace.WriteLine("Counter = " + Counter);
   }
}

宿主代码

MySingleton singleton = new MySingleton( );
singleton.Counter = 42;
ServiceHost host = new ServiceHost(singleton);
host.Open( );

//Do some blocking calls then
host.Close( );

客户端代码

MyContractClient proxy = new MyContractClient( );
proxy.MyMethod( );
proxy.Close( );

输出

Counter = 43