WCF 学习总结3 -- 实例模式

通过WCF的ServiceBehaviorAttribute设定InstanceContextMode有下面的3中模式:
1. Single —— 表示所有的客户端共享一个会话(服务对象)(服务关闭时才会销毁服务对象)
2. PerCall —— 表示每次调用都会创建一个会话(服务对象)(调用完毕后就会销毁服务对象)
3. PerSession —— 表示为每个连接(每个客户端代理对象) 创建一个会话(服务对象),只有指定IsTerminating=true的操作被调用,或者是设定的SessionTimeout超时的时候,服务对象会被销毁。但支持Session的Binding只有:WSHttpBinding、WSDualHttpBinding、WSFederationHttpBinding、NetTcpBinding。

测试一下上述行为,设计3个Service,每个Service都在构造函数中输出内容并实现IDispose接口,在Dispose()里输出内容。
(准备) Host实现代码:
static void Main(string[] args) { ServiceHost host1 = new ServiceHost(typeof(SingleService)); host1.Open(); Console.WriteLine("SingleService Opened!"); ServiceHost host2 = new ServiceHost(typeof(PeerCallService)); host2.Open(); Console.WriteLine("PeerCallService Opened!"); ServiceHost host3 = new ServiceHost(typeof(PeerSessionService)); host3.Open(); Console.WriteLine("PeerSessionService Opened!"); Console.Read(); }


(一) Single服务契约——服务端启动时实例化

[ServiceBehavior(InstanceContextMode = InstanceContextMode.Single)] public class SingleService : IService1, IDisposable { public SingleService() { Console.WriteLine("SingleService ({0}) [{1:mm:ss.fff}] ctor", this.GetHashCode(), DateTime.Now); } public string GetData(string value) { return string.Format("SingleService ({0}) GetData [{1}]", this.GetHashCode(), value); } public void Dispose() { Console.WriteLine("SingleService ({0}) [{1:mm:ss.fff}] dispose", this.GetHashCode(), DateTime.Now); } }
启动Host调用SingleService.GetData,服务端的输出:
WCF 学习总结3 -- 实例模式
上图说明SingleService在服务启动时就创建了。


(二) PerCall服务契约——每次调用都重新实例化
[ServiceBehavior(InstanceContextMode = InstanceContextMode.PerCall)] public class PeerCallService : IService1, IDisposable { public PeerCallService() { Console.WriteLine("PeerCallService ({0}) [{1:mm:ss.fff}] ctor", this.GetHashCode(), DateTime.Now); } public string GetData(string value) { return string.Format("PeerCallService ({0}) GetData [{1}]", this.GetHashCode(), value); } public void Dispose() { Console.WriteLine("PeerCallService ({0}) [{1:mm:ss.fff}] dispose", this.GetHashCode(), DateTime.Now); } }
调用PeerCallService.GetData

WCF 学习总结3 -- 实例模式

(三) PerSession服务契约——客户端第一次调用时实例化
[ServiceBehavior(InstanceContextMode = InstanceContextMode.PerSession)] public class PeerSessionService : IService1, IDisposable { public PeerSessionService() { Console.WriteLine("PeerSessionService ({0}) [{1:mm:ss.fff}] ctor", this.GetHashCode(), DateTime.Now); } public string GetData(string value) { return string.Format("PeerSessionService ({0}) GetData [{1}]", this.GetHashCode(), value); } public void Dispose() { Console.WriteLine("PeerSessionService ({0}) [{1:mm:ss.fff}] dispose", this.GetHashCode(), DateTime.Now); } }

服务端的Session的Timeout是由binding属性receiveTimeout和inactivityTimeout控制的。
<bindings> <wsHttpBinding> <binding name="wsHttp" receiveTimeout="00:00:15"> <reliableSession enabled="true" inactivityTimeout="00:00:15" /> </binding> </wsHttpBinding> </bindings>

关于这两个属性的配置,更详细的说明请参考MSDN,按照配置服务对象在客户端没有调用后15秒销毁:

WCF 学习总结3 -- 实例模式

需要注意的是,每次 new WcfSvcPeerSession.Service1Client() 都是一个新的Session。

接下来看看怎么通过 OperationContact 的 IsInitiating 和 IsTerminating 来控制Session。IsInitiating 表示该方法是否可以初始化 Session,IsTerminating 表示该方法是否可以终止 Session。默认设置 IsInitiating=true,IsTerminating=false。另外通过IsInitiating和IsTerminating 控制的时候,必须设置 ServiceContract 的 SessionMode.Required
服务契约的定义
[ServiceContract(SessionMode = SessionMode.Required)] interface IService2 { [OperationContract(IsInitiating=true)] void LogIn(); [OperationContract] void DoSth(); [OperationContract(IsTerminating=true)] void LogOff(); }
服务契约的实现:
public class PeerSessionService2 : IService2 { public void LogIn() { var sessionId = OperationContext.Current.SessionId; Console.WriteLine("{0} LogIn.", sessionId); } public void DoSth() { var sessionId = OperationContext.Current.SessionId; Console.WriteLine("{0} DoSth.", sessionId); } public void LogOff() { var sessionId = OperationContext.Current.SessionId; Console.WriteLine("{0} LogOff.", sessionId); } }

一旦LogOff即IsTerminating,Session就结束了。再次调用任何服务端方法都会引发异常。


本系列链接:

WCF 学习总结1 -- 简单实例

WCF 学习总结2 -- 配置WCF

WCF 学习总结3 -- 实例模式

WCF 学习总结4 -- 用Duplex实现消息广播

WCF 学习总结5 -- 消息拦截实现用户名验证

WCF 学习总结6 -- WCF参数与返回值

WCF 学习总结7 -- 流模式实现文件上传

WCF 学习总结8 –- WCF 事务处理