菜菜从零学习WCF七(消息协定)

  • 消息协定概述

    通常,定义消息的架构时使用数据协定就足够了

    有时必须精确控制如何将类型映射到通过网络传输的SOAP消息。

    对于这种情况,最常见的方案是插入自定义SOP标头。

    另一种常见方案是定义消息头和正文的安全属性,也就是说,确定是否对这些元素进行数字签名和加密。消息样式的操作可提供这种控制。

    消息样式的操作最多具有一个参数和一个返回值,其中参数和返回值的类型都是消息类型;也就是说,这两种类型可直接序列化为指定的SOP消息结构。

    可以是用MessageCOntractAttribute标记的任何类型或Message类型。

  • 定义消息协定

    若要为某一类型定义消息协定(即定义该类型和SOAP信封之间的映射),请对该类型应用MessageContractAttribute.然后对该类型中要成为SOAP标头的成员应用MessageHeaderAttribute,并对要成为消息的SOAP正文部分的成员应用MessageBodyMemberAttibute.

    可以对所有字段、属性和事件应用MessageHeaderAttribute和MessageBodyMemberAttribute,而不管这些字段、属性和事件是公用的、私有的、受保护的还是内部的

  • 在消息协定内部使用自定义类型

    每个单独的消息头和消息正文部分均使用为消息所使用的服务协定选择的序列化引擎进行序列化(转换为XML).

      默认序列化引擎XmlFormatter可以显式处理(通过具有System.Runtime.Serialization.DataContractAttribute)或隐式处理(通过作为基元类型而具有System.SerializableAttribute等)具有数据协定的任何类型

    可以采用两种方式在消息协定中使用重复元素的数组。直接在数组上使用MessageHeaderAttribute或MessageBodyMemberAttribute,另外就是直接使用MessageHeaderArrayAttribute

  • 对消息部分进行签名和加密

    消息协定可以指示消息和正文是否应进行数字签名和加密

    通过在MessageHeaderAttribute和MessageBodyMemberAttribute属性(attribute)上设置System.ServiceModel.MessageContractMemberAttributre.ProtectionLevel属性(property)来完成

    System.Net.Security.ProtectionLevel

      None(不加密或 签名)

      Sign(近数字签名)

      EncryptAndSign(加密并数字签名)

    默认值为None

    若要让这些安全功能起作用,必需正确配置绑定和行为。如果在没有正确配置的情况下使用这些安全功能(例如,在不提供凭据的情况下试图对消息进行签名),则会在验证时引发异常

    对于消息头,会分别为每个消息头确定其保护级别

    对于消息正文,保护级别可理解为“最低保护级别”。无论包含几个正文部分,正文都只有一个保护级别。正文的保护级别由所有正文部分的最高ProtectionLevel属性设置确定。不过,您应该将每个正文部分的保护级别设置为实际要求的最低保护级别

  • 控制标头和正文部分的名称和命名空间

    在消息协定的SOAP表示形式中,每个标头和正文部分都映射为一个具有名称和命名空间的XML元素。通过操作System.ServiceModel.MessageContractMemberAttribute.Name和System.ServiceModel.MessageContractMemberAttribute.NameSpace(在MessageHeaderAttribute和MessageBodyMemberAttribute属性的父类上)可以更改这些默认值

  • 控制是否包装SOAP正文部分

  默认情况下,SOAP正文部分会在包装元素内部进行序列化

    若要取消包装元素,请将IsWrapped舒心设置为false.

    若要控制包装元素的名称和命名空间,请使用WrapperName和WrapperNameSpace属性

  • SOAP标头属性

  SOAP标准定义了下列可存在于标头上的属性:

      Actor/Role(在SOAP1.1中为Actor,在SOAP1.2中为Role)指定要使用给定标头的节点的统一资源标识符

      MustUnderstand指定醋栗标头的节点是否必须理解该标头

      Relay指定要将标头中继大下游节点

    WCF不会对传入消息的这些属性执行任何处理(MustUnderstand除外)

    静态方式将这些属性设置为任何需要的值

    也可以通过代码以动态方式控制这些属性

    如果同时使用动态和静态控制机制,则静态设置用作默认设置,但可以在以后使用动态机制重写

  • SOAP正文部分的顺序

    默认情况下,正文元素采用字母顺序

    可以通过System.ServiceModel.MessageBodyMemberAttribute.Order属性进行控制

    在消息协定中,基类型正文成员不排列在派生类型正文成员之前

  • 消息协定版本管理

    更改消息协定

     应用程序的新版本可能会向消息中添加额外的标头。在从新版本应用程序向旧版本应用程序发送消息时,系统必需处理额外的标头,同样,反方向操作时系统必需处理缺少的标头

   下面的规则适用于标头的版本管理:

      WCF不反对缺少标头,相应的成员将保留其默认值。

     WCF还忽略意外的额外标头,此规则的一种例外情况在传入的SOAP消息中,额外标头的MustUnderstand属性设置为true.在这种情况下,由于存在一个无法处理但必需理解的标头,因此会引发异常。

   消息正文具有类似的版本管理规则,即忽略缺少和附加的消息正文部分

性能注意事项

  每个消息头和消息正文部分相互独立的进行序列化。因此,可以为每个标头和正文部分重新声明相同的命名空间。为了提高性能,特别是对于消息在网络上的大小,请将多个标头和正文部分合并成一个标头或正文部分

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏大闲人柴毛毛

Java并发编程的艺术(十二)——线程安全

1. 什么是『线程安全』? 如果一个对象构造完成后,调用者无需额外的操作,就可以在多线程环境下随意地使用,并且不发生错误,那么这个对象就是线程安全的。 2. ...

3765
来自专栏java一日一条

JVM 架构解读

每个Java开发人员都知道字节码由JRE(Java运行时环境)执行。但许多人不知道JRE是Java Virtual Machine(JVM)的实现,它分析字节码...

841
来自专栏从零开始学自动化测试

python笔记4-遍历文件夹目录os.walk()

前言 如何遍历查找出某个文件夹内所有的子文件呢?并且找出某个后缀的所有文件 一、walk功能简介 1.os.walk() 方法用于通过在目录树种游走输出在...

5345
来自专栏码洞

Channel最佳实践之基本规则【译】

channel[通道]是golang的一种重要特性,正是因为channel的存在才使得golang不同于其它语言。channel使得并发编程变得简单容易有趣。

731
来自专栏代码世界

Django之路由系统

Django的路由系统   URL配置其实就是告诉Django项目你执行代码的路径,本质就是路径和调用的视图函数之间的映射关系表。Django通过这个表,可以把...

3067
来自专栏ytkah

如何控制dedecms描述的长度?

  我们都知道调用dedecms的标题长度可以用titlelen='字符数',{dede:arclist titlelen='10'},表示标题长度为10个字符...

2806
来自专栏求索之路

java并发编程实战笔记(部分实战未看,老旧章节跳过)

终于把这本经典的Java并发书看完了,虽然之前看的Thinking in Java和Effective Java里面都有并发的章节,但是这本书讲的更加深入,并...

42010
来自专栏Android 研究

Android系统启动——3init.rc解析

init.rc文件是以“块”(section)为单位服务的,,一个“块”(section)可以包含多行。“块”(section)分成两大类:一类称为"动作(ac...

4522
来自专栏python3

python3--基础综合测试

解释:char类型在python中不存在,它是其他编程语言的一种数据类型,比如C/C++,JAVA

1451
来自专栏GreenLeaves

SqlHelper中SqlHelperParameterCache类的用法介绍

SqlHelper类中提供了三种可以用来管理SqlParameter参数的共享方法。下面来一一讲解: 1、CacheParameterSet 将SqlParam...

23110

扫码关注云+社区

领取腾讯云代金券