wcf服務編程ch5數(shù)據(jù)協(xié)定和消息協(xié)定.ppt

BF-TECH 4.0 DNET 軟件開發(fā)工程師高薪就業(yè)品牌課程 版權所有：北風網(wǎng),使用WCF搭建企業(yè)通用架構 講師：石曼迪,第五章：數(shù)據(jù)協(xié)定和消息協(xié)定,目錄,數(shù)據(jù)協(xié)定名稱 數(shù)據(jù)協(xié)定等效性 數(shù)據(jù)協(xié)定版本管理,數(shù)據(jù)協(xié)定,數(shù)據(jù)協(xié)定”是在服務與客戶端之間達成的正式協(xié)議，用于以抽象方式描述要交換的數(shù)據(jù)。 也就是說，為了進行通信，客戶端和服務不必共享相同的類型，而只需共享相同的數(shù)據(jù)協(xié)定。 數(shù)據(jù)協(xié)定為每個參數(shù)或返回類型精確定義為進行交換而序列化哪些數(shù)據(jù)（將哪些數(shù)據(jù)轉換為 XML）。 必須為所創(chuàng)建的新復雜類型定義數(shù)據(jù)協(xié)定才能序列化這些類型。 所有.NET基元類型以及CLR支持的其他類型均默認就支持可序列化協(xié)定。,數(shù)據(jù)協(xié)定,正常情況下可通過將 DataContractAttribute 屬性應用到該類型來完成該任務。 可以將此屬性應用到類、結構和枚舉。 然后必須將 DataMemberAttribute 屬性應用到數(shù)據(jù)協(xié)定類型的每個成員，以指示這些成員為數(shù)據(jù)成員，即應進行序列化。 可以使用 IgnoreDataMemberAttribute 從序列化中剔除某些成員。 還可以使用 DataContractAttribute 和 DataMemberAttribute 屬性顯式創(chuàng)建數(shù)據(jù)協(xié)定。,數(shù)據(jù)協(xié)定,僅當用于未標記的類型時，才接受 IgnoreDataMemberAttribute 屬性。 沒有使用DataMemberAttribute 的屬性將不會被序列化。 可以將 DataMemberAttribute 屬性 (Attribute) 應用于字段和屬性 (Property)。 成員可訪問性級別（internal、private、protected 或 public）對數(shù)據(jù)協(xié)定無任何影響。 如果將 DataMemberAttribute 屬性應用于靜態(tài)成員，則將忽略該屬性。 在序列化期間，為屬性數(shù)據(jù)成員調用 property-get 代碼來獲取要序列化的屬性的值。 在反序列化期間，首先創(chuàng)建一個未初始化的對象，而不在該類型上調用任何構造函數(shù)。 然后反序列化所有數(shù)據(jù)成員。 在反序列化期間，為屬性數(shù)據(jù)成員調用 property-set 代碼，將屬性設置為要反序列化的值。 對于將要生效的數(shù)據(jù)協(xié)定，它必須能序列化其所有數(shù)據(jù)成員。 有關可序列化類型的完整列表，請參見數(shù)據(jù)協(xié)定序列化程序支持的類型。 泛型類型的處理方式與非泛型類型完全相同。 泛型參數(shù)無特殊要求。,數(shù)據(jù)協(xié)定,ServiceContract public interface ISampleInterface OperationContract System.Drawing.Bitmap GetPicture(System.Uri pictureUri); OperationContract bool ApprovePurchaseOrder(MyTypes.PurchaseOrder po); ,DataContract public class PurchaseOrder private int poId_value; DataMember public int OrderIdget;set; IgnoreDataMember public int OrderPwdget;set; ,數(shù)據(jù)協(xié)定：其他約束,泛型或者自定義復雜嵌套類型必須成員全部能夠被序列化時他本身才能夠被序列化,DataContract public class MyGenericType2 DataMember T theData; ,數(shù)據(jù)協(xié)定名稱,有時，客戶端和服務不共享相同的類型。 他們仍然可以將數(shù)據(jù)傳遞給對方，只要數(shù)據(jù)合同是雙方等效。 完全限定的數(shù)據(jù)協(xié)定名稱由命名空間和名稱組成。 數(shù)據(jù)成員只有名稱，而沒有命名空間。 處理數(shù)據(jù)協(xié)定時，WCF 基礎結構對于命名空間以及數(shù)據(jù)協(xié)定和數(shù)據(jù)成員的名稱區(qū)分大小寫。,數(shù)據(jù)協(xié)定名稱,數(shù)據(jù)協(xié)定命名采用同意資源標識符（URI）形式 默認情況下是自己的命名空間名，但是可以通過設置 DataContractAttribute 的 Namespace 屬性改寫 給定字段或屬性的默認數(shù)據(jù)成員名稱是該字段或屬性的名稱。 若要重寫默認值，請將 DataMemberAttribute 的 Name 屬性設置為其他值。,數(shù)據(jù)協(xié)定：等效性,要使數(shù)據(jù)成員等效，其名稱必須相同。 此外，它們還必須表示同一類型的數(shù)據(jù)，也就是說，其數(shù)據(jù)協(xié)定必須等效。 如果同一端（發(fā)送方或接收方）存在兩種類型，而其數(shù)據(jù)協(xié)定又不等效（例如，它們的數(shù)據(jù)成員不同），則不應為它們指定相同的名稱和命名空間。 否則，可能會引發(fā)異常。,數(shù)據(jù)協(xié)定：等效性,數(shù)據(jù)成員順序和數(shù)據(jù)協(xié)定等效性 使用 DataMemberAttribute 類的 Order 屬性可能會影響數(shù)據(jù)協(xié)定等效性。 其成員必須以相同順序出現(xiàn)，數(shù)據(jù)協(xié)定才能等效。 默認順序是按字母順序。 繼承、接口和數(shù)據(jù)協(xié)定等效性 確定等效性時，對于從其他數(shù)據(jù)協(xié)定繼承的數(shù)據(jù)協(xié)定，將被視為一個包含所有基類型的數(shù)據(jù)成員的數(shù)據(jù)協(xié)定。,數(shù)據(jù)協(xié)定：等效性,以下是等效的,DataContract public class Customer DataMember public string fullName; DataMember public string telephoneNumber; ,DataContract(Name = “Customer“) public class Person DataMember(Name = “fullName“) private string nameOfPerson; private string address; DataMember(Name = “telephoneNumber“) private string phoneNumber; ,數(shù)據(jù)協(xié)定：等效性,以下是等效的,DataMember public int X; DataMember public int Y;,DataMember public int Y; DataMember public int X;,DataMember(Order = 2) public int Y; DataMember(Order = 1) public int X;,DataMember(Order = 1) public int Y; DataMember(Order = 2) public int X;,不等效,數(shù)據(jù)協(xié)定：已知類型,在數(shù)據(jù)到達接收終結點時，WCF 運行庫嘗試將數(shù)據(jù)反序列化為公共語言運行庫 (CLR) 類型的實例。 通過首先檢查傳入消息選擇為反序列化而實例化的類型，以確定消息內容遵循的數(shù)據(jù)協(xié)定。 然后反序列化引擎嘗試查找實現(xiàn)與消息內容兼容的數(shù)據(jù)協(xié)定的 CLR 類型。 反序列化引擎在此過程中允許的侯選類型集稱為反序列化程序的“已知類型”集。 已知類型： 發(fā)送的數(shù)據(jù)協(xié)定源自預期的數(shù)據(jù)協(xié)定 要傳輸?shù)穆暶黝愋褪墙涌?、不是類結果或枚舉 要傳輸?shù)念愋褪荗BJECT 有些類型是具有上述類別之一成員類型的數(shù)據(jù)類型，如HashTable,數(shù)據(jù)協(xié)定：已知類型,讓反序列化引擎了解某個類型的一種方法是使用 KnownTypeAttribute。 不能將屬性應用于單個數(shù)據(jù)成員，只能將它應用于整個數(shù)據(jù)協(xié)定類型。 將屬性應用于可能為類或結構的“外部類型”。 可以將多個 KnownTypeAttribute 屬性應用于同一類型。,數(shù)據(jù)協(xié)定：版本管理,重大更改非重大更改 對數(shù)據(jù)協(xié)定的更改可能是重大更改，也可能是非重大更改。 對數(shù)據(jù)協(xié)定進行非重大更改時，使用較早版本協(xié)定的應用程序和使用較新版本協(xié)定的應用程序可以互相通信。 另一方面，如果進行重大更改，則會阻止單向或雙向通信 對類型的任何更改，只要不影響其傳輸方式和接收方式，都是非重大更改,DataContract public class Person DataMember private string Phone; ,DataContract public class Person DataMember(Name = “Phone“) private string Telephone; ,非重大更改,數(shù)據(jù)協(xié)定：版本管理,下面的更改始終是重大更改： 更改數(shù)據(jù)協(xié)定的 Name 或 Namespace 值。 通過 DataMemberAttribute 的 Order 屬性來更改數(shù)據(jù)成員的順序。 重命名數(shù)據(jù)成員。 更改數(shù)據(jù)成員的數(shù)據(jù)協(xié)定。 例如，將數(shù)據(jù)成員的類型從整數(shù)更改為字符串，或者從數(shù)據(jù)協(xié)定名稱為“Customer”的類型更改為數(shù)據(jù)協(xié)定名稱為“Person”的類型。 添加或移除數(shù)據(jù)成員 ,消息協(xié)定,通常使用MessageContract定義，在需要精確控制將類型映射到網(wǎng)絡傳輸?shù)腟OAP消息時使用 最常見的做法是插入自定義SOAP頭,MessageContract Public class BankingTranscation MessageHeader Public Operation operation; MessageHeader Public DateTim