Json.NET特殊處理64位長整型數據

　　很多ASP.NET項目，尤其是使用了Ajax的項目，常常需要返回JSON格式的數據。.NET框架從3.5版本開始提供了JSON的序列化和反序列化工具，不過個人感覺不太好用，后來找了第三方的Newtonsoft.Json來用。再后來，在MVC4中，微軟已經默認使用Json.NET（Newtonsoft.Json）來處理JSON數據了。

　　JavaScript數值精度是32位，如果整數數度超過32位，就會被當作浮點數處理。換句話說，如果從服務端生成的JSON，某個值是64位整數，傳到前端JavaScript，再傳回服務端，不做任何運算，都可能出現失真。做個實驗：

> var a = 123456789012345678
> console.log(a);
123456789012345680

　　很要命的一點是，數據庫設計中常常會用bigint(64位)整數來作為主鍵，是一個非常重要而且不能有偏差的數據，比如，一個模型：

// C# 匿名對象
new {
    id: 123456789012345678L,
    name: "James"
};

　　轉換成JSON輸出到前端是：

{"id":123456789012345678,"name":"James"}

　　通過Ajax取得的對象輸出就有點不妙了

$.getJSON("/api/test").done(function(jo) {
    console.log(jo);
});
// Object {id: 123456789012345680, name: "James"}

　　顯然，這個對象修改數值之后再傳回服務器，就會找不到主鍵，或者更新成錯誤的數據，造成一個不易發現的巨大BUG。

　　解決辦法當然是有的，JavaScript處理字符串的能力非常強，完全可以把服務器端的64位整數處理成字符串類型。不過 Json.NET 默認是把 long 處理成 number 類型的，如果要處理成 string 類型，需要自定義一個JsonConverter。

　　考慮到用十六進制表示的整數看起來比較整齊，所以定義一個HexLongConverter來轉換long/ulong型數據與16進制表示的字符串。

public class HexLongConverter : JsonConverter
{
    public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer)
    {
        // 由于CanConvert過濾，數據類型只可能是long或ulong
        // 統一轉換成long類型處理
        long v = value is ulong ? (long)(ulong)value : (long)value;
        writer.WriteValue(v.ToString("X16"));
    }
    public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
    {
        // 取得讀到的十六進制字符串
        string hex = reader.Value as string;
        // 調用ToInt64擴展將字符串轉換成long型
        // ToInt64擴展方法后附
        long v = hex.ToInt64(NumberStyles.HexNumber, 0L);
        // 將v轉換成實際需要的類型 ulong 或 long(不轉換)
        return typeof (ulong) == objectType ? (object) (ulong) v : v;
    }
    public override bool CanConvert(Type objectType)
    {
        // 只處理long和ulong兩種類型的數據
        switch (objectType.FullName)
        {
            case "System.Int64":
            case "System.UInt64":
                return true;
            default:
                return false;
        }
    }
}

　　上面的代碼用到了一個string的擴展方法ToInt32：

public static class StringExtention
{
    public static int ToInt32(this string me, NumberStyles style,
        int defaultValue)
    {
        int? value = me.ToInt32(style);
        return value == null ? defaultValue : value.Value;
    }
}

　　在序列化或反序列化模型的時候，只需要加入HexLongConverter對象作為參數即可：

// 序列化
string json = JsonConvert.SerializeObject(model, new HexLongConverter());
// 反序列化
SomeModal model = JsonConvert.DeserializeObject<model>(json, new HexLongConverter));

相關鏈接：

[Json.NET]

• http://json.codeplex.com/

• http://james.newtonking.com/json