通过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,服务端的输出:上图说明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
(三) 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秒销毁:
需要注意的是,每次 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 事务处理