WCF Messaging Fundamentals 的学习笔记

读了Aaron Skonnard MSDN杂志的文章，做一些记录，文笔很不错，将WCF的许多概念讲得简单明了，看完了，让人感觉意犹未尽的感觉

1. 建立一个MTOM的消息

// write to MTOM representation
FileStream custMtomStream = new FileStream(
"customer.mtom", FileMode.Create);
using (XmlWriter xw = XmlDictionaryWriter.CreateMtomWriter(
custMtomStream, Encoding.UTF8, 1024, "text/xml"))
{
doc.WriteTo(xw);
}

// read from MTOM representation
XmlDocument doc = new XmlDocument();
FileStream custMtomStream = new FileStream(
    "customer.mtom", FileMode.Open);
using (XmlReader xr = XmlDictionaryReader.CreateMtomReader(
    custMtomStream, Encoding.UTF8, XmlDictionaryReaderQuotas.Max))
{
    doc.Load(xr);
}

// write to text (XML 1.0) representation
doc.Save("customer.xml");

2. Message(System.ServiceModel.Channels.Message) 类在本质上模拟消息正文以及消息标头和属性的集合。可用方法主要用于创建消息、读写消息正文以及操作标头和属性的集合。

3. WS-Addressing 是一种规范，用于扩展 SOAP 以提供与传输无关的机制来寻址/路由 SOAP 消息

4. 通过调用各种静态 CreateMessage重载之一创建 Message 对象，并使用 IDisposable 或通过显式调用 Close 处理 Message 对象。可以从头开始创建新的 Message 对象，在发送消息时通常这样做。也可以从消息流创建新的 Message 对象，在接收消息时通常这样做。

5. 如果从头开始创建消息，则必须指定操作、消息版本以及要在消息中使用的正文。操作唯一地标识消息的目的或语义。WCF 服务依赖于将传入消息分派给相应方法的操作。消息版本标识传输时使用的 SOAP 和 WS-Addressing 版本（如果有）。指定消息版本时可以选择各种不同的选项

6. 在希望写入消息时，可以通过分别调用 WriteMessage 或 WriteBody 方法写入整个消息或仅写入正文。这两种方法都具有允许提供 XmlDictionaryWriter 或 XmlWriter 对象的重载

7. 通过 MessageVersion 类，可以指定要使用的 SOAP 和 WS-Addressing 版本。通过调用 CreateVersion 并提供 EnvelopeVersion 对象（用于标识 SOAP 版本）和 AddressingVersion 对象（用于标识 WS-Addressing 版本），可以创建 MessageVersion 对象

8. EnvelopeVersion.None 指定在传输过程中您不希望使用 SOAP，它还要求您使用 AddressingVersion.None。这是希望在传统的 XML 消息传递方案中利用 Windows Communication Foundation 时的常见设置。Soap11 表示 SOAP 1.1 规范，该规范目前得到广泛使用，而 Soap12 表示 SOAP 1.2 W3C 推荐标准（有关指向这两种规范的链接，请参阅 www.w3.org/TR/soap）。

9. WSAddressingAugust2004 表示 2004 年 8 月开始提交的 WS-Addressing W3C 提案（请参阅 www.w3.org/Submission/ws-addressing），目前得到广泛支持。而 WSAddressing10 表示最终的 WS-Addressing 1.0 W3C 推荐标准（请参阅 www.w3.org/2002/ws/addr）。

10. Message 对象在开始时处于 Created 状态，该状态是处理正文的唯一有效状态。处理正文有以下几种不同的方式：可以对其进行读取、写入或复制。调用 GetReaderAtBodyContents 或 GetBody<T> 可将状态更改为 Read。调用 WriteMessage 或 WriteBody 可将状态更改为 Written。调用 CreateBufferedCopy 可将状态更改为 Copied
在 Message 对象不再处于 Created 状态后，需要访问正文的任何方法都将引发异常。例如，首次调用 GetBody<T> 后再次调用它将导致异常。在需要多次处理正文的情况下，可以创建缓冲副本（通过调用 CreateBufferedCopy）或者将正文加载到 XmlDocument 中或将它反序列化为 .NET 对象以便在内存中使用。

11. 与标头（它始终在消息中传输）不同，消息属性通常仅在本地处理期间使用（它们可能不对通信时发生的情况产生影响，尽管有时它们会产生影响）。例如，使用 HTTP 时，Windows Communication Foundation 在传入 Message 对象的 Properties 集合中存储 HTTP 请求详细信息。详细信息存储在 HttpRequestMessageProperty 类型的对象（可以使用属性名的 httpRequest 访问它）中。还可以通过用 HttpReponseMessageProperty 类型的对象填充名为 httpResponse 的属性，影响 HTTP 响应详细信息。

12. Windows Communication Foundation 通道（尤其是实现各种 WS-* 规范的内置协议通道）层中的组件频繁使用标头和属性是很常见的。

13. 将消息映射到方法-必须首先定义将传入消息映射到方法的服务约定，才能开始使用WCF发送或接收消息。通过使操作值与方法签名关联，可以做到这一点
[OperationContract(Action="*")]
void ProcessMessage(Message msg);
此定义使 ProcessMessage 与所有传入消息关联，而不管其操作值如何（由于使用了 Action= "*" 子句）

还可以通过将 Action 属性设置为特定值（如 urn:add-customer）使方法与特定操作值关联
[OperationContract(Action="urn:add-customer")]
void AddCustomer(Message msg);
在WCF收到传入消息时，它将查看操作以确定要调度的方法，然后它再执行任何必要的序列化。对请求/响应类型使用消息时，WCF不执行任何序列化，而是由您决定如何处理消息。但是，使用键入的签名时，WCF使用序列化方法在后台自动执行读写消息正文的过程

[OperationContract(Action="urn:add-customer")]
void AddCustomer(Customer cust);
在这种情况下，WCF负责在调用 AddCustomer之前将传入消息的正文反序列化为 Customer 对象。

14. 为了设置WCF 服务
1.必须通知它要使用的传输和地址。
2.必须指定所需的 XML 表示形式和消息版本。
3.必须配置采用哪些 WS-* 协议。
4.必须提供传入消息和服务方法之间的映射
在WCF中是使用Endpoints

15. 端点(Endpoint)配置仅仅是地址、绑定和约定的组合(an address, binding, and contra)。约定(contract)定义消息和方法之间的映射。绑定(binding)指定剩余的消息传递详细信息。它指定在传递期间要使用的传输、XML 表示形式和消息版本。它还确定生成通道堆栈时应该包括的 WS-* 协议。

绑定还指定消息编码器(message encoder)；它实际上控制 XML 表示形式和消息版本详细信息。在运行时，消息编码器是传输通道从数据流读取和向其写入消息所用的组件。WCF提供了三个内置的消息编码器实现：TextMessageEncoder、BinaryMessageEncoder 和 MtomMessageEncoder

原文：
https://msdn.microsoft.com/msdnmag/issues/07/04/ServiceStation/default.aspx?loc=en
https://msdn.microsoft.com/msdnmag/issues/07/04/ServiceStation/default.aspx?loc=zh