Swifter.Json

Github

Wiki

如果您打算使用 Swifter.Json，请在 Nuget 包管理上安装

在 .Net 平台上的一个功能强大，简单易用，稳定又不失高性能的 JSON 序列化和反序列化工具。

Swifter.Json 已经经过了大量测试和线上项目中运行许久来确保它的稳定性。

特性

1: 支持 .Net 上绝大多是的数据类型，且轻松扩展；包括但不限于：实体，字典，集合，迭代器，数据读取器和表格。

2: 支持 .Net 我已知的大多数平台，包括但不限于：.Net Framework 2.0+, .Net Core 2.0+, .Net Standard 2.0+, Mono, Xamarin, Unity(测试版本为 2018.3).

3: 它几乎是无 BUG 的，如果您遇到了问题，可以在 Github 上发布一个 issue，或者 QQ:1287905882，我会尽力帮助您。

4：所有公开成员都有中文说明，中文语言人的福音😄；将来可能添加英文说明。

平台兼容性 ✓：兼容大多数平台的大多数版本；乄：兼容部分平台，且版本要求较高；✗：只能在单一平台上运行。

稳定性 ✓：在大多数测试中未出现 BUG；乄：一些不常见操作会出现 BUG；✗：常见操作会出现 BUG。

功能性 ✓：支持大多数的数据类型和方法；乄：支持常用的数据类型和方法；✗：部分常用数据类型和方法不支持。

扩展性 ✓：高度允许自定义格式和处理方式；乄：支持常用的格式设置；✗：不能自定义格式。

高性能 ✓：相比 Newtonsoft 平均快 4x 以上；乄：相比 Newtonsoft 平均快 2x 以上；✗：相比 Newtonsoft 差不多或者更慢。

小分配(内存) ✓：执行过程中分配的内存极少；乄：必要的内存占用较少；✗：执行过程中分配的大量的临时内存。

大小(文件) ✓：小于 100KB；乄：大于 100KB 小于 500 KB；✗：大于 500 KB。

部分 .Net 现有的 JSON 工具性能对比

.Net Core 3.0 Previews running results.

.Net Framework 4.7.1 Previews running results.

图中的数字代表用时(ms). 表格颜色随用时从 绿色 渐变为 黄色。当用时超过 3 倍时将以亮黄色显示。

Swifter.Json 第一次执行需要额外的时间来生成一个 “操作类(FastObjectRW<T>)” 后续会越来越快。所以如果您的程序需要长期运行，那么 Swifter.Json 是您优的选择。如果您的程序不适用这种模式，那么 Swifter.Reflection 的 XObjectRW<T> 也许适合您，详情请看 Wiki。

简单使用

    public class Demo
    {
        public int Id { get; set; }

        public string Name { get; set; }

        public static void Main()
        {
            var json = JsonFormatter.SerializeObject(new { Id = 1, Name = "Dogwei" });
            var dic = JsonFormatter.DeserializeObject<Dictionary<string, object>>(json);
            var obj = JsonFormatter.DeserializeObject<Demo>(json);;
        }
    }

更新历史

1.2.5 更新：

1：因为更新时疏忽了 Swifter.Core 的引用关系，所以跳过了 1.2.3 和 1.2.4 版本。

2：增加了对类似 1_000_1000 这样的数字值的支持。

2：允许字符串键和值不使用引号包裹！（这样的字符串不能使用前后空格，也不能使用转义符）

4：终于魔鬼战胜了天使，Swifter.Json 终于牺牲的部分性能，成了完全验证的 Json 解析器（除了点 2 和点 3）。

1.2.2 更新:

1：增加了异步方法，JsonFormatter 中以 Async 结尾的方法均为异步方法。

2：修改 Swifter.Extensions.AspNetCore 的扩展使用异步方法。

1.2.1 更新:

1：再度提高性能 (主要原理是对不常见行为禁止内联，提高常见行为的内联成功率)。

2：解决枚举序列化出错，ValueInterface<T>.SetInterface() 不起作用等 BUG。

3：增加特性定义 (反)序列化行为 ([RWFormat], [RWField], [RWObject] 等特性)。

4：增加 AspNetCore 的扩展方法 ConfigureJsonFormatter(this IServiceCollection services)。现在可以很方便将 Swifter.Json 配置到 MVC 了。

5：新增 JsonValue 类，此类可以表示 JSON 反序列化时的任何值（包括对象和数组）。