【学习】构建WCF面向服务的应用程序系列课程笔记：(3)契约版本处理

第一节：【学习】构建WCF面向服务的应用程序系列课程笔记：(1) WCF概要

第二节：【学习】构建WCF面向服务的应用程序系列课程笔记：(2) 契约设计

这节的内容看完之后，只能说有一个概念性的认识，但真的是否用得好，可能需要在实现项目的版本管理中去体会，所以这次暂纪录一下契约版本处理的要点，若以后有更深的体会再补充。

1 契约与策略

1.1 契约与策略

• 客户端与服务必须就契约与策略达成一至
• Web Service Descripation Language(WSDL)
  • 为服务描述互操作契约
  • 契约包含相关的策略
• Web Services Policy (WS-Policy)
  • 为影响通讯的策略进行描述的互操作标准
  • 能够包含在WSDL契约中

1.2 WSDL契约

• 描述服务及其端点(endpoint)
• 绑定协议来访问操作集合，比如说指定服务是通过tcp还是http或者其它协议来访问
• 消息和类型的定义
• 主要关注于每个操作的消息格式
• 可选地包含WS-Policy区域（策略）

1.3 WS-Policy

• 为访问的操作描述协议，比如说可以配置操作使用基本的Http协议，还是使用WS-*协议等
• 安全性，配置传输的消息是否需要加密，是否需要证书等..
• 可靠性消息
• 事务
• 消息编码（MTOM）
• 其它的协议

1.4 版本控制问题

• 一旦发布，WSDL契约就被确定
  • 必须支持向后兼容
• 在理论上，策略可以发生变更
  • 新的安全策略
  • 附加的可靠性特性
  • 策略使用元数据交换来发现
• 如果客户端能够动态地处理变化，那么仅仅改变策略是安全的

2 版本相容性

2.1 版本相容性

• WCF契约缺省是提供版本相容性支持的
• 所有的服务契约，数据契约与消息契约：
  • 允许缺失，非必需(non-required)的数据存在
  • 可以忽略多余的数据
• DataContractSerializer提供相容性支持
• 适当的变化并不会对现存的客户端或者服务端产生影响

3 IExtensibleDataObject

3.1 IExtensibleDataObject

• 在序列化数据契约的时候，保存未知的元素
• 在反序列化数据契约的时候，保存未知的元素
• 在反序列化的时候，多余的数据将被放入到一个字典中
• 在序列化过程中，相同的数据按照其原始提供的样子以XML的形式写入

例如：有两个类Person，Person2，两个类使用了相同的服务契约名称，Name="Person"，所以在外部客户端或者其它浏览者访问时会视为是完全相同的。

Person.cs

[DataContract(Name="Person",Namespace="http://blog.csdn.net/llxchen/employee")]
public class Person ：IExtensibleDataObject
{
    private ExtensionDataObject m_edo_value;
    public ExtensionDataObject ExtensionData
{
    get{ return m_edo_value; }
    set{ m_edo_value = value; }
}

    [DataMember]
    public string Name;

}

Person2.cs

Person2多了一个Id

[DataContract(Name="Person",Namespace="http://blog.csdn.net/llxchen/employee")]
public class Person2 ：IExtensibleDataObject
{
    private ExtensionDataObject m_edo_value;
    public ExtensionDataObject ExtensionData
{
    get{ return m_edo_value; }
    set{ m_edo_value = value; }
}

    [DataMember]
    public string Name;

    [DataMemeber]
    public int Id;

}

 从两个类的内容可以看到Person与Person2没有任何继承关系，但他通过了ExtensionDataObject联系到了一起。

假设我们:

1. 实例一个Person2 {Name="张三",Id=1}
2. 将Person2的实例将并序列
3. 再通过DataContractSerializer反序列化为Person后，从Person中可以取到 Name=”张三",
4. 再通过DataContractSerializer反序列化为Person2，我们仍然可以从Persion2中取到原来的Id=1.

也就是说在这个序列化的过程中，Id的值实际上没有丢失。

4 版本控制策略

4.1 服务契约的版本控制

• 非严格的方法
  • 在现有的契约上添加新的方法
  • 相同的命名空间
  • 更新客户端到最新的版本
• 半严格的方法
  • 在使用新的命名空间的新契约上添加新的方法
  • 继承自旧的契约
  • 在原有的端点上暴露新的契约
• 独立的新版本控制
  • 为所有的操作在新的命名空间下创建新的契约没有继承关系
  • 独立创建服务和端点
  • 共享基类服务类型中的公共函数

4.2 数据契约的版本控制

• 非严格方法：
  • 不要删除required的成员
  • 添加新的non-required成员
  • 不改变命名空间