Json 簡介
Json (JavaScript Object Notation) 是一種輕量級的數據交換格式。它做爲目前最歡迎的數據交換格式,也是各大開源貢獻者的必爭之地,如:阿里爸爸的 fastjson(java),騰訊的 rapidjson(c++) 等。但 .Net 卻沒有獲得大廠的青睞,在 Swifter.Json 以前 .Net 的 Json 解析庫都不完美。
Swifter.Json 簡介
Swifter.Json 是 .Net 平臺上一個功能強大,簡單易用,穩定及高性能的 Json 序列化和反序列化工具。
Swifter.Json 強大之處
1:支持 .Net 已知全部對象結構,包括深度循環結構,引用類型屬性等。
2:支持幾乎全部經常使用的數據類型,並多方案輕鬆自定義類型的序列化行爲,後續將持續增長。
3:支持縮進 Json,忽略 Null 值 0 值 "" 值等,支持使用 { "$Ref" : "#/Target" } 表示重複引用,或將循環引用序列化爲 Null 等,支持設置最大深度。
4:支持 .Net Core 2.0+,.Net Framework 2.0+,.Net Standard 2.0+,Xamarin,Unify,Mono 等平臺。
5:Swifter.Json 幾乎是無 BUG 的,由於它已有多個上線項目在運行,且每次發佈都會通過咱們本身單元測試和 Newtonsoft.Json 和 Spanjson 的單元測試來確保它的穩定性,若是您遇到了問題,能夠在 Github 上發佈一個 issue,咱們會盡力幫助您。
6:完整全面的 API 中文文檔,每一個公開的類型和方法都有中文說明,也有 Github 上的 Wiki 文檔 (現主要維護文檔)。
爲何要重複造輪子?
目前 .Net 平臺上的 Json 庫都存在一些明顯的缺點:一些雖然簡單易用,可是性能不高,一些性能高卻不穩定,穩定的有性能低且過於複雜。
咱們迫切須要一個強大,穩定,高性能且易於使用的 Json 序列化工具!
Swifter.Json 的庫引用
Swifter.Core:這是一個工具包,它能夠爲類庫開發者提供巨大的幫助,Swifter.Json 基於它。它提供了高效的數據讀寫 API,高效的數學算法以及 .Net CLR 無數據信息,以及解決各平臺版本之間的差別問題等,後期咱們將基於這個庫開發一個 Swifter.MessagePack (已開發好,待發布)。這個庫 300~400KB 之間(各平臺有差別)。
Swifter.Unsafe:這是一個 IL 代碼編寫的庫,由於提供的操做與 System.Runtime.ComplierServices.Unsafe 提供的功能相似,因此取名叫 Swifter.Unsafe,這個庫大慨 5KB。
Swifter.Json:實現 Swifter.Json 的 IValueReader, IValueWriter 即實現了對任意對象執行序列化和反序列化,主要的代碼在 JsonSerializer (實現 IValueWriter) 和 JsonDeserializer (實現 IValueReader)中,JsonFormatter 提供 API重載,如今已支持全異步 API。這個庫大概 86KB。
Swifter.Json 的性能
.Net Core 3.0 Preview 7 的測試結果
相比 Newtonsoft.Json 提升了 5 到 10 倍左右,雖然目前已有許多 Json 庫號稱高性能,但實際上我承認的除Swifter.Json只有 Spanjson,但它缺點太明顯,僅支持 .Net Core 2.1+ 且穩定性很差。若是您不肯意使用 Swifter.Json,那本人建議您使用 Newtonsoft.Json,畢竟它除了性能以外全是優勢。
還有一個與性能密切相關一個特性:小分配。顧名思義就是分配的內存大小,舉例:當程序在執行反序列化數組操做時,由於對數組長度未知,因此多數 Json 工具都在這個過程當中反覆的建立更大的數組,這個過程至關耗時且耗資源。Swifter.Json 已使用池技術完美解決這個問題。Spanjson 也使用 Core 上的 ArrayPool 池解決,因此我爲 Spanjson 點了小星星。
簡單使用
更多使用方法和文檔請上 Github 查看 Wiki。
最後附上一張咱們對 .Net 平臺已有的 Json 庫一個簡單的評價