博客园  :: 首页  :: 新随笔  :: 联系 :: 订阅 订阅  :: 管理

化零为整WCF(11) - 会话状态(Session)

Posted on 2008-05-13 13:44  webabcd  阅读(7950)  评论(37编辑  收藏
[索引页]
[源码下载]


化零为整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();
    }

}


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;
        }

    }

}



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>


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" />
    
&nbsp;
    
<asp:Button ID="btnCounter" runat="server" Text="Counter" OnClick="btnCounter_Click" />
    
&nbsp;
    
<asp:Button ID="btnGetSessionId" runat="server" Text="GetSessionId" OnClick="btnGetSessionId_Click" />
    
&nbsp;
    
<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();
    }

}


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>


运行结果:
单击"btnStartSession"按钮,初始化Session
单击"btnCounter"按钮,Session级别的计数器累加
单击"btnGetSessionId"按钮,获取当前Session的SessionId
单击"btnStopSession"按钮,终止Session

注:
Host中的wsHttpBinding配置的receiveTimeout属性为Session的过期时间


OK
[源码下载]