《WCF技术内幕》翻译26：第2部分_第5章_消息：Buffered vs Streamed、序列化和反序列化消息

http://blog.csdn.net/book_frank_xl/article/details/4968263

Posted on 2009-12-08 20:03  Frank Xu Lei 阅读(299)  评论(1)   编辑  收藏  网摘 所属分类:  《WCF技术内幕》翻译,  SOA and EAI 

Buffered vs. Streamed消息

序列化消息

反序列化消息

检查Message 是否是SOAP Fault

Buffered vs. Streamed消息

当我们在终结点之间流动的消息时，我们会本能地想到缓存。换个方式来说，我们假设程序接收到一个Message时，它已经知道整个Message。这种方式称作缓存模式(buffering）。与之相对的就是流处理模式（streaming），并且有2种流处理模式（streaming）。第一种是推模型（push model），发送者按照自己的节奏推送字节流到接收者。当流数据发送的时候，发送者把数据写到本地缓存直到写满为止，数据会发生给接收者，接收者会从本地缓冲区读取数据。第二种机制成为拉模型（pull model）。当流数据发送的时候，接收者从发送者请求数据，在收到请求以后，发送者发送请求的数据。这个过程会重复执行知道请求的数据发送完毕。WCF基础结构实现了第二种流处理方法。

在WCF里，Message的消息头块通常是缓存起来的，消息内容可以buffered或者streamed模式。缓存区的大小默认是64KB.（你会在第8章里了解如何改变这个设置。）如果消息体是streamed模式，它的大小就是无限制的。实际上，这意味着我们可以在WCF里传递流媒体。不是所有的消息都是流处理消息体元素。例如，小的消息就不需要streamed模式；缓存模式会更加高效地处理它们。更确切地说，一个大的消息本质上验证是十分困难的。想一下，一个例子，假如使用streamed模式发送一个30分钟长的电影作为消息体的消息。电影非常不错，并且可以在接收完毕前就可以播放给观众。如果数据流终止，并且没任何发送结束标记，处理错误就变得不太可能了，因为用户可能已经看到数据了，同样地，如果一个程序已经对数据做了数据签名，这个签名只能在整个数据流结构和缓存以后才能验证了，这就不适合使用streamed模式处理消息体数据。

序列化消息

既然你已经学习了如何创建消息，现在我们来研究一下如何序列化消息的全部或者某一部分。首先，Message类型上的所有序列化方法名称都是以Write开始，而且这些方法都接受XmlWriter或者XmlDictionaryWriter类型的参数。消息的实际序列化工作由XmlWriter或者XmlDictionaryWriter对象完成，而不是直接由Message对象完成。记得前面关于XmlDictionaryWriter的讨论，实际的序列化包括消息序列化和编码2个步骤。序列化小的方法原型如下：

public void WriteStartEnvelope(XmlDictionaryWriter writer);

public void WriteStartBody(XmlDictionaryWriter writer);

public void WriteStartBody(XmlWriter writer);

public void WriteBody(XmlDictionaryWriter writer);

public void WriteBody(XmlWriter writer);

public void WriteBodyContents(XmlDictionaryWriter writer);

public void WriteMessage(XmlDictionaryWriter writer);

public void WriteMessage(XmlWriter writer);

WriteMessage方法序列化消息的全部内容到XmlWriter或者XmlDictionaryWriter包装的Stream里。因为这些方法序列化整个消息，因此与其它方法相比，它们的使用频率最高。

Message类型同样定义了对于消息序列化进行粒度控制的方法。例如，WriteBody方法序列化body标签和元素到XmlWriter或者XmlDictionaryWriter包装的Stream里。WriteBodyContents方法，话句话说，序列化body元素（没有body标签）到XmlDictionaryWriter包装的Stream里。WriteStartEvelope方法简单的写

反序列化消息

在接受程序里普遍存在的一个任务就是消息的反序列化。消息的反序列化是从一个序列化的消息创建一个新的消息的别称。因为我们已经过了如何创建一个Message对象，同样也讲了大部分的消息反序列化的内容。更确切地说，我们已经学习了如何使用XmlDictionaryReader类型从一个Stream或者Byte创建一个Message。

想一下我们关于Message工厂方法的讨论，其中一种创建消息体的方法就是传递Object给工厂方法。同样的方式，我们或许需要从一个Message实例反序列化Object。为了这个目的，Message类型定义了从Message对象反序列化消息体的成员。这些方法的原型如下；

public T GetBody();

public T GetBody(XmlObjectSerializer serializer);

泛型方法GetBody允许调用者反序列化消息体的内容到T类型的对象里。另外一个方法接受一个XmlObjectSerializer参数，因此为消息体的反序列化提供了扩展点。不论我们调用哪个方法，我们必须知道Message的消息体内包含的类型信息。如果我们泛型方法里使用的类型和消息体的类型不兼容，就会抛出一个SerializationException异常。

检查Message 是否是SOAP Fault

正如你看到的，Message类型的实例表示一个SOAP 消息或者SOAP Fault。当接受程序反序列化一个Message的时候，它必须能够确定这个Message是否是一个SOAP Fault，因为通常SOAP 消息和SOAP Fault的执行路径不同。因此，Message定义了一个只读属性IsFault。简而言之，一旦一个Message对象从进来的Stream or Byte反序列化完毕，IsFault属性会标记Message是否是一个SOAP Fault，这也是WCF基础结构对于反序列化的消息作出的第一次检查。我们可以通过改变前面代码里CreateAndShowMessage方法来演示这个属性的功能，如下所示；

private static void CreateAndShowMessage(MessageFault messageFault,

                                         MessageVersion version) {

 Message message = Message.CreateMessage(version,

                                          messageFault,

                                          "urn:SomeFaultAction");

 // commented out for clarity

 // Console.WriteLine("{0}/n", message.ToString());

 // ** New code begins here **

 MemoryStream stream = new MemoryStream();

 // write the Message to a Stream

 XmlDictionaryWriter writer = XmlDictionaryWriter.CreateBinaryWriter(

      stream,null, null, false);

 message.WriteMessage(writer);

 writer.Flush();

 stream.Position = 0;

 // read the Message from the Stream从Stream读取消息

 XmlDictionaryReader reader =

      XmlDictionaryReader.CreateBinaryReader(stream, new

        XmlDictionaryReaderQuotas());

 message = Message.CreateMessage(reader, Int32.MaxValue, version);

 // check if it is a Fault检查消息是否是SOAP Fault

 Console.WriteLine("the message {0} a SOAP Fault",

      message.IsFault ? "is" : "is not");

}

当这些代码执行的时候（像前面的代码），产生下面的输出：

the message is a SOAP Fault

the message is a SOAP Fault

注意到对于连个创建对象Message.IsFault属性都返回true,这里着重指出的是对于所有的表示SOAP Fault的Message对象，Message.IsFault属性都返回true，不管消息数据的编码和版本是什么。

 

---

 

【老徐的博客】
【作      者】：Frank Xu Lei
【地      址】：http://www.cnblogs.com/frank_xl/
【中文论坛】：微软WCF中文技术论坛
【英文论坛】：微软WCF英文技术论坛