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,服务端的输出:
上图说明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就结束了。再次调用任何服务端方法都会引发异常。