艾伟：[原创]谈谈WCF中的Data Contract（2）：WCF Data Contract对Generic的支持

通过第一部分的介绍，我们可以体会到，WCF 的Data Contract在CLR Type和Neutral Contract之间搭建了一座桥梁，弥合了.NET世界和厂商中立世界的差异。通过WCF Data Contract我们将CLR Data Type暴露成一个厂商中立的数据结构的描述，同样通过WCF Data Contract我们将一个现有的CLR Data Type和既定的Neutral contract进行适配。

在.NET中，基于Primary Type，比如Int32，String等等，他们具有一个简单的默认的序列化方式和结构，可以说他们不需要Data Contract。接下来我们主要讨论的是一些相对比较特殊的、完全基于.NET的Data Type，比如Generic、Collection，和Dictionary。首先，我们结合例子来谈谈基于Generic的Data Type的Data Contract。

假设我们需要创建一个用于处理一些单据（Bill）的Service，比如如Order Bill、Sales Bill等。一般的单据都有一个单据头（Header）和明细（Detail）列表，为此我们创建了一个Generic的Bill。并

namespace Artech.SpecialDataContract.Contract
{
    [DataContract]
    public class Bill<THeader, TDetail>
    {
        [DataMember]
        public THeader Header
        { get; set; }

        [DataMember]
        public IList<TDetail> DetailList
        { get; set; }
    }

    [DataContract]
    public class OrderHeader
    {
        [DataMember]
        public Guid OrderID
        { get; set; }

        [DataMember]
        public DateTime OrderDate
        { get; set; }
    }

    [DataContract]
    public class OrderDetail
    {
        [DataMember]
        public Guid ProductID
        { get; set; }

        [DataMember]
        public int Quantity
        { get; set; }
    }

}

为处理订单单据创建了机遇订单的Header和Detail。

对于一个Neutral Service Contract和Neutral Data Contract本身是不可能支持Generic的，也就是Neutral Contract只能是对一个具体的CLR Type的体现。所以在定义Service Contract的时候，对于那些包含Generic Type作为参数或者返回值得Operation，我们必须指定一个具体的Data Type。所以我们创建了如下一个IBillManager Service Contract：

 

 

namespace Artech.SpecialDataContract.Contract
{
    [ServiceContract]
    public interface IBillManager
    {
        [OperationContract]
        void Procss(Bill<OrderHeader, OrderDetail> orderBill);
    }
}

如何我们现在

Host基于这样一个Contract的Service，你猜我们作为参数的数据类型将会如何体现的。

通过WSDL，我们会发现该Service的Data Contract将会以下面一段XSD的方式来呈现：

 

<?xml version="1.0" encoding="utf-8" ?>
<xs:schema elementFormDefault="qualified" targetNamespace="http://schemas.datacontract.org/2004/07/Artech.SpecialDataContract.Contract"
    xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://schemas.datacontract.org/2004/07/Artech.SpecialDataContract.Contract"
    xmlns:ser="http://schemas.microsoft.com/2003/10/Serialization/">
  <xs:import schemaLocation="http://artech/Artech.SpecialDataContract/BillManagerService.svc?xsd=xsd1"
      namespace="http://schemas.microsoft.com/2003/10/Serialization/" />
  <xs:complexType name="BillOfOrderHeaderOrderDetailLZ9Dq20o">
    <xs:annotation>
      <xs:appinfo>
        <GenericType Name="BillOf{0}{1}{#}" Namespace="http://schemas.datacontract.org/2004/07/Artech.SpecialDataContract.Contract"
            xmlns="http://schemas.microsoft.com/2003/10/Serialization/">
          <GenericParameter Name="OrderHeader" Namespace="http://schemas.datacontract.org/2004/07/Artech.SpecialDataContract.Contract"/>
          <GenericParameter Name="OrderDetail" Namespace="http://schemas.datacontract.org/2004/07/Artech.SpecialDataContract.Contract"/>
        </GenericType>
      </xs:appinfo>
    </xs:annotation>
    <xs:sequence>
      <xs:element minOccurs="0" name="DetailList" nillable="true" type="tns:ArrayOfOrderDetail"/>
      <xs:element minOccurs="0" name="Header" nillable="true" type="tns:OrderHeader"/>
    </xs:sequence>
  </xs:complexType>
  <xs:element name="BillOfOrderHeaderOrderDetailLZ9Dq20o" nillable="true" type="tns:BillOfOrderHeaderOrderDetailLZ9Dq20o"/>
  <xs:complexType name="ArrayOfOrderDetail">
    <xs:sequence>
      <xs:element minOccurs="0" maxOccurs="unbounded" name="OrderDetail" nillable="true" type="tns:OrderDetail"/>
    </xs:sequence>
  </xs:complexType>
  <xs:element name="ArrayOfOrderDetail" nillable="true" type="tns:ArrayOfOrderDetail"/>
  <xs:complexType name="OrderDetail">
    <xs:sequence>
      <xs:element minOccurs="0" name="ProductID" type="ser:guid"/>
      <xs:element minOccurs="0" name="Quantity" type="xs:int"/>
    </xs:sequence>
  </xs:complexType>
  <xs:element name="OrderDetail" nillable="true" type="tns:OrderDetail"/>
  <xs:complexType name="OrderHeader">
    <xs:sequence>
      <xs:element minOccurs="0" name="OrderDate" type="xs:dateTime"/>
      <xs:element minOccurs="0" name="OrderID" type="ser:guid"/>
    </xs:sequence>
  </xs:complexType>
  <xs:element name="OrderHeader" nillable="true" type="tns:OrderHeader"/>
</xs:schema>

对于不习惯看XSD的朋友，我们可以通过Add Service Reference的方式创建本地的Proxy file，借助生成的与之对应的Class来看看这个XSD最终呈现的结构：

    [System.Diagnostics.DebuggerStepThroughAttribute()]
    [System.CodeDom.Compiler.GeneratedCodeAttribute("System.Runtime.Serialization", "3.0.0.0")]
    [System.Runtime.Serialization.DataContractAttribute(Name="BillOfOrderHeaderOrderDetailLZ9Dq20o", Namespace="http://schemas.datacontract.org/2004/07/Artech.SpecialDataContract.Contract")]
    [System.SerializableAttribute()]
    public partial class BillOfOrderHeaderOrderDetailLZ9Dq20o : object, System.Runtime.Serialization.IExtensibleDataObject, System.ComponentModel.INotifyPropertyChanged {
        
        [System.NonSerializedAttribute()]
        private System.Runtime.Serialization.ExtensionDataObject extensionDataField;
        
        [System.Runtime.Serialization.OptionalFieldAttribute()]
        private Artech.SpecialDataContract.Client.BillManagerService.OrderDetail[] DetailListField;
        
        [System.Runtime.Serialization.OptionalFieldAttribute()]
        private Artech.SpecialDataContract.Client.BillManagerService.OrderHeader HeaderField;
        
        [global::System.ComponentModel.BrowsableAttribute(false)]
        public System.Runtime.Serialization.ExtensionDataObject ExtensionData {
            get {
                return this.extensionDataField;
            }
            set {
                this.extensionDataField = value;
            }
        }
        
        [System.Runtime.Serialization.DataMemberAttribute()]
        public Artech.SpecialDataContract.Client.BillManagerService.OrderDetail[] DetailList {
            get {
                return this.DetailListField;
            }
            set {
                if ((object.ReferenceEquals(this.DetailListField, value) != true)) {
                    this.DetailListField = value;
                    this.RaisePropertyChanged("DetailList");
                }
            }
        }
        
        [System.Runtime.Serialization.DataMemberAttribute()]
        public Artech.SpecialDataContract.Client.BillManagerService.OrderHeader Header {
            get {
                return this.HeaderField;
            }
            set {
                if ((object.ReferenceEquals(this.HeaderField, value) != true)) {
                    this.HeaderField = value;
                    this.RaisePropertyChanged("Header");
                }
            }
        }
        
        public event System.ComponentModel.PropertyChangedEventHandler PropertyChanged;
        
        protected void RaisePropertyChanged(string propertyName) {
            System.ComponentModel.PropertyChangedEventHandler propertyChanged = this.PropertyChanged;
            if ((propertyChanged != null)) {
                propertyChanged(this, new System.ComponentModel.PropertyChangedEventArgs(propertyName));
            }
        }
    }
    
    [System.Diagnostics.DebuggerStepThroughAttribute()]
    [System.CodeDom.Compiler.GeneratedCodeAttribute("System.Runtime.Serialization", "3.0.0.0")]
    [System.Runtime.Serialization.DataContractAttribute(Name="OrderHeader", Namespace="http://schemas.datacontract.org/2004/07/Artech.SpecialDataContract.Contract")]
    [System.SerializableAttribute()]
    public partial class OrderHeader : object, System.Runtime.Serialization.IExtensibleDataObject, System.ComponentModel.INotifyPropertyChanged {
        
        [System.NonSerializedAttribute()]
        private System.Runtime.Serialization.ExtensionDataObject extensionDataField;
        
        [System.Runtime.Serialization.OptionalFieldAttribute()]
        private System.DateTime OrderDateField;
        
        [System.Runtime.Serialization.OptionalFieldAttribute()]
        private System.Guid OrderIDField;
        
        [global::System.ComponentModel.BrowsableAttribute(false)]
        public System.Runtime.Serialization.ExtensionDataObject ExtensionData {
            get {
                return this.extensionDataField;
            }
            set {
                this.extensionDataField = value;
            }
        }
        
        [System.Runtime.Serialization.DataMemberAttribute()]
        public System.DateTime OrderDate {
            get {
                return this.OrderDateField;
            }
            set {
                if ((this.OrderDateField.Equals(value) != true)) {
                    this.OrderDateField = value;
                    this.RaisePropertyChanged("OrderDate");
                }
            }
        }
        
        [System.Runtime.Serialization.DataMemberAttribute()]
        public System.Guid OrderID {
            get {
                return this.OrderIDField;
            }
            set {
                if ((this.OrderIDField.Equals(value) != true)) {
                    this.OrderIDField = value;
                    this.RaisePropertyChanged("OrderID");
                }
            }
        }
        
        public event System.ComponentModel.PropertyChangedEventHandler PropertyChanged;
        
        protected void RaisePropertyChanged(string propertyName) {
            System.ComponentModel.PropertyChangedEventHandler propertyChanged = this.PropertyChanged;
            if ((propertyChanged != null)) {
                propertyChanged(this, new System.ComponentModel.PropertyChangedEventArgs(propertyName));
            }
        }
    }
    
    [System.Diagnostics.DebuggerStepThroughAttribute()]
    [System.CodeDom.Compiler.GeneratedCodeAttribute("System.Runtime.Serialization", "3.0.0.0")]
    [System.Runtime.Serialization.DataContractAttribute(Name="OrderDetail", Namespace="http://schemas.datacontract.org/2004/07/Artech.SpecialDataContract.Contract")]
    [System.SerializableAttribute()]
    public partial class OrderDetail : object, System.Runtime.Serialization.IExtensibleDataObject, System.ComponentModel.INotifyPropertyChanged {
        
        [System.NonSerializedAttribute()]
        private System.Runtime.Serialization.ExtensionDataObject extensionDataField;
        
        [System.Runtime.Serialization.OptionalFieldAttribute()]
        private System.Guid ProductIDField;
        
        [System.Runtime.Serialization.OptionalFieldAttribute()]
        private int QuantityField;
        
        [global::System.ComponentModel.BrowsableAttribute(false)]
        public System.Runtime.Serialization.ExtensionDataObject ExtensionData {
            get {
                return this.extensionDataField;
            }
            set {
                this.extensionDataField = value;
            }
        }
        
        [System.Runtime.Serialization.DataMemberAttribute()]
        public System.Guid ProductID {
            get {
                return this.ProductIDField;
            }
            set {
                if ((this.ProductIDField.Equals(value) != true)) {
                    this.ProductIDField = value;
                    this.RaisePropertyChanged("ProductID");
                }
            }
        }
        
        [System.Runtime.Serialization.DataMemberAttribute()]
        public int Quantity {
            get {
                return this.QuantityField;
            }
            set {
                if ((this.QuantityField.Equals(value) != true)) {
                    this.QuantityField = value;
                    this.RaisePropertyChanged("Quantity");
                }
            }
        }
        
        public event System.ComponentModel.PropertyChangedEventHandler PropertyChanged;
        
        protected void RaisePropertyChanged(string propertyName) {
            System.ComponentModel.PropertyChangedEventHandler propertyChanged = this.PropertyChanged;
            if ((propertyChanged != null)) {
                propertyChanged(this, new System.ComponentModel.PropertyChangedEventArgs(propertyName));
            }
        }
    }

为了使大家一眼就能了解整个结构，我对上面的代码进行简化：

 

namespace Artech.SpecialDataContract.Client.BillManagerService
{
    [DataContract]
    public class BillOfOrderHeaderOrderDetailLZ9Dq20o
    {
        [DataMember]
        public OrderHeader Header 
        { get; set; }

        [DataMember]
        public OrderDetail[] DetailList
        { get; set; }
    }

    [DataContract]
    public class OrderHeader
    {
        [DataMember]
        public Guid OrderID
        { get; set; }

        [DataMember]
        public DateTime OrderDate
        { get; set; }
    }

    [DataContract]
    public class OrderDetail
    {
        [DataMember]
        public Guid ProductID
        { get; set; }

        [DataMember]
        public int Quantity
        { get; set; }
    }

}

我们可以通过上面的code，注意到下面的细节：

·         Generic class Bill<THeader, TDetail>没有了，取而代之的是使用了具体OrderHeader和OrderDetial的新的非Generic class：BillOfOrderHeaderOrderDetailLZ9Dq20o。正如我们在上面所说，Neutral Contract根本就不知道Generic为何物。

·         新的Class name的名称很难看，它有下面几个部分组成：Bill（Generic Type Name）+ Of + OrderHeader（Generic Type的第一个类型参数对应的具体类型名称）+OrderDetail（Generic Type的第二个类型参数对应的具体类型名称）+lLZ9Dq20o（Generic Type参数类型Namespace的Hash Value）。

·         原本使用IList表示的DetailList变成了Array（public OrderDetail[] DetailList），这个将在和面的部分介绍。

我想你也不能容忍生成的如此冗长、甚至没有太大意义的Class name。我们有办法生成一个友好的名称。那就是显示指定Data Contract的Name：

[DataContract(Name="OrderBill")]
    public class Bill<THeader, TDetail>
    {
        [DataMember]
        public THeader Header
        { get; set; }

        [DataMember]
        public IList<TDetail> DetailList
        { get; set; }
}

现在对应的Data Contract Name将变成我们指定的名称。

public partial class OrderBill : object, System.Runtime.Serialization.IExtensibleDataObject, System.ComponentModel.INotifyPropertyChanged {}

但是上面的做法是不对的。原因很简单，如果我们在Service中添加一个处理Sales Bill的Operation（当然我们会添加两个额外的Header和Detail：SalesHeader和SalesDetail）：

    [ServiceContract]
    public interface IBillManager
    {
        [OperationContract(Name=”ProcessOrderBill”)]
        void Procss(Bill<OrderHeader, OrderDetail> orderBill);

        [OperationContract(Name =”ProcessSalesBill”)]
        void Procss(Bill<SalesHeader, SalesDetail> salesBill);
    }

很显然，WCF需要为Order Bill和Sales Bill创建两个Data Contract，但是现在你却把他们的名称显示地限定到一个固定的名称，很显然这会造成命名的冲突。如果你通过Browser试图访问Service，你会得到如下的Error：

The
server was unable to process the request due to an internal error. For
more information about the error, either turn on
IncludeExceptionDetailInFaults (either from ServiceBehaviorAttribute or
from the <serviceDebug> configuration behavior) on the server in
order to send the exception information back to the client, or turn on
tracing as per the Microsoft .NET Framework 3.0 SDK documentation and
inspect the server trace logs.

所以WCF需要为此提供这样的机制：基于不同的泛型类型参数生成不同Data Contract Name，这样才能解决命名冲突。我们可以稍微修改一下Data Contract 的定义就可以了：

    [DataContract(Name="Bill_{0}_{1}")]
    public class Bill<THeader, TDetail>
    {
        [DataMember]
        public THeader Header
        { get; set; }

        [DataMember]
        public IList<TDetail> DetailList
        { get; set; }
}

其中{0}和{1}分别代表第一个泛型类型参数和第二个泛型类型参数的名称，一次类推，你可以根据参数类型的个数设置{2}{3}…

这样我们生成的两个DataContract的名称为：Bill_OrderHeader_OrderDetail和Bill_SalesHeader_SalesDetail。

但是这并没有根本解决问题，如果在我现在不同的Namespace中创建了两个OrderHeader和OrderDetail呢？这无疑在.NET中是合法的，但是对于DataContract有有可能出现命名冲突。

这也就是为什么WCF默认机制下会为Data Contract Name添加一个额外hash value的原因。其实你也可以以你自己的方式添加这个Hash value：

 

 

[DataContract(Name="Bill_{0}_{1}_{#}")]
    public class Bill<THeader, TDetail>
    {
        [DataMember]
        public THeader Header
        { get; set; }

        [DataMember]
        public IList<TDetail> DetailList
        { get; set; }
}

上面的

{#}就代表这样一个Hash Value, 我想你会想到现在生成的Data Contract Name象什么样子：Bill_OrderHeader_OrderDetail_LZ9Dq20o 和Bill_SalesHeader_SalesDetail_LZ9Dq20o

时间： 2024-09-07 06:24:13

艾伟：[原创]谈谈WCF中的Data Contract（2）：WCF Data Contract对Generic的支持的相关文章

艾伟：[WCF中的Binding模型]之六（完结篇）：从绑定元素认识系统预定义绑定

由于绑定对象由一系列有序的绑定元素组成,绑定元素最终决定着信道栈中信道的组成,而信道的组成最终又决定了信道栈对消息进行处理的方式和能力,所有要确定绑定的特性和能力,我们可以通过查看其绑定元素的构成来一窥究竟.为此我们我们写了一个简单的方法,用于列出一个具体的绑定对象所有的绑定元素,在介绍一个个具体的系统绑定中,我会使用该方法: static void ListAllBindingElements(Binding binding){ BindingElementCollection element

艾伟：[WCF中的Binding模型]之一: Binding模型简介

1. 信道层与服务模型层(Channel Layer and Service Mode Layer) 对于一个分布式应用的开发与设计来说,通信问题是不得不考虑,同时也是最为复杂.最难实现的问题.在过去的若干年中, 微软先后推出了一系列广受欢迎的通信技术, 比如DCOM.Enterprise Service..NET Remoting.XML Web Service.MSMQ等等.这些技术提供了各自的编程模型,是开发人员从繁琐的完全基于通信的编程中解脱出来,使之仅仅需要关注具体的业务逻辑.WCF是

WCF中的Binding模型之一: Binding模型简介

一. 信道层与服务模型层(Channel Layer and Service Mode Layer) 对于一个分布式应用的开发与设计来说,通信问题是不得不考虑,同时也是最为复杂.最难实现的问题.在过去的若干年中, 微软先后推出了一系列广受欢迎的通信技术, 比如DCOM.Enterprise Service..NET Remoting.XML Web Service.MSMQ等等.这些技术提供了各自的编程模型,是开发人员从繁琐的完全基于通信的编程中解脱出来,使之仅仅需要关注具体的业务逻辑.WCF是

WCF中的Binding模型之六（完结篇）：从绑定元素认识系统预定义绑定

由于绑定对象由一系列有序的绑定元素组成,绑定元素最终决定着信道栈中信道的组成,而信道的组成最终又决定了信道栈对消息进行处理的方式和能力,所有要确定绑定的特性和能力,我们可以通过查看其绑定元素的构成来一窥究竟.为此我们我们写了一个简单的方法,用于列出一个具体的绑定对象所有的绑定元素,在介绍一个个具体的系统绑定中,我会使用该方法: 1: static void ListAllBindingElements(Binding binding) 2: { 3: BindingElementCollecti

WCF中的Binding模型之二: 信道与信道栈（Channel and Channel Stack）

WCF采用基于消息交换的通信方式,而绑定则实现了所有的通信细节.绑定通过创建信道栈实现了消息的编码与传输,以及对WS-*协议的实现.在这一节中,我们就来着重介绍WCF中的信道和信道栈.在正式开始对信道和信息栈的介绍之前,我们先来介绍两个重要的类型:CommunicationObject和DefaultCommunicationTimeouts. 一. CommunicationObject与DefaultCommunicationTimeouts WCF绑定模型涉及多种类型的组件,比如信道.信道

[WCF中的Binding模型]之六（完结篇）：从绑定元素认识系统预定义绑定

由于绑定对象由一系列有序的绑定元素组成,绑定元素最终决定着信道栈中信道的组成,而信道的组成最终又决定了信道栈对消息进行处理的方式和能力,所有要确定绑定的特性和能力,我们可以通过查看其绑定元素的构成来一窥究竟.为此我们我们写了一个简单的方法,用于列出一个具体的绑定对象所有的绑定元素,在介绍一个个具体的系统绑定中,我会使用该方法: static void ListAllBindingElements(Binding binding) { BindingElementCollection elemen

艾伟：[原创]谈谈WCF中的Data Contract（4）：WCF Data Contract Versioning

软件工程是一门独特的工程艺术,需要解决的是不断改变的需求变化.而对于WCF,对于SOA,由于涉及的是对多个系统之间的交互问题,如何有效地解决不断改变的需求所带来的问题就显得更为重要:Service端版本的变化能否保持现有Consumer的正常调用,Consumer端的改变不至于影响对Service 的正常调用.对于Data Contract来说就是要解决这样的问题:Service端或者Client对Data Type的改变不会影响Service的正常调用. 在系统开发过程中,通过对Data Ty

谈谈WCF中的Data Contract（3）

谈谈WCF中的Data Contract(3):WCF Data Contract对Collection & Dictionary的支持 在本篇文章上一部分Order Processing的例子中,我们看到原本已Collection形式定义的DetailList属性(public IList<TDetail> DetailList),在Data Contract中却以Array的方式体现(public OrderDetail[] DetailList).我们现在就来详细地讨论一下基于C

谈谈WCF中的Data Contract（2）：WCF Data Contract对Generic的支持

通过第一部分的介绍,我们可以体会到,WCF 的Data Contract在CLR Type和Neutral Contract之间搭建了一座桥梁,弥合了.NET世界和厂商中立世界的差异.通过WCF Data Contract我们将CLR Data Type暴露成一个厂商中立的数据结构的描述,同样通过WCF Data Contract我们将一个现有的CLR Data Type和既定的Neutral contract进行适配. 在.NET中,基于Primary Type,比如Int32,String等