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
注解,并确保开发人员考虑哪个字段被(反)序列化。