Gson Builder — Gson Lenient 属性

原文链接：Gson Builder — Exclusion Strategies
原文出自：Norman Peitek
译者：無名無

我们知道 JSON 必须符合一定的标准才能被解析成功，在 JsonReader 的源码中我们看到 Gson 遵循的是 RFC4627 规则,本文将介绍下 Gson 和 JSON 规范的关系。

默认的 Lenient

通常我们将 Java 对象序列化成 JSON 格式的数据时，并不会有什么太大的问题，此时的 JSON 将是一个标准的格式，重点是反序列化可能会有问题。

Gson 内部使用的是 JsonReader 类，看源码能发现里面有一个 lenient 的属性，默认是 false，也就是说默认值接受标准的 JSON 格式数据，如果数据有问题，将抛出异常解析失败。

JsonReader 也提供了设置 lenient 属性的方法，来忽略一些不标准的 JSON 数据格式。

这里就不多介绍了，以下是 setLenient 方法的源码介绍：

/**
   * Configure this parser to be liberal in what it accepts. By default,
   * this parser is strict and only accepts JSON as specified by <a
   * href="http://www.ietf.org/rfc/rfc4627.txt">RFC 4627</a>. Setting the
   * parser to lenient causes it to ignore the following syntax errors:
   *
   * <ul>
   *   <li>Streams that start with the <a href="#nonexecuteprefix">non-execute
   *       prefix</a>, <code>")]}'\n"</code>.
   *   <li>Streams that include multiple top-level values. With strict parsing,
   *       each stream must contain exactly one top-level value.
   *   <li>Top-level values of any type. With strict parsing, the top-level
   *       value must be an object or an array.
   *   <li>Numbers may be {@link Double#isNaN() NaNs} or {@link
   *       Double#isInfinite() infinities}.
   *   <li>End of line comments starting with {@code //} or {@code #} and
   *       ending with a newline character.
   *   <li>C-style comments starting with {@code /*} and ending with
   *       {@code *}{@code /}. Such comments may not be nested.
   *   <li>Names that are unquoted or {@code 'single quoted'}.
   *   <li>Strings that are unquoted or {@code 'single quoted'}.
   *   <li>Array elements separated by {@code ;} instead of {@code ,}.
   *   <li>Unnecessary array separators. These are interpreted as if null
   *       was the omitted value.
   *   <li>Names and values separated by {@code =} or {@code =>} instead of
   *       {@code :}.
   *   <li>Name/value pairs separated by {@code ;} instead of {@code ,}.
   * </ul>   */

不过我们建议还是要使用标准的 JSON 数据格式，除非你有特殊情况。

如果你开启了 lenient 方式，Gson 的只能帮我们忽略掉以上的格式错误，如果你的 JSON 中有其他错误，Gson 将会抛出 MalformedJsonException 异常，这样你必须要检查下你的 JSON 数据的合法性。

你可以通过这个网站 JSONLint 来校验你的 JSON 数据合法性。

目标

了解 Gson 的 setLenient 方法使用。

练习代码已上传 Github https://github.com/whiskeyfei/Gson-Review 可自行查看。

Gson 系列文章翻译回顾

1、Gson - Java-JSON 序列化和反序列化入门
2、Gson - 映射嵌套对象
3、Gson - Arrays 和 Lists 映射对象
4、Gson - Map 结构映射
5、Gson - Set 集合映射
6、Gson - 空值映射
7、Gson Model Annotations - 如何使用 @SerializedName 更改字段的命名
8、Gson Model Annotations - @SerializedName 匹配多个反序列化名称
9、Gson Builder - 基础和命名规则
10、Gson Builder - 序列化空值
11、Gson Builder - 忽略策略
12、Gson Builder - Gson Lenient 属性
13、Gson Builder - 特殊类型 Floats & Doubles
17、Gson Builder - 如何使用 @Expose 忽略字段
19、Gson Advanced - 映射枚举类型
20、Gson Advanced - 映射循环引用
21、Gson Advanced - 泛型
22、Gson Advanced - 简单自定义序列化 (Part 1)
24、Gson Advanced - 自定义反序列化基础
25、Gson Advanced - 自定义对象实例创建
26、Gson Advanced - 通过 @JsonAdapter 自定义(反)序列化过程
32、Practical Gson - 如何解析多态对象