前段时间遇到一个问题,序列化之后原本类中的属性名发生了变化,原本isDel序列化之后得到的是del,为此查了一下相关资料,发现和序列化机制有关
在阿里巴巴Java开发手册中关于这一点,有过一个『强制性』规定:
为此我们要看一下POJO中布尔类型变量不同的命名
classModel1 {privateBoolean isSuccess;public voidsetSuccess(Boolean success) {
isSuccess=success;
}publicBoolean getSuccess() {returnisSuccess;
}
}classModel2 {privateBoolean success;publicBoolean getSuccess() {returnsuccess;
}public voidsetSuccess(Boolean success) {this.success =success;
}
}classModel3 {private booleanisSuccess;public booleanisSuccess() {returnisSuccess;
}public void setSuccess(booleansuccess) {
isSuccess=success;
}
}classModel4 {private booleansuccess;public booleanisSuccess() {returnsuccess;
}public void setSuccess(booleansuccess) {this.success =success;
}
}
以上代码的setter/getter是使用Intellij IDEA自动生成的,仔细观察以上代码,你会发现以下规律:
基本类型自动生成的getter和setter方法,名称都是isXXX()和setXXX()形式的。
包装类型自动生成的getter和setter方法,名称都是getXXX()和setXXX()形式的。
我们可以发现,虽然Model3和Model4中的成员变量的名称不同,一个是success,另外一个是isSuccess,但是他们自动生成的getter和setter方法名称都是isSuccess和setSuccess。
关于Java Bean中的getter/setter方法的定义其实是有明确的规定的,根据JavaBeans(TM) Specification规定,如果是普通的参数propertyName,要以以下方式定义其setter/getter:
https://download.oracle.com/otndocs/jcp/7224-javabeans-1.01-fr-spec-oth-JSpec/
public get();public void set(a);public boolean is();public void set(boolean m);
可以看boolean类型的变量方法是单独定义的,使用is方式
通过对照这份JavaBeans规范,我们发现,在Model4中,变量名为isSuccess,如果严格按照规范定义的话,他的getter方法应该叫isIsSuccess。但是很多IDE都会默认生成为isSuccess。
在序列化中,这样就会受到影响
@Dataclass Model3 implementsSerializable {private static final long serialVersionUID = 1836697963736227954L;privateInteger age;privateString name;private booleanisSuccess;private booleanisDel;publicString getUser(){return "Hello JWZ";
}
}
我们定义一个类,使用lombok,然后看序列化进行测试
//定一个Model3类型
Model3 model3 = newModel3();
model3.setSuccess(true);//使用fastjson(1.2.46)序列化model3成字符串并输出
System.out.println("Serializable Result With fastjson :" +JSON.toJSONString(model3));//使用Gson(2.8.5)序列化model3成字符串并输出
Gson gson =newGson();
System.out.println("Serializable Result With Gson :" +gson.toJson(model3));//使用jackson(2.9.6)序列化model3成字符串并输出
ObjectMapper om = newObjectMapper();
System.out.println("Serializable Result With jackson :" +om.writeValueAsString(model3));
得到如下结果:
可以看到三种序列化的方式,
fastjson输出有值的数据,包含user,带is的字段被序列化不带is
Gson输出有值的数据,不包含user,带is的字段被序列化正常
Jackson输出所有有值和null的数据,包含user,带is的字段被序列化不带is
由此可以得出结论:
fastjson和Jackson是通过反射遍历getter方法,然后根据JavaBeans规则他会去掉is来获取属性值。
Gson是通过直接反射遍历类中所有属性。
现在我们试一下,对于同一个对象,如果用fastjson序列化,然后在使用Gson反序列化:
public static voidmain(String[] args) {
Model3 model3= newModel3();
model3.setSuccess(true);
String fastJSONString=JSON.toJSONString(model3);
System.out.println(fastJSONString);
Gson gson=newGson();
System.out.println(gson.fromJson(fastJSONString,Model3.class));
}
isSuccess竟然变为false
因为JSON框架通过扫描所有的getter后发现有一个isSuccess方法,然后根据JavaBeans的规范,解析出变量名为success,把model对象序列化城字符串后内容为{"success":true}。
根据{"success":true}这个json串,Gson框架在通过解析后,通过反射寻找Model类中的success属性,但是Model类中只有isSuccess属性,所以,最终反序列化后的Model类的对象中,isSuccess则会使用默认值false。
因此,应尽量使用success式的命名来从源头避免这个问题。
延伸,布尔类型定义应使用Boolean还是boolean
布尔类型应该使用包装类型还是基本数据类型呢?
public classTest {public static voidmain(String[] args) {
Model3 model3= newModel3();
System.out.println("model3 : " +model3);
}
}
@Dataclass Model3 implementsSerializable {booleansuccess;
Boolean del;
}
包装类型的默认值是null,基本类型的默认值输出了false,这在某些情况就会造成问题,建议在POJO和RPC的返回值中使用包装类型
所以在定义布尔类型变量时,应使用:
Boolean success;
参考:
《Java工程师成神之路》
《阿里巴巴Java开发手册》