JSON.NET 5 中的架构变更

  • Jonathan Allen
  • 李彬

2013 年 5 月 20 日

话题:.NET语言 & 开发

Newtonsoft 对 JSON.NET 进行了两个架构升级,以使其能够更容易地在涉及第三方库的项目中使用。这两个特性是默认设置和扩展数据。

JSON.NET 5r5中,开发者可以使用 JsonSerializerSettings 类重写序列化 / 反序列化选项。每次调用 JsonConvert 方法的时候通常都会将它作为参数传入,或者用它创建新的 JsonSerializer。

如果类库想要使用新的默认模式,那么可以使用 JsonSerializer.CreateDefault 方法。这样便会使用应用通过 JsonConvert.DefaultSettings 方法定义的默认项。如果类库不想使用此行为,那么可以继续正常地创建 JsonSerializer 的实例。

应该注意的是,JsonConvert.DefaultSettings 方法的参数是一个 Func<JsonSerializerSettings> 而不是 JsonSerializerSettings 的实例。这意味着每次需要的时候都将创建默认 JsonSerializerSettings 的一个新副本。

另一个变化是对扩展数据的支持。这些数据在原生 JSON 有效负荷中有效,但不会在类结构中出现。一般来说,这会在服务器定义发生改变而客户端尚未升级到匹配版本时发生。

在 WCF 中,可以通过 IExtensibleDataObject 接口获取扩展数据。它为 ExtensionDataObject 类型提供了一个单独的属性,一个几乎没有什么作用的不透明类。ExtensionDataObject 包含的任何数据只对数据协定序列化器有效。这意味着,它只在极其特殊的情况下才会发挥作用,例如我们将一些数据序列化,使用旧版本的代码将其反序列化,重新序列化,接下来再次使用原始版本反序列化的情况。

JSON.Net 将扩展数据以字串和 JToken 对象字典的形式暴露。该字典通过使用 [JsonExtensionData] 属性标记的属性或域对外暴露。通过使用属性而不是接口,开发者可以将域标记为私有以维持封装。

查看英文原文Architectural Changes in JSON.NET 5


感谢孙镜涛对本文的审校。

给 InfoQ 中文站投稿或者参与内容翻译工作,请邮件至editors@cn.infoq.com。也欢迎大家通过新浪微博(@InfoQ)或者腾讯微博(@InfoQ)关注我们,并与我们的编辑和其他读者朋友交流。

.NET语言 & 开发