WCF會(huì)話狀態(tài)功能特點(diǎn)解析
WCF是一個(gè).NET Framework 3.5的重要組成部件,可以幫助我們成功創(chuàng)建出一個(gè)安全性強(qiáng)的開發(fā)解決方案。我們?cè)谶@里會(huì)為大家介紹一下WCF會(huì)話狀態(tài)的相關(guān)概念。WCF會(huì)話狀態(tài)和兩個(gè)端點(diǎn)(EndPoint)之間的一系列消息交換相關(guān)聯(lián),它實(shí)際上是 "實(shí)例上下文(Instance Context)”,控制著服務(wù)對(duì)象實(shí)例的創(chuàng)建方式和生存期。和 ASP.NET Session 有很大不同。#t#
WCF會(huì)話狀態(tài)特點(diǎn):
由調(diào)用程序(Calling Application)發(fā)起初始化和終止操作。
由具體的 Binding 類型實(shí)現(xiàn),因此它們之間的細(xì)節(jié)可能有所不同。
不提供 ASP.NET Session 那樣的數(shù)據(jù)容器。
啟動(dòng)WCF會(huì)話狀態(tài)的方法包括:
調(diào)用 Channel 的 Open 方法。我們可以使用 ChannelFactory 來創(chuàng)建 Channel。
調(diào)用客戶端代理對(duì)象的 Open 方法(ClientBase.Open)。
調(diào)用任何允許初始化會(huì)話服務(wù)方法(缺省情況下所有的服務(wù)方法都自動(dòng)初始化Session,也就是 IsInitiating=true)。
結(jié)束WCF會(huì)話狀態(tài)的方法包括:
調(diào)用 Channel 的 Close 方法。
調(diào)用客戶端代理對(duì)象的 Close 方法(ClientBase.Close)。
調(diào)用任何包含 "IsTerminating=true" 聲明的服務(wù)方法(缺省情況下所有的服務(wù)方法 IsTerminating=false,需要我們顯示聲明)。
要使用 WCF Session,我們一般按如下步驟進(jìn)行。
1. 開啟服務(wù)契約的 Session。
可以選擇的模式包括:Required、Allowed、NotAllowed。Required 表示必須使用 Session,如果 Binding 不支持,則會(huì)拋出異常;Allowed 表示如果 Binding 支持 Session 則開啟會(huì)話;NotAllowed 表示停用 Session。多數(shù) Binding 缺省就會(huì)開始 Session,而 BaseHttpBinding 不支持 Session。
- < ServiceContract(SessionModeSessionMode:=SessionMode.Required)> _
- Public Interface IService1
- < OperationContract(isinitiating:=False)> _
- Function GetData(ByVal value As Integer) As String
- End Interface
2. 使用 ServiceBehaviorAttribute 和 InstanceContextMode 在服務(wù)契約的實(shí)現(xiàn)類型上指定服務(wù)對(duì)象的 "實(shí)例上下文模式"。
InstanceContextMode 可選擇的方式包括:PerSession、PerCall、Single。PerSession 表示為每個(gè)連接(每個(gè)客戶端代理對(duì)象) 創(chuàng)建一個(gè)會(huì)話(服務(wù)對(duì)象);PerCall 則為每次調(diào)用(Operate)創(chuàng)建一個(gè)會(huì)話(服務(wù)對(duì)象);Single 則表示所有的客戶端共享一個(gè)會(huì)話(服務(wù)對(duì)象)。
- < ServiceBehavior(InstanceContextModeInstanceContextMode:
=InstanceContextMode.PerSession)> _- Public Class Service1
- Implements IService1
- Public Function GetData(ByVal value As Integer) As String
Implements IService1.GetData- Console.WriteLine(OperationContext.Current.SessionId)
- Return String.Format("You entered: {0}", value)
- End Function
- End Class
客戶端調(diào)用:
- Sub Main()
- Dim url As String = "http://localhost:8731/
Design_Time_Addresses/WcfServiceLibrary1/Service1/mex"- Dim host As New System.ServiceModel.ServiceHost(GetType
(WcfServiceLibrary1.Service1))- host.AddServiceEndpoint(GetType(WcfServiceLibrary1.IService1),
New System.ServiceModel.WSHttpBinding, url)- host.Open()
- Console.WriteLine(host.State.ToString)
- Dim f As New System.ServiceModel.ChannelFactory
(Of WcfServiceLibrary1.IService1)(New System.ServiceModel
.WSHttpBinding, url)- Dim s As WcfServiceLibrary1.IService1 = f.CreateChannel
- Console.WriteLine(s.GetData(1))
- Console.WriteLine(s.GetData(1))
- Console.WriteLine(s.GetData(1))
- Console.ReadKey()
- End Sub
輸出:
urn:uuid:e801a8b5-8419-4ec4-bfc7-a850f408a42a
urn:uuid:e801a8b5-8419-4ec4-bfc7-a850f408a42a
urn:uuid:e801a8b5-8419-4ec4-bfc7-a850f408a42a
3. 如果有必要,可以使用 OperationContractAttribute 的 IsInitiating 和 IsTerminating 屬性來控制每次調(diào)用對(duì)WCF會(huì)話狀態(tài)的操控。
IsInitiating 表示該方法是否可以初始化 Session,IsTerminating 表示該方法是否可以終止 Session。默認(rèn)設(shè)置 IsInitiating=true,IsTerminating=false。
我們將上面的例子改一下:
- < ServiceContract(SessionModeSessionMode:=SessionMode.Required)> _
- Public Interface IService1
- < OperationContract(isinitiating:=False)> _
- Function GetData(ByVal value As Integer) As String
- End Interface
客戶第一次調(diào)用時(shí)會(huì)出現(xiàn)異常
ContractDescription“IService1”沒有 IsInitiating=true 操作;協(xié)定必須至少有一個(gè) IsInitiating=true 操作。
我們可以增加一個(gè)額外的方法來初始化會(huì)話,如下。OK,這次沒問題了。
- < ServiceContract(SessionModeSessionMode:=SessionMode.Required)> _
- Public Interface IService1
- < OperationContract(isinitiating:=False)> _
- Function GetData(ByVal value As Integer) As String
- < OperationContract(isinitiating:=True)> _
- Sub Init()
- End Interface
- < ServiceBehavior(InstanceContextModeInstanceContextMode
:=InstanceContextMode.PerSession)> _- Public Class Service1
- Implements IService1
- Public Function GetData(ByVal value As Integer)
As String Implements IService1.GetData- Console.WriteLine(OperationContext.Current.SessionId)
- Debug.WriteLine(OperationContext.Current.SessionId)
- Return String.Format("You entered: {0}", value)
- End Function
- Public Sub Init() Implements IService1.Init
- End Sub
- End Class
客戶端
- Sub Main()
- Dim url As String = "http://localhost:8731/Design_Time_Addresses
/WcfServiceLibrary1/Service1/mex"- Dim host As New System.ServiceModel.ServiceHost(GetType
(WcfServiceLibrary1.Service1))- host.AddServiceEndpoint(GetType(WcfServiceLibrary1.IService1),
New System.ServiceModel.WSHttpBinding, url)- host.Open()
- Console.WriteLine(host.State.ToString)
- Dim f As New System.ServiceModel.ChannelFactory
(Of WcfServiceLibrary1.IService1)(New System.ServiceModel.
WSHttpBinding, url)- Dim s As WcfServiceLibrary1.IService1 = f.CreateChannel
- s.Init() '初始化
- Console.WriteLine(s.GetData(1))
- Console.WriteLine(s.GetData(1))
- Console.WriteLine(s.GetData(1))
- Console.ReadKey()
- End Sub
這個(gè)示例就到這里了,對(duì)于原文有一個(gè)地方:
我們將上面例子改一下。
- [ServiceContract(SessionModeSessionMode=SessionMode.Required)]
- public interface ICalculate
- {
- [OperationContract(IsTerminating=true)]
- int Add(int a, int b);
- }
在客戶端第二次調(diào)用 Add 方法時(shí)會(huì)拋出異常。
未處理 System.InvalidOperationException
Message="This channel cannot send any more messages because IsTerminating operation 'Add' has already been called."
Source="mscorlib"
StackTrace:
Server stack trace:
在 System.ServiceModel.Channels.ServiceChannel.PrepareCall(ProxyOperationRuntime operation, Boolean oneway, ProxyRpc& rpc)
我在測(cè)試的過程,沒有發(fā)現(xiàn)這個(gè)問題!我用的是vs2008+sp1
以上就是對(duì)WCF會(huì)話狀態(tài)的相關(guān)介紹。