[WCF REST] Web HTTP编程模型——WebHttpBinding

　　不论是我们采用SOAP还是REST架构风格，运行时框架体系依然不曾改变，终结点也仍旧是通信的核心。在Web HTTP编程模型中，我们采用基于WebHttpBinding绑定的终结点。绑定是一组相关绑定元素的有序组合，绑定的特性与能力决定于它包含的绑定元素，在这里我们通过分析绑定元素的方式来剖析WebHttpBinding绑定与其它绑定有何不同。采用HTTP/HTTPS通信协议的WebHttpBinding具有一些与WSHttpBinding/WS2007HttpBinding相同的属性，在这里我们只关心如下定义的Security属性。

　　1: public class WebHttpBinding : Binding, IBindingRuntimePreferences

　　2: {

　　3: //其它成员

　　4: public WebHttpSecurity Security { get; }

　　5: }

　　6: public sealed class WebHttpSecurity

　　7: {

　　8: // 其它成员

　　9: public WebHttpSecurityMode Mode { get; set; }

　　10: public HttpTransportSecurity Transport { get; }

　　11: }

　　12: public enum WebHttpSecurityMode

　　13: {

　　14: None,

　　15: Transport,

　　16: TransportCredentialOnly

　　17: }

　　基于SOAP的绑定一般具有两种基本的安全模式，即Message和Transport模式。对于前者，它是完全建立在WS-Security为核心的安全协议之上的，而整个WS-*协议簇都是基于SOAP的，所以自然不能应用在WebHttpBinding上，所以它只能通过HTTPS提供针对Transport模式的安全支持。具体来说，通过枚举WebHttpSecurityMode表示的安全模式具有如下三个选项：

　　None：HTTP 请求未使用任何安全性;

　　Transport：HTTP 请求使用传输级安全性;

　　TransportCredentialOnly：仅提供基于 HTTP 的客户端身份验证。

　　一、WebHttpBinding的绑定元素

　　现在我们根据上述三种不同的安全模式创建相应的WebHttpBinding对象，然后通过如下的程序在控制台中答应出所有的绑定元素类型。

　　1: static void Main(string[] args)

　　2: {

　　3: WebHttpBinding binding = new WebHttpBinding(WebHttpSecurityMode.None);

　　4: ListBindingElements(binding);

　　5:

　　6: binding = new WebHttpBinding(WebHttpSecurityMode.Transport);

　　7: ListBindingElements(binding);

　　8:

　　9: binding = new WebHttpBinding(WebHttpSecurityMode.TransportCredentialOnly);

　　10: ListBindingElements(binding);

　　11: }

　　12: static void ListBindingElements(WebHttpBinding binding)

　　13: {

　　14: int index = 1;

　　15: Console.WriteLine(binding.Security.Mode + ":");

　　16: foreach (var element in binding.CreateBindingElements())

　　17: {

　　18: Console.WriteLine("{0}. {1}", index++, element.GetType().FullName);

　　19: }

　　20: Console.WriteLine();

　　21: }

　　上述的程序执行之后会在控制台上产生如下的输出，从中我们不难看出三个WebHttpBinding均由一个消息编码元素和传输元素组成，我们知道这两种绑定元素最所有类型的绑定所必需的。

　　1: None：

　　2: 1. System.ServiceModel.Channels.WebMessageEncodingBindingElement

　　3: 2. System.ServiceModel.Channels.HttpTransportBindingElement

　　4:

　　5: Transport：

　　6: 1. System.ServiceModel.Channels.WebMessageEncodingBindingElement

　　7: 2. System.ServiceModel.Channels.HttpsTransportBindingElement

　　8:

　　9: TransportCredentialOnly：

　　10: 1. System.ServiceModel.Channels.WebMessageEncodingBindingElement

　　11: 2. System.ServiceModel.Channels.HttpTransportBindingElement

　　对于WebHttpBinding的两个绑定元素来说，由于它通过HTTPS提供针对Transport安全的支持，所以当安全模式为Transport时对应的传输绑定元素为HttpsTransportBindingElement，对于其余两种安全模式则直接采用HttpTransportBindingElement作为传输绑定元素。现在我们着重讨论是作为消息编码绑定元素的WebMessageEncodingBindingElement类型，以及它涉及的消息编码机制。

　　二、消息编码

　　我们先来看看WebMessageEncodingBindingElement的基本的定义。如下面的代码片断所示，它是MessageEncodingBindingElement的子类，并且具有与TextMessageEncodingElement类似的属性定义。其中MaxReadPoolSize和MaxWritePoolSize表示表示无需分配新的XmlDictionaryReader/XmlDictionaryWriter便可以读取的便可同时读取/写入的最大消息数，默认值分别是64和16。ReaderQuotas属性返回用于约束读取的XML的复杂度的XmlDictionaryReaderQuotas对象，而WriteEncoding属性表示采用的字符编码类型，默认采用UTF-8编码方式。由于WebHttpBinding不使用SOAP，表示消息版本的MessageVersion属性自然返回None，如果我们对该属性进行设置，指定的属性值也只能是MessageVersion.None。

　　1: public sealed class WebMessageEncodingBindingElement : MessageEncodingBindingElement,...

　　2: {

　　3: //其它成员

　　4: public override MessageEncoderFactory CreateMessageEncoderFactory();

　　5:

　　6: public bool CrossDomainScriptAccessEnabled {get; set; }

　　7: public WebContentTypeMapper ContentTypeMapper { get; set; }

　　8:

　　9: public int MaxReadPoolSize { get; set; }

　　10: public int MaxWritePoolSize { get; set; }

原文转自：http://www.ltesting.net