化零为整WCF(10) - 实例模型(InstanceContextMode)

[索引页]
[源码下载]

化零为整WCF(10) - 实例模型(InstanceContextMode)

作者： webabcd


介绍
WCF(Windows Communication Foundation) - 实例模型：
    ServiceBehavior
    ·InstanceContextMode.PerCall - 新的 System.ServiceModel.InstanceContext 对象在每次调用前创建，在调用后回收。
    ·InstanceContextMode.PerSession - 为每个会话创建一个新的 System.ServiceModel.InstanceContext 对象。
    ·InstanceContextMode.Single - 只有一个 System.ServiceModel.InstanceContext 对象用于所有传入呼叫，并且在调用后不回收。如果服务对象不存在，则创建一个。


示例
1、服务
PerCallMode.cs

using  System;
using  System.Collections.Generic;
using  System.Linq;
using  System.Text;

using  System.ServiceModel;

namespace  WCF.ServiceLib.InstanceMode
{
    /**//// <summary>
    /// 演示实例模型的接口（PerCall）
    /// </summary>
    [ServiceContract]
    public interface IPerCallMode
    {
        /**//// <summary>
        /// 获取计数器结果
        /// </summary>
        /// <returns></returns>
        [OperationContract]
        int Counter();
    }

    /**//// <summary>
    /// 演示实例模型的类（PerCall）
    /// </summary>
    /// <remarks>
    /// InstanceContextMode - 获取或设置指示新服务对象何时创建的值。
    /// InstanceContextMode.PerCall - 新的 System.ServiceModel.InstanceContext 对象在每次调用前创建，在调用后回收。
    /// </remarks>
    [ServiceBehavior(InstanceContextMode = InstanceContextMode.PerCall)]
    public class PerCallMode : IPerCallMode
    {
        private int _counter;

        /**//// <summary>
        /// 获取计数器结果
        /// </summary>
        /// <returns></returns>
        public int Counter()
        {
            _counter++;

            return _counter;
        }
    }
}

PerSessionMode.cs

using  System;
using  System.Collections.Generic;
using  System.Linq;
using  System.Text;

using  System.ServiceModel;

namespace  WCF.ServiceLib.InstanceMode
{
    /**//// <summary>
    /// 演示实例模型的接口（PerSession）
    /// </summary>
    [ServiceContract()]
    public interface IPerSessionMode
    {
        /**//// <summary>
        /// 获取计数器结果
        /// </summary>
        /// <returns></returns>
        [OperationContract]
        int Counter();
    }

    /**//// <summary>
    /// 演示实例模型的类（PerCall）
    /// </summary>
    /// <remarks>
    /// InstanceContextMode - 获取或设置指示新服务对象何时创建的值。
    /// InstanceContextMode.PerSession - 为每个会话创建一个新的 System.ServiceModel.InstanceContext 对象。
    /// InstanceContextMode 的默认值为 InstanceContextMode.PerSession
    /// </remarks>
    [ServiceBehavior(InstanceContextMode = InstanceContextMode.PerSession)]
    public class PerSessionMode : IPerSessionMode
    {
        private int _counter;

        /**//// <summary>
        /// 获取计数器结果
        /// </summary>
        /// <returns></returns>
        public int Counter()
        {
            _counter++;

            return _counter;
        }
    }
}

SingleMode.cs

using  System;
using  System.Collections.Generic;
using  System.Linq;
using  System.Text;

using  System.ServiceModel;

namespace  WCF.ServiceLib.InstanceMode
{
    /**//// <summary>
    /// 演示实例模型的接口（Single）
    /// </summary>
    [ServiceContract]
    public interface ISingleMode
    {
        /**//// <summary>
        /// 获取计数器结果
        /// </summary>
        /// <returns></returns>
        [OperationContract]
        int Counter();
    }

    /**//// <summary>
    /// 演示实例模型的接口（Single）
    /// </summary>
    /// <remarks>
    /// InstanceContextMode - 获取或设置指示新服务对象何时创建的值。
    /// InstanceContextMode.Single - 只有一个 System.ServiceModel.InstanceContext 对象用于所有传入呼叫，并且在调用后不回收。如果服务对象不存在，则创建一个。
    /// </remarks>
    [ServiceBehavior(InstanceContextMode = InstanceContextMode.Single)]
    public class SingleMode : ISingleMode
    {
        private int _counter;

        /**//// <summary>
        /// 获取计数器结果
        /// </summary>
        /// <returns></returns>
        public int Counter()
        {
            _counter++;

            return _counter;
        }
    }
}

2、宿主
PerCallMode.svc

<% @ ServiceHost Language="C#" Debug="true" Service="WCF.ServiceLib.InstanceMode.PerCallMode"  %>

PerSessionMode.svc

<% @ ServiceHost Language="C#" Debug="true" Service="WCF.ServiceLib.InstanceMode.PerSessionMode"  %>

SingleMode.svc

<% @ ServiceHost Language="C#" Debug="true" Service="WCF.ServiceLib.InstanceMode.SingleMode"  %>

Web.config

<? xml version="1.0" ?>
< configuration >
     < system.serviceModel >
         < behaviors >
             < serviceBehaviors >
                 < behavior  name ="InstanceModeBehavior" >
                     <!-- httpGetEnabled - 使用get方式提供服务 -->
                     < serviceMetadata  httpGetEnabled ="true"   />
                     < serviceDebug  includeExceptionDetailInFaults ="true" />
                 </ behavior >
             </ serviceBehaviors >
         </ behaviors >
         < services >
             <!-- name - 提供服务的类名 -->
             <!-- behaviorConfiguration - 指定相关的行为配置 -->
             < service  name ="WCF.ServiceLib.InstanceMode.PerCallMode"  behaviorConfiguration ="InstanceModeBehavior" >
                 <!-- address - 服务地址 -->
                 <!-- binding - 通信方式 -->
                 <!-- contract - 服务契约 -->
                 < endpoint  address =""  binding ="basicHttpBinding"  contract ="WCF.ServiceLib.InstanceMode.IPerCallMode"   />
             </ service >
             < service  name ="WCF.ServiceLib.InstanceMode.PerSessionMode"  behaviorConfiguration ="InstanceModeBehavior" >
                 <!-- bindingConfiguration - 指定相关的绑定配置 -->
                 < endpoint  address =""  binding ="wsHttpBinding"  contract ="WCF.ServiceLib.InstanceMode.IPerSessionMode"  bindingConfiguration ="PerSessionModeBindingConfiguration" />
             </ service >
             < service  name ="WCF.ServiceLib.InstanceMode.SingleMode"  behaviorConfiguration ="InstanceModeBehavior" >
                 < endpoint  address =""  binding ="basicHttpBinding"  contract ="WCF.ServiceLib.InstanceMode.ISingleMode"   />
             </ service >
         </ services >
         < bindings >
             < wsHttpBinding >
                 <!-- wsHttpBinding 可提供 安全会话 和 可靠会话 -->
                 < binding  name ="PerSessionModeBindingConfiguration" >
                     <!-- 指示是否在通道终结点之间建立 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="实例模型(InstanceContextMode)"  %>

< asp:Content  ID ="Content1"  ContentPlaceHolderID ="head"  runat ="Server" >
</ asp:Content >
< asp:Content  ID ="Content2"  ContentPlaceHolderID ="ContentPlaceHolder1"  runat ="Server" >
     < asp:Button  ID ="btnPerCallMode"  runat ="server"  Text ="PerCallMode"  
        onclick ="btnPerCallMode_Click"   />
     &nbsp;
     < asp:Button  ID ="btnPerSessionMode"  runat ="server"  Text ="PerSessionMode"  
        onclick ="btnPerSessionMode_Click"   />
     &nbsp;
     < asp:Button  ID ="btnSingleMode"  runat ="server"  Text ="SingleMode"  
        onclick ="btnSingleMode_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
{
    protected void Page_Load(object sender, EventArgs e)
    {

    }

    protected void btnPerCallMode_Click(object sender, EventArgs e)
    {

        var proxy = new InstanceModeSvc.PerCallMode.PerCallModeClient();

        Page.ClientScript.RegisterStartupScript(
            this.GetType(),
            "js",
            string.Format("alert('计数器：{0}')", proxy.Counter()),
            true);

        proxy.Close();
    }

    protected void btnPerSessionMode_Click(object sender, EventArgs e)
    {
        if (Session["proxy"] == null)
            Session["proxy"] = new InstanceModeSvc.PerSessionMode.PerSessionModeClient();

        Page.ClientScript.RegisterStartupScript(
            this.GetType(),
            "js",
            string.Format("alert('计数器：{0}')", (Session["proxy"] as InstanceModeSvc.PerSessionMode.PerSessionModeClient).Counter()),
            true);
    }

    protected void btnSingleMode_Click(object sender, EventArgs e)
    {
        var proxy = new InstanceModeSvc.SingleMode.SingleModeClient();

        Page.ClientScript.RegisterStartupScript(
            this.GetType(),
            "js",
            string.Format("alert('计数器：{0}')", proxy.Counter()),
            true);

        proxy.Close();
    }
}

Web.config

<? xml version="1.0" ?>
< configuration >
     < system.serviceModel >
         < client >
             <!-- address - 服务地址 -->
             <!-- binding - 通信方式 -->
             <!-- contract - 服务契约 -->
             < endpoint  address ="http://localhost:3502/ServiceHost/InstanceMode/PerCallMode.svc"  binding ="basicHttpBinding"  contract ="InstanceModeSvc.PerCallMode.IPerCallMode"   />

             <!-- bindingConfiguration - 指定相关的绑定配置 -->
             < endpoint  address ="http://localhost:3502/ServiceHost/InstanceMode/PerSessionMode.svc"  binding ="wsHttpBinding"  contract ="InstanceModeSvc.PerSessionMode.IPerSessionMode"  bindingConfiguration ="PerSessionModeBindingConfiguration"   />

             < endpoint  address ="http://localhost:3502/ServiceHost/InstanceMode/SingleMode.svc"  binding ="basicHttpBinding"  contract ="InstanceModeSvc.SingleMode.ISingleMode"   />
         </ client >
         < bindings >
             < wsHttpBinding >
                 < binding  name ="PerSessionModeBindingConfiguration" >
                     <!-- 指示是否在通道终结点之间建立 WS-RM (WS-ReliableMessaging) 可靠会话。默认值为 false。 -->
                     < reliableSession  enabled ="true" />
                     < security >
                         <!-- 此属性控制安全上下文令牌是否通过客户端与服务之间的 WS-SecureConversation 交换建立。将它设置为 true 要求远程方支持 WS-SecureConversation。 -->
                         < message  establishSecurityContext ="true" />
                     </ security >
                 </ binding >
             </ wsHttpBinding >
         </ bindings >
     </ system.serviceModel >
</ configuration >

运行结果：
单击"btnPerCallMode"按钮，每次单击，计数器都返回1
单击"btnPerSessionMode"按钮，每次单击并且会话相同，计数器会累加
单击"btnSingleMode"按钮，每次单击，计数器都累加


OK
[源码下载]