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

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