化零为整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
[源码下载]