WCF扩展系列 - 行为扩展(Behaviors)

原文地址：http://www.cnblogs.com/Creator/archive/2011/05/21/2052687.html

这个系列的第一部分将会重点关注WCF行为（behaviors），WCF提供了四种类型的行为：服务行为、终结点行为、契约行为和操作行为。这些行为的接口几乎是所有WCF的扩展入口。本篇文章只是对行为拓展讲述一些基础的铺设，具体到上面四个行为的扩展以及使用案例，将会在后续的文章中讲到.

Behaviors

上述这四个行为的所定义的接口分别是IServiceBehavior，IEndpointBehavior，IContractBehavior以及 IOperationBehavior。虽然是四个不同的接口，但它们的接口方法却基本相同，分别为 AddBindingParameters()，ApplyClientBehavior()以及ApplyDispatchBehavior()。注意，IServiceBehavior由于只能作用在服务端，因此并不包含ApplyClientBehavior()方法。

public interface I[Service/Endpoint/Contract/Operation]Behavior { 
                void Validate(DescriptionObject); 
                void AddBindingParameters(DescriptionObject, BindingParameterCollection); 
                void ApplyDispatchBehavior(DescriptionObject, RuntimeObject); 
                void ApplyClientBehavior(DescriptionObject, RuntimeObject); // not on IServiceBehavior 
}

其中的方法描述如下：

• AddBindingParameters：用于向绑定元素传递自定义数据，以支持协定实现。
• Validate：用于检查服务宿主和服务说明，从而确定服务是否可成功运行。
• Apply[Client/Dispatch]Behavior：这是我们可以引用和修改WCF运行时对象的地方，也是用得最多的行为方法（大部分情况，上两个方法都会留空）。用于更改运行时属性值或插入自定义扩展对象（例如错误处理程序、消息或参数拦截器、安全扩展以及其他自定义扩展对象）。

他们各自的作用范围如下图所示（引用自张逸）：

 

增加一个行为（behaviors ）

向WCF中增加行为有三种不同的方法：

• 代码：service / endpoint / contract / operation 的描述类有一个behaviors集合属性，我们可以通过他简单的增加一个行为，具体做法，先将自定义服务行为添加到 Behaviors 属性，然后对 System.ServiceModel.ServiceHost 对象调用 ICommunicationObject.Open 方法。

• 配置文件：通过配置文件system.serviceModel/behaviors 节点，我们可以指定service behaviors 和 endpoint behaviors，已达到添加行为的目的

• 特性： 添加行为的简单方法是使用特性 — — 除了终结点行为。通过创建特性类 （基类型 = = System.Attribute) 和实现其中一个行为接口，您可以将特性应用于适当的元素，并添加行为到元素的描述。下面的代码显示了一个简单的服务，基于特性的行为的添加以及输出它们的调用顺序 （以及通过代码添加终结点行为）。

using System;
using System.Collections.ObjectModel;
using System.Reflection;
using System.ServiceModel;
using System.ServiceModel.Channels;
using System.ServiceModel.Description;
using System.ServiceModel.Dispatcher;

namespace Behaviors
{
    class MyServiceBehaviorAttribute : Attribute, IServiceBehavior
    {
        public void AddBindingParameters(ServiceDescription serviceDescription, ServiceHostBase serviceHostBase, Collection<ServiceEndpoint> endpoints, BindingParameterCollection bindingParameters)
        {
            Console.WriteLine("Inside {0}.{1}", this.GetType().Name, MethodBase.GetCurrentMethod().Name);
        }

        public void ApplyDispatchBehavior(ServiceDescription serviceDescription, ServiceHostBase serviceHostBase)
        {
            Console.WriteLine("Inside {0}.{1}", this.GetType().Name, MethodBase.GetCurrentMethod().Name);
        }

        public void Validate(ServiceDescription serviceDescription, ServiceHostBase serviceHostBase)
        {
            Console.WriteLine("Inside {0}.{1}", this.GetType().Name, MethodBase.GetCurrentMethod().Name);
        }
    }

    class MyEndpointBehavior : IEndpointBehavior
    {
        public void AddBindingParameters(ServiceEndpoint endpoint, BindingParameterCollection bindingParameters)
        {
            Console.WriteLine("Inside {0}.{1}, endpoint {2}", this.GetType().Name, MethodBase.GetCurrentMethod().Name, endpoint.Name);
        }

        public void ApplyClientBehavior(ServiceEndpoint endpoint, ClientRuntime clientRuntime)
        {
            Console.WriteLine("Inside {0}.{1}, endpoint {2}", this.GetType().Name, MethodBase.GetCurrentMethod().Name, endpoint.Name);
        }

        public void ApplyDispatchBehavior(ServiceEndpoint endpoint, EndpointDispatcher endpointDispatcher)
        {
            Console.WriteLine("Inside {0}.{1}, endpoint {2}", this.GetType().Name, MethodBase.GetCurrentMethod().Name, endpoint.Name);
        }

        public void Validate(ServiceEndpoint endpoint)
        {
            Console.WriteLine("Inside {0}.{1}, endpoint {2}", this.GetType().Name, MethodBase.GetCurrentMethod().Name, endpoint.Name);
        }
    }

    class MyContractBehaviorAttribute : Attribute, IContractBehavior
    {
        public void AddBindingParameters(ContractDescription contractDescription, ServiceEndpoint endpoint, BindingParameterCollection bindingParameters)
        {
            Console.WriteLine("Inside {0}.{1}, contract {2}", this.GetType().Name, MethodBase.GetCurrentMethod().Name, contractDescription.ContractType.Name);
        }

        public void ApplyClientBehavior(ContractDescription contractDescription, ServiceEndpoint endpoint, ClientRuntime clientRuntime)
        {
            Console.WriteLine("Inside {0}.{1}, contract {2}", this.GetType().Name, MethodBase.GetCurrentMethod().Name, contractDescription.ContractType.Name);
        }

        public void ApplyDispatchBehavior(ContractDescription contractDescription, ServiceEndpoint endpoint, DispatchRuntime dispatchRuntime)
        {
            Console.WriteLine("Inside {0}.{1}, contract {2}", this.GetType().Name, MethodBase.GetCurrentMethod().Name, contractDescription.ContractType.Name);
        }

        public void Validate(ContractDescription contractDescription, ServiceEndpoint endpoint)
        {
            Console.WriteLine("Inside {0}.{1}, contract {2}", this.GetType().Name, MethodBase.GetCurrentMethod().Name, contractDescription.ContractType.Name);
        }
    }

    class MyOperationBehaviorAttribute : Attribute, IOperationBehavior
    {
        public void AddBindingParameters(OperationDescription operationDescription, BindingParameterCollection bindingParameters)
        {
            Console.WriteLine("Inside {0}.{1}, operation {2}", this.GetType().Name, MethodBase.GetCurrentMethod().Name, operationDescription.Name);
        }

        public void ApplyClientBehavior(OperationDescription operationDescription, ClientOperation clientOperation)
        {
            Console.WriteLine("Inside {0}.{1}, operation {2}", this.GetType().Name, MethodBase.GetCurrentMethod().Name, operationDescription.Name);
        }

        public void ApplyDispatchBehavior(OperationDescription operationDescription, DispatchOperation dispatchOperation)
        {
            Console.WriteLine("Inside {0}.{1}, operation {2}", this.GetType().Name, MethodBase.GetCurrentMethod().Name, operationDescription.Name);
        }

        public void Validate(OperationDescription operationDescription)
        {
            Console.WriteLine("Inside {0}.{1}, operation {2}", this.GetType().Name, MethodBase.GetCurrentMethod().Name, operationDescription.Name);
        }
    }

    [ServiceContract]
    [MyContractBehavior]
    public interface ITest
    {
        [OperationContract]
        [MyOperationBehavior]
        int Add(int x, int y);
        [OperationContract]
        int Multiply(int x, int y);
    }

    [ServiceContract]
    [MyContractBehavior]
    public interface ITest2
    {
        [OperationContract]
        [MyOperationBehavior]
        string Echo(string text);
    }

    [MyServiceBehavior]
    public class Service : ITest, ITest2
    {
        public int Add(int x, int y) { return x + y; }
        public int Multiply(int x, int y) { return x * y; }
        public string Echo(string text) { return text; }
    }

    class Program
    {
        static void Main(string[] args)
        {
            string baseAddress = "http://" + Environment.MachineName + ":8000/Service";
            ServiceHost host = new ServiceHost(typeof(Service), new Uri(baseAddress));
            ServiceEndpoint ep1 = host.AddServiceEndpoint(typeof(ITest), new BasicHttpBinding(), "basic");
            ep1.Name = "Endpoint1-BasicHttp";
            ep1.Behaviors.Add(new MyEndpointBehavior());
            ServiceEndpoint ep2 = host.AddServiceEndpoint(typeof(ITest2), new WSHttpBinding(), "ws");
            ep2.Name = "Endpoint2-WSHttp";
            ep2.Behaviors.Add(new MyEndpointBehavior());
            Console.WriteLine("Opening the host...");
            host.Open();
            Console.WriteLine("Host opened");
        }
    }
}

 

 

      我并不认为这就是“最优”的添加方法，他只是描述通过特性增加行为的一个特定的例子而已，具体什么是“最优”的添加行为的方法呢？其实这就像软件架构一样，永远没有最好的架构，只有最合适的架构。所以具体项目里面采用哪种方式去添加来得具体情况具体分析。个人比较喜欢用使用配置文件添加的方法….

 

 

---

 在后面的文章中将会讲诉到具体的行为扩展，敬请期待..

 

        1.1.1. IServiceBehavior 
        1.1.2. IContractBehavior 
        1.1.3. IEndpointBehavior 
        1.1.4. IOperationBehavior

 

---

博客地址：Zealot Yin

欢迎转载，转载请注明出处[http://creator.cnblogs.com/]