JSON.NET 5中的架构变更

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中文站投稿或者参与内容翻译工作,请邮件至[email protected]。也欢迎大家通过新浪微博(@InfoQ)或者腾讯微博(@InfoQ)关注我们,并与我们的编辑和其他读者朋友交流。

你可能感兴趣的:(JSON.NET 5中的架构变更)