JSON.NET 5中的架构变更

jopen 12年前

  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