Newtonsoft 对 JSON.NET 进行了两个架构升级,以使其能够更容易地在涉及第三方库的项目中使用。这两个特性是默认设置和扩展数据。
在 JSON.NET 5r5 中,开发者可以使用 JsonSerializerSettings 类重写序列化 / 反序列化选项。每次调用 JsonConvert 方法的时候通常都会将它作为参数传入,或者用它创建新的 JsonSerializer。
如果类库想要使用新的默认模式,那么可以使用 JsonSerializer.CreateDefault 方法。这样便会使用应用通过 JsonConvert.DefaultSettings 方法定义的默认项。如果类库不想使用此行为,那么可以继续正常地创建 JsonSerializer 的实例。
应该注意的是,JsonConvert.DefaultSettings 方法的参数是一个 Func
另一个变化是对扩展数据的支持。这些数据在原生 JSON 有效负荷中有效,但不会在类结构中出现。一般来说,这会在服务器定义发生改变而客户端尚未升级到匹配版本时发生。
在 WCF 中,可以通过 IExtensibleDataObject 接口获取扩展数据。它为 ExtensionDataObject 类型提供了一个单独的属性,一个几乎没有什么作用的不透明类。ExtensionDataObject 包含的任何数据只对数据协定序列化器有效。这意味着,它只在极其特殊的情况下才会发挥作用,例如我们将一些数据序列化,使用旧版本的代码将其反序列化,重新序列化,接下来再次使用原始版本反序列化的情况。
JSON.Net 将扩展数据以字串和 JToken 对象字典的形式暴露。该字典通过使用 [JsonExtensionData] 属性标记的属性或域对外暴露。通过使用属性而不是接口,开发者可以将域标记为私有以维持封装。
查看英文原文: Architectural Changes in JSON.NET 5
感谢孙镜涛对本文的审校。
给InfoQ 中文站投稿或者参与内容翻译工作,请邮件至 editors@cn.infoq.com 。也欢迎大家通过新浪微博( @InfoQ )或者腾讯微博( @InfoQ )关注我们,并与我们的编辑和其他读者朋友交流。
评论