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

[索引页]
[×××] 

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

 

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
[×××]