弱型別 JSON 序列化範例

當將使用者定義的型別序列化為指定的 Wire 格式，或是將 Wire 格式還原序列化為使用者定義的型別時，服務和用戶端都必須提供指定的使用者定義型別，以供使用。 一般而言，若要完成這項操作， DataContractAttribute 屬性會套用至這些使用者定義的型別，而 DataMemberAttribute 屬性會套用至其成員。 這個機制也適用於使用 JavaScript Object Notation (JSON) 物件的情況，如主題 How to: Serialize and Deserialize JSON Data中所述。

在某些案例中，Windows Communication Foundation (WCF) 服務或用戶端必須存取不受開發人員控制的服務或用戶端所產生的 JSON 物件。 隨著更多的 Web 服務公開 JSON API，WCF 開發人員建構本機使用者定義的型別以在其中還原序列化任意 JSON 物件，會變得不切實際。

WeaklyTypedJson 範例會提供機制，讓 WCF 開發人員可使用已還原序列化的任意 JSON 物件，而不需建立使用者定義的型別。 這稱為 JSON 物件的「 弱型別序列化 」(Weakly-Typed Serialization)，因為在編譯時期尚不知 JSON 物件要還原序列化成何種型別。

例如，公用 Web 服務 API 會傳回下列 JSON 物件，此物件描述有關服務的使用者的一些資訊。

{"personal": {"name": "Paul", "age": 23, "height": 1.7, "isSingle": true, "luckyNumbers": [5,17,21]}, "favoriteBands": ["Band ABC", "Band XYZ"]}

若要還原序列化這個物件，WCF 用戶端必須實作下列使用者定義的型別。

[DataContract]
public class MemberProfile
 {
     [DataMember]
     public PersonalInfo personal;

     [DataMember]
     public string[] favoriteBands;
 }

 [DataContract]
public class PersonalInfo
 {
     [DataMember]
     public string name;

     [DataMember]
     public int age;

     [DataMember]
     public double height;

     [DataMember]
     public bool isSingle;

     [DataMember]
     public int[] luckyNumbers;
 }

這可能會很麻煩，特別是如果用戶端必須處理一種以上的 JSON 物件型別。

JsonObject此範例所提供的類型引進還原串行化 JSON 物件的弱型別表示法。 JsonObject 需依賴 JSON 物件與 .NET Framework 字典之間的自然對應，以及 JSON 陣列與 .NET Framework 陣列之間的對應。 下列程式碼會顯示 JsonObject 型別。

// Instantiation of JsonObject json omitted

string name = json["root"]["personal"]["name"];
int age = json["root"]["personal"]["age"];
double height = json["root"]["personal"]["height"];
bool isSingle = json["root"]["personal"]["isSingle"];
int[] luckyNumbers = {
                                     json["root"]["personal"]["luckyNumbers"][0],
                                     json["root"]["personal"]["luckyNumbers"][1],
                                     json["root"]["personal"]["luckyNumbers"][2]
                                 };
string[] favoriteBands = {
                                        json["root"]["favoriteBands"][0],
                                        json["root"]["favoriteBands"][1]
                                    };

請注意，您可以「瀏覽」JSON 物件和陣列，而不需要在編譯時宣告它們的型別。 如需最上層 ["root"] 物件之需求的說明，請參閱主題 Mapping Between JSON and XML中所述。

若要使用 JsonObject 型別，用戶端作業合約必須使用 Message 做為其傳回型別。

[ServiceContract]
    interface IClientSideProfileService
    {
        // There is no need to write a DataContract for the complex type returned by the service.
        // The client will use a JsonObject to browse the JSON in the received message.

        [OperationContract]
        [WebGet(ResponseFormat = WebMessageFormat.Json)]
        Message GetMemberProfile();
    }

然後， JsonObject 會具現化，如下列程式碼所示。

// Code to instantiate IClientSideProfileService channel omitted…

// Make a request to the service and obtain the Json response
XmlDictionaryReader reader = channel.GetMemberProfile().GetReaderAtBodyContents();

// Go through the Json as though it is a dictionary. There is no need to map it to a .NET CLR type.
JsonObject json = new JsonObject(reader);

JsonObject 建構函式會採用透過 XmlDictionaryReader方法取得的 GetReaderAtBodyContents 。 讀取器包含用戶端所接收之 JSON 訊息的 XML 表示。 如需詳細資訊，請參閱 JSON 與 XML 之間的對應主題。

此程式會產生下列輸出：

Service listening at http://localhost:8000/.
To view the JSON output from the sample, navigate to http://localhost:8000/GetMemberProfile
This is Paul's page. I am 23 years old and I am 1.7 meters tall.
I am single.
My lucky numbers are 5, 17, and 21.
My favorite bands are Band ABC and Band XYZ.

若要安裝、建置及執行範例

1. 確定您已執行 Windows Communication Foundation 範例的一次性安裝程序。

2. 依照 Building the Windows Communication Foundation Samples所述，建置方案 WeaklyTypedJson.sln。

3. 執行方案。