在C#中使用Json.Net進行序列化和反序列化及定製化

Minotauros發表於2019-05-24

  序列化(Serialize)是將物件轉換成位元組流,並將其用於儲存或傳輸的過程,主要用途是儲存物件的狀態,以便在需要時重新建立該物件;反序列化(Deserialize)則是將上面的位元組流轉換為相應物件的過程;在.Net陣營中,Json.Net是由官方推薦的高效能開源序列化/反序列化工具,其官方網站:https://www.newtonsoft.com/json

  一、將物件序列化為Json格式字串

  首先是正常的序列化操作,對於給定的類:

private class MyClass
{
    public int MyNum;
    public string MyStr;
}

  將該類的例項序列化為Json格式字串,首先引用名稱空間Newtonsoft.Json:

MyClass myClass = new MyClass { MyNum = 10, MyStr = "Hello World" };
Console.WriteLine(JsonConvert.SerializeObject(myClass));

  其列印結果:

{"MyNum":10,"MyStr":"Hello World"}

  在列印到本地Log檔案以供自己檢視使用時,可以選擇轉換為帶有縮排的Json格式字串:

Console.WriteLine(JsonConvert.SerializeObject(myClass, Formatting.Indented));

  此時列印結果為:

{
  "MyNum": 10,
  "MyStr": "Hello World"
}

  二、將Json格式字串反序列化為物件

  對於給定的字串:

string jsonStr = @"{""MyNum"": 10,""MyStr"": ""Hello World""}";

  將其反序列化為MyClass型別的物件:

MyClass myClass = JsonConvert.DeserializeObject<MyClass>(jsonStr);
Console.WriteLine(myClass.MyStr); //Hello World

  三、使用JObject動態序列化/反序列化

  以上例子都是使用強型別進行序列化和反序列操作,但有時也會用到不指定型別而直接操作Json格式資料的情況,此時就需要用位於名稱空間ewtonsoft.Json.Linq中的JObject型別的物件:

string jsonStr = @"{""MyNum"": 10,""MyStr"": ""Hello World""}";
JObject jObject = JObject.Parse(jsonStr);
Console.WriteLine(jObject.ToString(Formatting.None));  //{"MyNum":10,"MyStr":"Hello World"}
//列印一條屬性的值
Console.WriteLine(jObject["MyStr"].Value<string>());  //Hello World
//新增一條屬性
jObject.Add("MyStr2", "HaHa");
//列印當前Json字串
Console.WriteLine(jObject.ToString(Formatting.None)); //{"MyNum":10,"MyStr":"Hello World","MyStr2":"HaHa"}

  四、定製化序列化/反序列過程

  1.在C#中,定製化的配置通常使用特性來完成,這裡也不例外,例如簡單的,在序列化/反序列時忽略某個欄位/屬性:

private class MyClass
{
    [JsonIgnore]
    public int MyNum;
    public string MyStr;
}

  此時,無論序列化還是反序化時,欄位MyNum都不再參與這些過程;

  2.自定義某個欄位/屬性的序列化/反序列化規則:

  當接收到的Json格式字串與本地已有型別不統一時,需要進行自定義的反序列化過程,反之亦然,例如Json字串中以字串"TRUE"表示布林型別true(不自定義,這個過程依然走的通,只是以此舉例),以字串"FALSE"表示布林型別false時,需要自定義如下:

/// <summary>
/// 自定義布林型別資料轉換規則
/// </summary>
public class MyBoolConverter : JsonConverter
{
    private const string TrueStr = "TRUE";
    private const string FalseStr = "FALSE";
    public override bool CanConvert(Type objectType) => true;

    //反序列化
    public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
    {
        if (reader.ValueType == typeof(string))
        {
            if ((string)reader.Value == TrueStr)
            {
                return true;
            }
            else
            {
                return false;
            }
        }
        return false;
    }

    //序列化
    public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer)
    {
        if (value.GetType() == typeof(bool))
        {
            bool result = (bool)value;
            if (result)
            {
                writer.WriteValue(TrueStr);
            }
            else
            {
                writer.WriteValue(FalseStr);
            }
        }
    }
}

  然後,在需要操作的型別定義中的欄位/屬性中加入該特性:

private class MyClass
{
    [JsonConverter(typeof(MyBoolConverter))]
    public bool MyBool;
}

  此時:

string jsonStr = @"{""MyBool"": ""TRUE""}";
MyClass1 myClass = JsonConvert.DeserializeObject<MyClass1>(jsonStr);
Console.WriteLine(myClass.MyBool);  //True
Console.WriteLine(JsonConvert.SerializeObject(myClass));  //{"MyBool":"TRUE"}

 


如果您覺得閱讀本文對您有幫助,請點一下“推薦”按鈕,您的認可是我寫作的最大動力!

作者:Minotauros
出處:https://www.cnblogs.com/minotauros/

本文版權歸作者和部落格園共有,歡迎轉載,但未經作者同意必須保留此段宣告,且在文章頁面明顯位置給出原文連線,否則保留追究法律責任的權利。

相關文章