[原创]WCF后续之旅(13): 创建一个简单的WCF SOAP Message拦截、转发工具

本文介绍如何在WCF应用中创建消息拦截器，通过具体实例深入探讨WCF的Addressing机制，同时涵盖MessageFiltering、OperationSelection等知识点。

WCF是.NET平台下实现SOA的一种手段，SOA的一个重要的特征就基于Message的通信方式。从Messaging的角度讲，WCF可以看成是对Message进行发送、传递、接收、基础的工具。对于一个消息交换的过程，很多人只会关注message的最初的发送端和最终的接收端。实际上在很多情况下，在两者之间还存在很多的中间结点（Intermediary），这些中间结点在可能在实际的应用中发挥中重要的作用。比如，我们可以创建路由器（Router）进行消息的转发，甚至是Load Balance；可以创建一个消息拦截器（Interceptor）获取request或者response message，并进行Audit、Logging和Instrumentation。今天我们就我们的目光转向这些充当着中间人角色的Intermediary上面来。

在本篇文章中，我们将会创建一个message的拦截和转发工具（message interceptor）。它将被置于WCF调用的client和service之间，拦截并转发从client到service的request message，以及service到client的response message，并将request message和response message显示到一个可视化的界面上。我们将讨论这个message interceptor若干种不同的实现方式。

有一点需要明确说明的是，这个工具的创建并非我写作这篇文章的目的，我的目的是通过一个具体的例子让大家以一种直观方式对WCF的Addressing机制有一个深刻的认识。在介绍message interceptor的创建过程中，我会穿插介绍一个WCF的其它相关知识，比如Message Filtering、Operation Selection、Must Understand Validation等等。

一、创建一个简单的WCF应用

由于我们将要创建的message interceptor需要应用到具体的WCF应用中进行工作和检验，我们需要首先创建一个简单的WCF应用。我们创建一个简单的Calculation的例子。这个solution采用我们熟悉的四层结构（Interceptor用于host我们的message intercept service）：

1、Contract：Artech.MessageInterceptor.Contracts.ICalculate

 
using System.ServiceModel; <!--CRLF-->
namespace Artech.MessageInterceptor.Contracts <!--CRLF-->
{ <!--CRLF-->
    [ServiceContract] <!--CRLF-->
    public interface ICalculate <!--CRLF-->
    { <!--CRLF-->
        [OperationContract] <!--CRLF-->
        double Add(double x, double y); <!--CRLF-->
    } <!--CRLF-->
}  <!--CRLF--> 
 

2、Service：Artech.MessageInterceptor.Services.CalculateService

 
using Artech.MessageInterceptor.Contracts; <!--CRLF-->
namespace Artech.MessageInterceptor.Services <!--CRLF-->
{ <!--CRLF-->
    public class CalculateService : ICalculate <!--CRLF-->
    { <!--CRLF-->
        #region ICalculate Members  <!--CRLF-->
 <!--CRLF-->
        public double Add(double x, double y) <!--CRLF-->
        { <!--CRLF-->
            return x + y; <!--CRLF-->
        }  <!--CRLF-->
 <!--CRLF-->
        #endregion <!--CRLF-->
    } <!--CRLF-->
}  <!--CRLF-->
 <!--CRLF--> 
 

3、Hosting：Artech.MessageInterceptor.Hosting.Program

 
using System; <!--CRLF-->
using System.ServiceModel; <!--CRLF-->
using Artech.MessageInterceptor.Services; <!--CRLF-->
namespace Artech.MessageInterceptor.Hosting <!--CRLF-->
{ <!--CRLF-->
    class Program <!--CRLF-->
    { <!--CRLF-->
        static void Main(string[] args) <!--CRLF-->
        { <!--CRLF-->
            using (ServiceHost host = new ServiceHost(typeof(CalculateService))) <!--CRLF-->
            { <!--CRLF-->
                host.Opened += delegate <!--CRLF-->
                { <!--CRLF-->
                    Console.WriteLine("The calculate service has been started up!"); <!--CRLF-->
                }; <!--CRLF-->
                host.Open(); <!--CRLF-->
                Console.Read(); <!--CRLF-->
            } <!--CRLF-->
        } <!--CRLF-->
    } <!--CRLF-->
}  <!--CRLF-->
 <!--CRLF--> 
 

Configuration

 
<?xml version="1.0" encoding="utf-8" ?> <!--CRLF-->
<configuration> <!--CRLF-->
    <system.serviceModel> <!--CRLF-->
        <bindings> <!--CRLF-->
            <customBinding> <!--CRLF-->
                <binding name="MyCustomeBinding"> <!--CRLF-->
                    <textMessageEncoding /> <!--CRLF-->
                    <httpTransport /> <!--CRLF-->
                </binding> <!--CRLF-->
            </customBinding> <!--CRLF-->
        </bindings> <!--CRLF-->
        <services> <!--CRLF-->
            <service name="Artech.MessageInterceptor.Services.CalculateService"> <!--CRLF-->
                <endpoint binding="customBinding" bindingConfiguration="MyCustomeBinding" <!--CRLF-->
                    contract="Artech.MessageInterceptor.Contracts.ICalculate"  <!--CRLF-->
                    address="http://127.0.0.1:9999/calculateservice"/>               <!--CRLF-->
            </service> <!--CRLF-->
        </services> <!--CRLF-->
    </system.serviceModel> <!--CRLF-->
</configuration>  <!--CRLF--> 
 

在host我们的calculateservice的时候，我们使用了抛弃了系统定义的binding，而采用一个custom binding。是因为custom binding基于更好的可扩展能力，以利于我们后续的介绍。为了简单起见，我们仅仅需要bing为了提供最基本的功能：传输与编码，为此我仅仅添加了两个binding element：textMessageEncoding 和httpTransport。我们将在后面部分应用其他的功能，比如WS-Security.

4、Client：Artech.MessageInterceptor.Clients.Program

 
using System; <!--CRLF-->
using System.ServiceModel; <!--CRLF-->
using Artech.MessageInterceptor.Contracts; <!--CRLF-->
namespace Artech.MessageInterceptor.Clients <!--CRLF-->
{ <!--CRLF-->
    class Program <!--CRLF-->
    { <!--CRLF-->
        static void Main(string[] args) <!--CRLF-->
        { <!--CRLF-->
            using (ChannelFactory<ICalculate> channelFactory = new ChannelFactory<ICalculate>("calculateservice")) <!--CRLF-->
            { <!--CRLF-->
                ICalculate calculator = channelFactory.CreateChannel(); <!--CRLF-->
                using (calculator as IDisposable) <!--CRLF-->
                { <!--CRLF-->
                    Console.WriteLine("x + y = {2} where x = {0}  ans y = {1}", 1, 2, calculator.Add(1, 2)); <!--CRLF-->
                } <!--CRLF-->
            }  <!--CRLF-->
 <!--CRLF-->
            Console.Read(); <!--CRLF-->
        } <!--CRLF-->
    } <!--CRLF-->
}  <!--CRLF-->
 <!--CRLF--> 
 

Configuration：

 
<?xml version="1.0" encoding="utf-8" ?> <!--CRLF-->
<configuration> <!--CRLF-->
    <system.serviceModel> <!--CRLF-->
         <bindings> <!--CRLF-->
            <customBinding> <!--CRLF-->
                <binding name="MyCustomBinding"> <!--CRLF-->
                    <textMessageEncoding /> <!--CRLF-->
                    <httpTransport /> <!--CRLF-->
                </binding> <!--CRLF-->
            </customBinding> <!--CRLF-->
  
 