Programming WCF Services 学习笔记三、Data Contract

 

1.         Serialization

                         i.              DataContract保护在Service Metadata中，客户端需要把DataContract转换为可使用的本地类型

                       ii.              .Net使用序列化来传递DataContract

                      iii.              一次客户端调用的序列化过程：

                      iv.             

                       v.              DataContract不会被序列化，除非打[Serializable] Attribute

                      vi.              对于有些临时性的属性（例如数据库连接），要打[NonSerialized] Attribute，禁止序列化，在反序列化时再恢复

                    vii.              .Net提供了两种序列化的格式：二进制和SOAP，但都不适用于WCF或SQA的场景，因为他们都序列化了所有用到的类型信息（可能依赖于.NET Framework），这对于客户端是不可接受的，因为WCF允许不同类型的客户端

                   viii.              WCF提供了专门的序列化技术DataContractSerializer，它只序列化DataContract数据而忽略类型信息

                      ix.              DataContract可以嵌套使用

                       x.              可以对DataContract进行事件跟踪，例如通过使用[OnDeserialized]在反序列化后恢复数据库连接

2.         Data Contract Hierarchy

                         i.              DataContract可以继承，但[DataContract] Attribute不允许继承，所以在继承树中的任何一个级别，都要显式使用[DataContract] Attribute

                       ii.              DataContract不能用子类代替父类使用，因为WCF在反序列化时不知道子类的结构，要想使用子类代替父类，要在父类定义时加[KnownType(typeof(子类))] Attribute

                      iii.              如果Client端要想使用子类代替父类的话，也要使用KnownType Attribute

                      iv.              应用在DataContract上的KnownType会影响所有使用此DataContract的ServiceContract，如果想在ServiceContract上控制的话，则使用ServiceKnownType Attribute，它可以在ServiceContract上，也可以在OperationContract上加，只会影响当前的ServiceContract或OperationContract

                       v.              ServiceKnownType Attribute不会被客户端感知，而会被感知为KnownType并且应用到对应当DataContract上，但用户可以修改客户端代理

                      vi.              可以在一个ServiceContract上使用多个ServiceKnownType Attribute，但有一点要记住，不要不添加父类就添加子类

                    vii.              可以把KnownType放到配置文件中：

system.runtime.serialization"dataContractSerializer"declaredTypes

                   viii.              如果名为Con的 DataContract实现了ICon接口的话，可以在OperationContract上接受ICon类型的参数，然后加[ServiceKnownType(typeof(Con))]，但不要再ServiceKnownType上使用Icon接口，因为Service的Metadata中不包括接口，只包括实现类和结构，Client Proxy会用Object类型代替Icon接口的参数类型，并加一个[ServiceKnownType(typeof(Object))]的Attribute，用户可以去掉此Attribute并添加ICon到声明并代替Object，但不能用Con代替Object（在Service端使用ICon的情况下）

3.         Data Contract Equivalence

                         i.              两个具有相同结构的DataContract是等价的，尽管名字不同，但可以使用DataMember Attribute的Name属性进行重命名

                       ii.              等价的DataContract的成员序列化顺序必须是一致的

                      iii.              可以使用DataMember的Order指定被序列化的顺序

4.         Versioning

                         i.              New Member

1.         当Service/Client发送具有New Member的DatcContract到另一端时，数据被正确接收，但New Member将被忽略

                       ii.              Missing Member

1.         当Service/Client发现接受到的DataContract有Missing Member时，将会赋予其默认值，而不会有任何动作

2.         可以使用OnDeserializing事件赋予Missing Member正确的值

3.         可以使用DataMember的IsRequired=True 强制DataMember必须被赋值

4.         当在DataContract上使用[Serializable] Attribute时，每个DataMember都的IsRequired都被设为True

5.         如果想在[Serializable]中使用可选DataMember，可以使用[OptionalField] Attribute

                      iii.              Versioning Round-Trip

1.         当遇到New-Old-New的场景时，DataContract中的New Member在Old端会丢失掉，从而使最后一步获取不到正确的信息。为了解决这个问题，可以让DataContract实现IExtensibleDataObject接口，New Member在序列化时会存入此接口的ExtensionData中而不会丢失

2.         可以在ServiceContract上使用[ServiceBehavior(IgnoreExtensionDataObject = ture)]使此ServiceContract忽略所有的Unknown Data Member

5.         Enumerations

                         i.              枚举可以自动被序列化，而不用使用DataContract Attribute

                       ii.              要想排除枚举中的某个值，可以使用[EnumMember] Attribute显式标记，不标记的即被排除

                      iii.              [EnumMember]还可以使用Value属性给值命名

6.         Delegates and Data Contracts

                         i.              Delegates可以自动被序列化

                       ii.              事件可以被序列化，但需要使用[field:DataMember] Attribute

                      iii.              实际上，Delegate引用的是本地的方法，传递本地方法的引用到Service的另一端是没有意义的，所以传递Delegate也是没有意义的，尽管WCF不会报错

                      iv.              要排除对Delegate的序列化，可以不使用DataMember，或在Serializable时使用[NonSerialized]

7.         Data Sets and Tables

                         i.              DataSet和DataTable可以在ServiceContract中使用，因为他们能被序列化，但生产Proxy时只会生成DataSet和DataTable的架构定义，客户可以把他们移除掉而使用ADO.NET代替

                       ii.              可以使用强类型的DataSet和DataTable，客户端会生成相应的代码

8.         Generics

                         i.              DataContract上可以使用泛型，但ServiceContract上不允许接收泛型参数，因为客户端不止是.NET平台，ServiceContract上要使用具体的类型参数

                       ii.              客户端生成Proxy时会为DataContract生成<类名>Of<泛型类型><哈希值>

                      iii.              当使用自定义的泛型类型时，才会有<哈希值>，但可以对泛型DataContract使用Name属性命名来避免出现<哈希值>

9.         Collections

                         i.              ServiceContract中可以使用Collection，但元数据中不会包含Collection，会转换成Array

                       ii.              只要Collection中有Add（）方法，就可以把Collection转换成Array

                      iii.              可以使用CollectionDataContract Attribute使客户端生成泛型而取代Array，从而使接口一致

                      iv.              可以在Client端引用CllectionType来使用Client端的类型（使用SvcUtil /ct）

                       v.              Client可以修改Proxy的代码，用Collection代替Array

                      vi.              ServiceContract中可以是用迭代，但（.net3.0）不能使用yield return 立即返回(3.0可以)

                    vii.              DataContract中可以使用Dictionary

(未完待续）