化零为整WCF(15) - 可靠性消息(ReliableMessaging)

[索引页]
[源码下载]

化零为整WCF(15) - 可靠性消息(ReliableMessaging)

作者：webabcd


介绍
WCF(Windows Communication Foundation) - 可靠性消息(ReliableMessaging)：
    ·通过重试的方法来保证消息的可靠传递，默认为8次
    ·当配置了“有序传递”的时候，客户端和服务端会开辟缓冲区，服务端缓冲区在接到所有客户端发来的消息后，按照客户端调用的顺序排序各个消息，然后有序地调用服务端


示例
1、服务
IReliable.cs

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

using System.ServiceModel;

namespace WCF.ServiceLib.Message
{
    /**//// <summary>
    /// 演示可靠性消息的接口
    /// </summary>
    /// <remarks>
    /// DeliveryRequirements - 指定绑定必须提供给服务或客户端实现的功能要求
    /// RequireOrderedDelivery - 如果指示 WCF 确认绑定必须支持排序消息，则为 true；否则为 false。默认值为 false。如果设置为了 true，那么也需要在配置的时候将order设置为 true
    /// </remarks>
    [ServiceContract]
    [DeliveryRequirements(RequireOrderedDelivery = true)]
    public interface IReliable
    {
        /**//// <summary>
        /// 将字符串写入文本文件
        /// </summary>
        /// <param name="str">需要写入文本文件的字符串</param>
        [OperationContract(IsOneWay = true)]
        void Write(string str);
    }
}

Reliable.cs

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

using System.ServiceModel;

namespace WCF.ServiceLib.Message
{
    /**//// <summary>
    /// 演示可靠性消息的类
    /// </summary>
    public class Reliable : IReliable
    {
        /**//// <summary>
        /// 将字符串写入文本文件
        /// </summary>
        /// <param name="str">需要写入文本文件的字符串</param>
        public void Write(string str)
        {
            System.IO.StreamWriter sw = new System.IO.StreamWriter(@"C:\WCF_Log_Reliable.txt", true);
            sw.Write(str);
            sw.WriteLine();
            sw.Close();
        }
    }
}

2、宿主
Reliable.svc

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

Web.config

<?xml version="1.0"?>
<configuration>
    <system.serviceModel>
        <services>
            <!--name - 提供服务的类名-->
            <!--behaviorConfiguration - 指定相关的行为配置-->
            <service name="WCF.ServiceLib.Message.Reliable" behaviorConfiguration="MessageBehavior">
                <!--address - 服务地址（监听地址）；listenUri - 服务监听地址（实际地址）。监听可以在host中设置（本例），也可以在client中设置（参看MTOM的例子）-->
                <!--binding - 通信方式-->
                <!--contract - 服务契约-->
                <!--bindingConfiguration - 指定相关的绑定配置-->
                <endpoint address="http://localhost:8888/ServiceHost/Message/Reliable.svc" listenUri="http://localhost:3502/ServiceHost/Message/Reliable.svc" binding="wsHttpBinding" contract="WCF.ServiceLib.Message.IReliable" bindingConfiguration="ReliableBindingConfiguration" />
            </service>
        </services>
        <behaviors>
            <serviceBehaviors>
                <behavior name="MessageBehavior">
                    <!--httpGetEnabled - 指示是否发布服务元数据以便使用 HTTP/GET 请求进行检索，如果发布 WSDL，则为 true，否则为 false，默认值为 false-->
                    <serviceMetadata httpGetEnabled="true" />
                    <serviceDebug includeExceptionDetailInFaults="true"/>
                </behavior>
            </serviceBehaviors>
        </behaviors>
        <bindings>
            <wsHttpBinding>
                <binding name="ReliableBindingConfiguration">
                    <!--reliableSession - 对可靠会话绑定元素属性的设置-->
                    <!--enabled - 指示是否在通道终结点之间建立 WS-RM (WS-ReliableMessaging) 可靠会话。默认值为 false-->
                    <!--ordered - 该值指示消息传递是否必须保持与消息发送一致的顺序（如果设置为true，那么也需要在相应的接口或类上声明DeliveryRequirements）-->
                    <!--inactivityTimeout - 服务在关闭之前保持非活动状态的时间间隔-->
                    <reliableSession enabled="true" ordered="true" inactivityTimeout="00:10:00" />
                    <!--security - 与此绑定一起使用的安全设置-->
                    <!--mode="None" - 禁用安全性-->
                    <security mode="None" />
                </binding>
            </wsHttpBinding>
        </bindings>
    </system.serviceModel>
</configuration>

3、客户端
Reliable.aspx

<%@ Page Language="C#" MasterPageFile="~/Site.master" AutoEventWireup="true" CodeFile="Reliable.aspx.cs"
    Inherits="Message_Reliable" Title="可靠性消息(ReliableMessaging)" %>

<asp:Content ID="Content1" ContentPlaceHolderID="head" runat="Server">
</asp:Content>
<asp:Content ID="Content2" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">
    <asp:Button ID="btnReliable" runat="server" Text="可靠性消息测试" OnClick="btnReliable_Click" />
    <p>
        测试方法：
        <br />
        1、用TcpTrace监听8888端口，目标端口3502
        <br />
        2、程序调用proxy.Hello("1")后马上停止Trace，过一会再打开Trace，发现程序还会调用proxy.Hello("2");
    </p>
    <p>
        备注：
        <br />
        1、通过重试的方法来保证消息的可靠传递，默认为8次
        <br />
        2、当配置了“有序传递”的时候，客户端和服务端会开辟缓冲区，服务端缓冲区在接到所有客户端发来的消息后，按照客户端调用的顺序排序各个消息，然后有序地调用服务端
    </p>
</asp:Content>

Reliable.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;
using System.ServiceModel.Channels;
using System.IO;

public partial class Message_Reliable : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        
    }

    protected void btnReliable_Click(object sender, EventArgs e)
    {
        using (var proxy = new MessageSvc.Reliable.ReliableClient())
        {
            proxy.Write("1");
            System.Threading.Thread.Sleep(3000);
            proxy.Write("2");
        }
    }
}

Web.config

<?xml version="1.0"?>
<configuration>
    <system.serviceModel>
        <client>
            <!--address - 服务地址-->
            <!--binding - 通信方式-->
            <!--contract - 服务契约-->
            <!--bindingConfiguration - 指定相关的绑定配置-->
            <endpoint address="http://localhost:8888/ServiceHost/Message/Reliable.svc" binding="wsHttpBinding" contract="MessageSvc.Reliable.IReliable" bindingConfiguration="ReliableBindingConfiguration" />
        </client>
        <bindings>
            <wsHttpBinding>
                <binding name="ReliableBindingConfiguration">
                    <!--reliableSession - 对可靠会话绑定元素属性的设置-->
                    <!--enabled - 指示是否在通道终结点之间建立 WS-RM (WS-ReliableMessaging) 可靠会话。默认值为 false-->
                    <!--ordered - 该值指示消息传递是否必须保持与消息发送一致的顺序（如果设置为true，那么也需要在相应的接口或类上声明DeliveryRequirements）-->
                    <!--inactivityTimeout - 服务在关闭之前保持非活动状态的时间间隔-->
                    <reliableSession enabled="true" ordered="true" inactivityTimeout="00:10:00" />
                    <!--security - 与此绑定一起使用的安全设置-->
                    <!--mode="None" - 禁用安全性-->
                    <security mode="None" />
                </binding>
            </wsHttpBinding>
        </bindings>
    </system.serviceModel>
</configuration>

运行结果：
1、用TcpTrace监听8888端口，目标端口3502
2、程序调用proxy.Hello("1")后马上停止Trace，过一会再打开Trace，发现程序还会调用proxy.Hello("2");


OK
[源码下载]