[索引页]
[源码下载]
作者: webabcd
介绍
WCF(Windows Communication Foundation) - 会话状态:
ServiceContract
·SessionMode.Allowed - 指定当传入绑定支持会话时,协定也支持会话(默认值)
·SessionMode.Required - 指定协定需要会话绑定。如果绑定并未配置为支持会话,则将引发异常
·SessionMode.NotAllowed - 指定协定永不支持启动会话的绑定
OperationContract
·IsInitiating - 获取或设置一个值,该值指示方法是否实现可在服务器上启动会话(如果存在会话)的操作。
·IsTerminating - 获取或设置一个值,该值指示服务操作在发送答复消息(如果存在)后,是否会导致服务器关闭会话。
示例
1、服务
IHello.cs
Hello.cs
2、宿主
Hello.svc
Web.config
3、客户端
Hello.aspx
Hello.aspx.cs
Web.config
运行结果:
单击" btnStartSession"按钮,初始化Session
单击" btnCounter"按钮,Session级别的计数器累加
单击" btnGetSessionId"按钮,获取当前Session的SessionId
单击" btnStopSession"按钮,终止Session
注:
Host中的 wsHttpBinding配置的 receiveTimeout属性为Session的过期时间
OK
[源码下载]
[源码下载]
化零为整WCF(11) - 会话状态(Session)
作者: webabcd
介绍
WCF(Windows Communication Foundation) - 会话状态:
ServiceContract
·SessionMode.Allowed - 指定当传入绑定支持会话时,协定也支持会话(默认值)
·SessionMode.Required - 指定协定需要会话绑定。如果绑定并未配置为支持会话,则将引发异常
·SessionMode.NotAllowed - 指定协定永不支持启动会话的绑定
OperationContract
·IsInitiating - 获取或设置一个值,该值指示方法是否实现可在服务器上启动会话(如果存在会话)的操作。
·IsTerminating - 获取或设置一个值,该值指示服务操作在发送答复消息(如果存在)后,是否会导致服务器关闭会话。
示例
1、服务
IHello.cs
using
System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;
namespace WCF.ServiceLib.SessionManagement
{
/// <summary>
/// 演示会话状态的接口
/// </summary>NotAllowed
/// <remarks>
/// SessionMode - 获取或设置是否允许、不允许或要求会话
/// SessionMode.Allowed - 指定当传入绑定支持会话时,协定也支持会话(默认值)
/// SessionMode.Required - 指定协定需要会话绑定。如果绑定并未配置为支持会话,则将引发异常
/// SessionMode.NotAllowed - 指定协定永不支持启动会话的绑定
/// </remarks>
[ServiceContract(SessionMode = SessionMode.Required)]
public interface IHello
{
/// <summary>
/// 初始化Session
/// </summary>
/// <remarks>
/// IsInitiating - 获取或设置一个值,该值指示方法是否实现可在服务器上启动会话(如果存在会话)的操作。
/// IsTerminating - 获取或设置一个值,该值指示服务操作在发送答复消息(如果存在)后,是否会导致服务器关闭会话。
/// </remarks>
[OperationContract(IsInitiating = true, IsTerminating = false)]
void StartSession();
/// <summary>
/// 结束Session
/// </summary>
[OperationContract(IsInitiating = false, IsTerminating = true)]
void StopSession();
/// <summary>
/// 获取计数器结果
/// </summary>
/// <returns></returns>
[OperationContract(IsInitiating = false, IsTerminating = false)]
int Counter();
/// <summary>
/// 获取SessionId
/// </summary>
/// <returns></returns>
[OperationContract(IsInitiating = false, IsTerminating = false)]
string GetSessionId();
}
}
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;
namespace WCF.ServiceLib.SessionManagement
{
/// <summary>
/// 演示会话状态的接口
/// </summary>NotAllowed
/// <remarks>
/// SessionMode - 获取或设置是否允许、不允许或要求会话
/// SessionMode.Allowed - 指定当传入绑定支持会话时,协定也支持会话(默认值)
/// SessionMode.Required - 指定协定需要会话绑定。如果绑定并未配置为支持会话,则将引发异常
/// SessionMode.NotAllowed - 指定协定永不支持启动会话的绑定
/// </remarks>
[ServiceContract(SessionMode = SessionMode.Required)]
public interface IHello
{
/// <summary>
/// 初始化Session
/// </summary>
/// <remarks>
/// IsInitiating - 获取或设置一个值,该值指示方法是否实现可在服务器上启动会话(如果存在会话)的操作。
/// IsTerminating - 获取或设置一个值,该值指示服务操作在发送答复消息(如果存在)后,是否会导致服务器关闭会话。
/// </remarks>
[OperationContract(IsInitiating = true, IsTerminating = false)]
void StartSession();
/// <summary>
/// 结束Session
/// </summary>
[OperationContract(IsInitiating = false, IsTerminating = true)]
void StopSession();
/// <summary>
/// 获取计数器结果
/// </summary>
/// <returns></returns>
[OperationContract(IsInitiating = false, IsTerminating = false)]
int Counter();
/// <summary>
/// 获取SessionId
/// </summary>
/// <returns></returns>
[OperationContract(IsInitiating = false, IsTerminating = false)]
string GetSessionId();
}
}
Hello.cs
using
System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;
namespace WCF.ServiceLib.SessionManagement
{
/// <summary>
/// 演示会话状态的接口
/// </summary>
/// <remarks>
/// InstanceContextMode - 获取或设置指示新服务对象何时创建的值。
/// InstanceContextMode.PerSession - 为每个会话创建一个新的 System.ServiceModel.InstanceContext 对象。
/// InstanceContextMode 的默认值为 InstanceContextMode.PerSession
/// </remarks>
[ServiceBehavior(InstanceContextMode = InstanceContextMode.PerSession)]
public class Hello : IHello
{
private int _counter;
/// <summary>
/// 初始化Session
/// </summary>
public void StartSession()
{
_counter = 0;
}
/// <summary>
/// 结束Session
/// </summary>
public void StopSession()
{
_counter = 0;
}
/// <summary>
/// 获取计数器结果
/// </summary>
/// <returns></returns>
public int Counter()
{
_counter++;
return _counter;
}
/// <summary>
/// 获取SessionId
/// </summary>
/// <returns></returns>
public string GetSessionId()
{
return OperationContext.Current.SessionId;
}
}
}
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;
namespace WCF.ServiceLib.SessionManagement
{
/// <summary>
/// 演示会话状态的接口
/// </summary>
/// <remarks>
/// InstanceContextMode - 获取或设置指示新服务对象何时创建的值。
/// InstanceContextMode.PerSession - 为每个会话创建一个新的 System.ServiceModel.InstanceContext 对象。
/// InstanceContextMode 的默认值为 InstanceContextMode.PerSession
/// </remarks>
[ServiceBehavior(InstanceContextMode = InstanceContextMode.PerSession)]
public class Hello : IHello
{
private int _counter;
/// <summary>
/// 初始化Session
/// </summary>
public void StartSession()
{
_counter = 0;
}
/// <summary>
/// 结束Session
/// </summary>
public void StopSession()
{
_counter = 0;
}
/// <summary>
/// 获取计数器结果
/// </summary>
/// <returns></returns>
public int Counter()
{
_counter++;
return _counter;
}
/// <summary>
/// 获取SessionId
/// </summary>
/// <returns></returns>
public string GetSessionId()
{
return OperationContext.Current.SessionId;
}
}
}
2、宿主
Hello.svc
<%
@ ServiceHost Language="C#" Debug="true" Service="WCF.ServiceLib.SessionManagement.Hello"
%>
Web.config
<?
xml version="1.0"
?>
< configuration >
< system.serviceModel >
< behaviors >
< serviceBehaviors >
< behavior name ="SessionManagementBehavior" >
<!-- httpGetEnabled - 使用get方式提供服务 -->
< serviceMetadata httpGetEnabled ="true" />
< serviceDebug includeExceptionDetailInFaults ="true" />
</ behavior >
</ serviceBehaviors >
</ behaviors >
< services >
<!-- name - 提供服务的类名 -->
<!-- behaviorConfiguration - 指定相关的行为配置 -->
< service name ="WCF.ServiceLib.SessionManagement.Hello" behaviorConfiguration ="SessionManagementBehavior" >
<!-- address - 服务地址 -->
<!-- binding - 通信方式 -->
<!-- contract - 服务契约 -->
<!-- bindingConfiguration - 指定相关的绑定配置 -->
< endpoint address ="" binding ="wsHttpBinding" contract ="WCF.ServiceLib.SessionManagement.IHello" bindingConfiguration ="SessionManagementBindingConfiguration" />
</ service >
</ services >
< bindings >
< wsHttpBinding >
<!-- wsHttpBinding 可提供 安全会话 和 可靠会话 -->
<!-- receiveTimeout - 在传输引发异常之前可用于完成读取操作的时间间隔(此处可认为是Session过期时间) -->
< binding name ="SessionManagementBindingConfiguration" receiveTimeout ="00:00:10" >
<!-- 指示是否在通道终结点之间建立 WS-RM (WS-ReliableMessaging) 可靠会话。默认值为 false。 -->
< reliableSession enabled ="true" />
< security >
<!-- 此属性控制安全上下文令牌是否通过客户端与服务之间的 WS-SecureConversation 交换建立。将它设置为 true 要求远程方支持 WS-SecureConversation。 -->
< message establishSecurityContext ="true" />
</ security >
</ binding >
</ wsHttpBinding >
</ bindings >
</ system.serviceModel >
</ configuration >
< configuration >
< system.serviceModel >
< behaviors >
< serviceBehaviors >
< behavior name ="SessionManagementBehavior" >
<!-- httpGetEnabled - 使用get方式提供服务 -->
< serviceMetadata httpGetEnabled ="true" />
< serviceDebug includeExceptionDetailInFaults ="true" />
</ behavior >
</ serviceBehaviors >
</ behaviors >
< services >
<!-- name - 提供服务的类名 -->
<!-- behaviorConfiguration - 指定相关的行为配置 -->
< service name ="WCF.ServiceLib.SessionManagement.Hello" behaviorConfiguration ="SessionManagementBehavior" >
<!-- address - 服务地址 -->
<!-- binding - 通信方式 -->
<!-- contract - 服务契约 -->
<!-- bindingConfiguration - 指定相关的绑定配置 -->
< endpoint address ="" binding ="wsHttpBinding" contract ="WCF.ServiceLib.SessionManagement.IHello" bindingConfiguration ="SessionManagementBindingConfiguration" />
</ service >
</ services >
< bindings >
< wsHttpBinding >
<!-- wsHttpBinding 可提供 安全会话 和 可靠会话 -->
<!-- receiveTimeout - 在传输引发异常之前可用于完成读取操作的时间间隔(此处可认为是Session过期时间) -->
< binding name ="SessionManagementBindingConfiguration" receiveTimeout ="00:00:10" >
<!-- 指示是否在通道终结点之间建立 WS-RM (WS-ReliableMessaging) 可靠会话。默认值为 false。 -->
< reliableSession enabled ="true" />
< security >
<!-- 此属性控制安全上下文令牌是否通过客户端与服务之间的 WS-SecureConversation 交换建立。将它设置为 true 要求远程方支持 WS-SecureConversation。 -->
< message establishSecurityContext ="true" />
</ security >
</ binding >
</ wsHttpBinding >
</ bindings >
</ system.serviceModel >
</ configuration >
3、客户端
Hello.aspx
<%
@ Page Language="C#" MasterPageFile="~/Site.master" AutoEventWireup="true" CodeFile="Hello.aspx.cs"
Inherits="InstanceMode_Hello" Title="会话状态(Session)" %>
< asp:Content ID ="Content1" ContentPlaceHolderID ="head" runat ="Server" >
</ asp:Content >
< asp:Content ID ="Content2" ContentPlaceHolderID ="ContentPlaceHolder1" runat ="Server" >
< asp:Button ID ="btnStartSession" runat ="server" Text ="StartSession" OnClick ="btnStartSession_Click" />
< asp:Button ID ="btnCounter" runat ="server" Text ="Counter" OnClick ="btnCounter_Click" />
< asp:Button ID ="btnGetSessionId" runat ="server" Text ="GetSessionId" OnClick ="btnGetSessionId_Click" />
< asp:Button ID ="btnStopSession" runat ="server" Text ="StopSession" OnClick ="btnStopSession_Click" />
</ asp:Content >
Inherits="InstanceMode_Hello" Title="会话状态(Session)" %>
< asp:Content ID ="Content1" ContentPlaceHolderID ="head" runat ="Server" >
</ asp:Content >
< asp:Content ID ="Content2" ContentPlaceHolderID ="ContentPlaceHolder1" runat ="Server" >
< asp:Button ID ="btnStartSession" runat ="server" Text ="StartSession" OnClick ="btnStartSession_Click" />
< asp:Button ID ="btnCounter" runat ="server" Text ="Counter" OnClick ="btnCounter_Click" />
< asp:Button ID ="btnGetSessionId" runat ="server" Text ="GetSessionId" OnClick ="btnGetSessionId_Click" />
< asp:Button ID ="btnStopSession" runat ="server" Text ="StopSession" OnClick ="btnStopSession_Click" />
</ asp:Content >
Hello.aspx.cs
using
System;
using System.Collections;
using System.Configuration;
using System.Data;
using System.Linq;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.HtmlControls;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Xml.Linq;
public partial class InstanceMode_Hello : System.Web.UI.Page
{
SessionManagemenSvc.HelloClient _proxy = null;
protected void Page_Load(object sender, EventArgs e)
{
if (Session["proxy"] == null)
Session["proxy"] = new SessionManagemenSvc.HelloClient();
_proxy = Session["proxy"] as SessionManagemenSvc.HelloClient;
}
protected void btnStartSession_Click(object sender, EventArgs e)
{
_proxy.StartSession();
}
protected void btnCounter_Click(object sender, EventArgs e)
{
Page.ClientScript.RegisterStartupScript(
this.GetType(),
"js",
string.Format("alert('计数器:{0}')", _proxy.Counter()),
true);
}
protected void btnGetSessionId_Click(object sender, EventArgs e)
{
Page.ClientScript.RegisterStartupScript(
this.GetType(),
"js",
string.Format("alert('SessionId:{0}')", _proxy.GetSessionId()),
true);
}
protected void btnStopSession_Click(object sender, EventArgs e)
{
_proxy.StopSession();
}
}
using System.Collections;
using System.Configuration;
using System.Data;
using System.Linq;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.HtmlControls;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Xml.Linq;
public partial class InstanceMode_Hello : System.Web.UI.Page
{
SessionManagemenSvc.HelloClient _proxy = null;
protected void Page_Load(object sender, EventArgs e)
{
if (Session["proxy"] == null)
Session["proxy"] = new SessionManagemenSvc.HelloClient();
_proxy = Session["proxy"] as SessionManagemenSvc.HelloClient;
}
protected void btnStartSession_Click(object sender, EventArgs e)
{
_proxy.StartSession();
}
protected void btnCounter_Click(object sender, EventArgs e)
{
Page.ClientScript.RegisterStartupScript(
this.GetType(),
"js",
string.Format("alert('计数器:{0}')", _proxy.Counter()),
true);
}
protected void btnGetSessionId_Click(object sender, EventArgs e)
{
Page.ClientScript.RegisterStartupScript(
this.GetType(),
"js",
string.Format("alert('SessionId:{0}')", _proxy.GetSessionId()),
true);
}
protected void btnStopSession_Click(object sender, EventArgs e)
{
_proxy.StopSession();
}
}
Web.config
<?
xml version="1.0"
?>
< configuration >
< system.serviceModel >
< client >
<!-- address - 服务地址 -->
<!-- binding - 通信方式 -->
<!-- contract - 服务契约 -->
<!-- bindingConfiguration - 指定相关的绑定配置 -->
< endpoint address ="http://localhost:3502/ServiceHost/SessionManagement/Hello.svc" binding ="wsHttpBinding" contract ="SessionManagemenSvc.IHello" bindingConfiguration ="SessionManagementBindingConfiguration" />
</ client >
< bindings >
< wsHttpBinding >
< binding name ="SessionManagementBindingConfiguration" >
<!-- 指示是否在通道终结点之间建立 WS-RM (WS-ReliableMessaging) 可靠会话。默认值为 false。 -->
< reliableSession enabled ="true" />
< security >
<!-- 此属性控制安全上下文令牌是否通过客户端与服务之间的 WS-SecureConversation 交换建立。将它设置为 true 要求远程方支持 WS-SecureConversation。 -->
< message establishSecurityContext ="true" />
</ security >
</ binding >
</ wsHttpBinding >
</ bindings >
</ system.serviceModel >
</ configuration >
< configuration >
< system.serviceModel >
< client >
<!-- address - 服务地址 -->
<!-- binding - 通信方式 -->
<!-- contract - 服务契约 -->
<!-- bindingConfiguration - 指定相关的绑定配置 -->
< endpoint address ="http://localhost:3502/ServiceHost/SessionManagement/Hello.svc" binding ="wsHttpBinding" contract ="SessionManagemenSvc.IHello" bindingConfiguration ="SessionManagementBindingConfiguration" />
</ client >
< bindings >
< wsHttpBinding >
< binding name ="SessionManagementBindingConfiguration" >
<!-- 指示是否在通道终结点之间建立 WS-RM (WS-ReliableMessaging) 可靠会话。默认值为 false。 -->
< reliableSession enabled ="true" />
< security >
<!-- 此属性控制安全上下文令牌是否通过客户端与服务之间的 WS-SecureConversation 交换建立。将它设置为 true 要求远程方支持 WS-SecureConversation。 -->
< message establishSecurityContext ="true" />
</ security >
</ binding >
</ wsHttpBinding >
</ bindings >
</ system.serviceModel >
</ configuration >
运行结果:
单击" btnStartSession"按钮,初始化Session
单击" btnCounter"按钮,Session级别的计数器累加
单击" btnGetSessionId"按钮,获取当前Session的SessionId
单击" btnStopSession"按钮,终止Session
注:
Host中的 wsHttpBinding配置的 receiveTimeout属性为Session的过期时间
OK
[源码下载]