Gson Builder – 排除策略

在之前的文章中,我们介绍了一些控制哪些模型属性被(反)序列化的技术。 到目前为止,这一直是在属性层面。 我们可以一次更改一个元素的(反)序列化。 在这篇文章中,我们将研究一种设置更通用规则来控制哪些属性被转换的方法。

使用排除策略超越 transient 和@Expose

我们已经了解了 transient 和 @Expose,它们会更改单个属性的(反)序列化。 在接下来的内容里,我们将看看更通用的方法。 Gson 称它们为 ExclusionStrategies。 当然,您必须通过 GsonBuilder 设置它们。

在进入具体实现之前,让我们创建一个测试模型。 我们将使用一个新的 UserDate 模型,它有几个属性:

public class UserDate {  
    private String _name;
    private String email;
    private boolean isDeveloper;
    private int age;
    private Date registerDate = new Date();
}

请特别注意属性类型及其命名。 马上就会变得很重要。 假设我们要踢出所有属性,它们是 Date 或 boolean 类型。 我们可以使用 ExclusionStrategies 轻松做到这一点。 我们可以通过 GsonBuilder 实现它:

GsonBuilder gsonBuilder = new GsonBuilder();  
gsonBuilder.setExclusionStrategies(new ExclusionStrategy() {  
    @Override
    public boolean shouldSkipField(FieldAttributes f) {
        return false;
    }

    @Override
    public boolean shouldSkipClass(Class<?> incomingClass) {
        return incomingClass == Date.class || incomingClass == boolean.class;
    }
});
Gson gson = gsonBuilder.create();

UserDate user = new UserDate("Norman", "norman@futurestud.io", 26, true);  
String usersJson = gson.toJson(user);  

ExclusionStrategy 类有两个可以覆盖的方法。 我们在上面的例子中只使用了第二个选项。 我们检查了类是 Date 类型还是 boolean 类型。 如果该属性属于任一类型,则该函数将返回 true,而 Gson 将忽略它。 我们可以在此方法中进行任何类检查。 生成的 JSON 将仅包含 string 和 int 类型:

{
  "age": 26,
  "email": "zadmei_onmpw@163.com",
  "_name": "zadmei"
}

另一种方法提供了根据声明排除属性的选项。 例如,如果我们想要排除所有包含下划线 _ 的属性,除了上述规则,我们可以使用以下代码:

GsonBuilder gsonBuilder = new GsonBuilder();  
gsonBuilder.setExclusionStrategies(new ExclusionStrategy() {  
    @Override
    public boolean shouldSkipField(FieldAttributes f) {
        return f.getName().contains("_");
    }

    @Override
    public boolean shouldSkipClass(Class<?> incomingClass) {
        return incomingClass == Date.class || incomingClass == boolean.class;
    }
});
Gson gson = gsonBuilder.create();

UserDate user = new UserDate("Norman", "norman@futurestud.io", 26, true);  
String usersJson = gson.toJson(user);  

这将生成一个非常短的 JSON:

{
  "age": 26,
  "email": "zadmei_onmpw@163.com"
}

我们可以将排除策略用于许多不同的场景。 如果有一些特定(反)序列化排除的通用系统,它会变得更加容易。 请注意,我们可以将多个排除策略作为参数传递。

如果我们目前没有看到排除策略的意义,那没关系! 我们很快就会更深入地介绍更复杂的类型。 一旦我们开始编写自定义适配器,那么肯定会看到它的价值。 幸运的是,通过排除策略,我们可以将 Gson 设置为忽略任何类。


仅用于序列化或反序列化的排除策略

在上一节中,我们将排除策略应用于序列化和反序列化。 如果我们需要仅用于序列化或反序列化的排除策略,则可以使用以下方法:

  • addSerializationExclusionStrategy()
  • addDeserializationExclusionStrategy()。

这两种方法的工作方式与之前使用 setExclusionStrategies() 的一般方法相同。 我们可以实现并传递相同的 ExclusionStrategy 对象。


基于修饰符排除字段

正如我们之前所解释的,在序列化和反序列化期间,默认情况下,所有带有 transient 修饰符的模型字段都会被忽略。

GsonBuilder 允许我们更改此行为。 使用 excludeFieldsWithModifiers() 我们可以自定义在(反)序列化期间不包含哪些修饰符。 该方法需要来自 ·java.lang.reflect.Modifier· 类的修饰符之一。

例如,我们可能有以下模型:

public class UserModifier {  
    private String name;
    private transient String email;
    private static boolean isDeveloper;
    private final int age;
}

如果我们想排除所有最终类型和静态类型的字段,但包括 transient 字段,则需要使用 GsonBuilder 配置 Gson,如下所示:

GsonBuilder gsonBuilder = new GsonBuilder();  
gsonBuilder.excludeFieldsWithModifiers(Modifier.STATIC, Modifier.FINAL);  
Gson gson = gsonBuilder.create();

UserModifier user = new UserModifier("zadmei", "zadmei_onmpw@163.com", 26, true);  
String usersJson = gson.toJson(user);  

上面的代码将创建这个 JSON:

{
  "email": "zadmei_onmpw@163.com",
  "name": "zadmei"
}

请注意 Gson 实例如何包含 email 字段,即使它是暂时的。 调用 excludeFieldsWithModifiers() 方法会覆盖默认设置。 我们只传递了 static 和 final,因此不会忽略 transient 修饰符。 如果我们希望包含所有字段,无论修饰符如何,只需将一个空列表传递给 excludeFieldsWithModifiers()


排除没有 @Expose 的字段

最后,我们不是很喜欢的一个选项,但会提到为我们提供所有选项:excludeFieldsWithoutExposeAnnotation()。 正如方法名称所表示的,这不包括所有没有 @Expose 注解的字段。

我们可以强制应用程序模型在任何地方都有 @Expose 注解,并确保开发人员考虑哪个字段被(反)序列化。