共计 2966 个字符,预计需要花费 8 分钟才能阅读完成。
Problem
在写 Java 的 Unit Test 时,对于 Unit Test 所期望的值,一般是利用工具从 test/resources
目录下将 expectResult.json 读取进来并用 json 序列化工具进行反序列化来获得 Unit Test 所期望的结果,并与测试的实际结果进行对比。然而若是反序列化所用的类来源于第三方库(即不能更改任何代码),会遇到很大的问题。以下以本人对阿里云的 StreamRecord 类进行反序列化时遇到的问题进行描述:
StreamRecord 类的定义如下:
public class StreamRecord { | |
public enum RecordType { | |
/** | |
* PUT 类型 | |
* 如果对应行已存在,该 Record 需要覆盖原有数据。*/ | |
PUT, | |
/** | |
* UPDATE 类型 | |
* 如果对应行已存在,该 Record 是在原有数据上的更新。*/ | |
UPDATE, | |
/** | |
* DELETE 类型 | |
* 表明要删除对应的行。*/ | |
DELETE | |
} | |
/** | |
* Record 的类型 | |
*/ | |
private RecordType recordType; | |
/** | |
* 对应行的主键 | |
*/ | |
private PrimaryKey primaryKey; | |
/** | |
* 对应行的时序信息 | |
*/ | |
private RecordSequenceInfo sequenceInfo; | |
/** | |
* 该 Record 包含的属性列,为 RecordColumn 类型 | |
*/ | |
private List<RecordColumn> columns; | |
/** | |
* 获取 Record 的类型 | |
* @return Record 的类型 | |
*/ | |
public RecordType getRecordType() {return recordType;} | |
public void setRecordType(RecordType recordType) {this.recordType = recordType;} | |
/** | |
* 获取对应行的主键 | |
* @return 对应行的主键 | |
*/ | |
public PrimaryKey getPrimaryKey() {return primaryKey;} | |
public void setPrimaryKey(PrimaryKey primaryKey) {this.primaryKey = primaryKey;} | |
/** | |
* 获取该行的时序信息 | |
* @return 该行的时序信息 | |
*/ | |
public RecordSequenceInfo getSequenceInfo() {return sequenceInfo;} | |
public void setSequenceInfo(RecordSequenceInfo sequenceInfo) {this.sequenceInfo = sequenceInfo;} | |
/** | |
* 获取该 Record 包含的属性列列表 | |
* @return 该 Record 包含的属性列列表 | |
*/ | |
public List<RecordColumn> getColumns() {if (columns != null) {return columns;} else {return new ArrayList<RecordColumn>(); | |
} | |
} | |
public void setColumns(List<RecordColumn> columns) {this.columns = columns;} | |
@Override | |
public String toString() {StringBuilder sb = new StringBuilder(); | |
sb.append("[RecordType:]"); | |
sb.append(this.recordType); | |
sb.append("\n[RecordSequenceInfo:]"); | |
sb.append(this.sequenceInfo); | |
sb.append("\n[PrimaryKey:]"); | |
sb.append(this.primaryKey); | |
sb.append("\n[Columns:]"); | |
for (RecordColumn column : this.getColumns()) {sb.append("("); | |
sb.append(column); | |
sb.append(")"); | |
} | |
return sb.toString();} | |
} |
本工程原先只用 Jackson 进行序列化和反序列化,但 Jackson 的 ObjectMapper 在对此类进行反序列化时,报了 No suitable constructor
的错误,经过调查发现 Jackson 进行反序列化需要默认的构造函数(如果有带参数的构造函数,还要用 @JsonCreator
修饰构造函数,用 @JsonProperty
修饰构造函数参数),而上述类没有,即使有我们也不能对阿里云等第三方库进行更改,遂放弃 Jackson,转而考虑阿里自己的 fastjson。fastjson 的确能对该类进行反序列化,但是当我仔细分析反序列化后的对象时,发现有些深层的字段的值为 null,又经过一番调查,了解到 fastjson 虽然对反序列化的类没有构造函数的要求,但对字段有要求,反序列化的 private 字段要有 setter 方法才能正常的反序列化(或者有一个带有所有字段参数的构造函数),若是 private 字段缺少 setter 方法,则该字段的值为默认值。最后考虑用 Google 的 Gson,Gson 没有上述这些问题,但是若反序列化类有 Object 类型的字段,而该字段的值为数值型,则 Gson 都会转为 Double 型,比如你有个字段为
private Map<String, Object> map;
json 文件:
{ | |
"age": 24, | |
"height": 1.81 | |
} |
当把上述 json 文件反序列化为 map 字段时,直觉上会认为“age”字段的值的类型应该为 Integer 或 Long 型,然而 Gson 这里有点反常,由于 map 的 value 为 Object 类型,并未明确指定具体的数值类型,它会将 key 为“age”的字段会变为 Double 类型(并不是我们直觉上所期望的 Integer 或 Long 型),给后续编程带来麻烦。关于 Gson 的这个“特性”,可以参考 https://github.com/google/gso… 上面的“debate”,比较有趣的“网友怼作者”。
我最终的解决方案是用 Gson 反序列化,再利用反射工具 ReflectionTestUtils.setField 来对某些数值进行 Double 到 Long 的转化。
Conclusion
- Jackson 功能强大,但对反序列化的类的要求较高(要有默认的 constructor)。
- Fastjson 速度快,但是对反序列化的类也有一定要求,而且在反序列化复杂的 json 时 bug 较多(阿里云的很多 sdk 也由于这个原因并未使用 fastjson)。
- Gson 比较全面,对反序列化的类的要求最低,但是对于 Object 类型的数值字段处理不够友好。
以上实验所用版本:
compile group: 'com.google.code.gson', name: 'gson', version: '2.8.5' | |
compile group: 'com.alibaba', name: 'fastjson', version: '1.2.56' |
因此,如果没有遇到序列化和反序列化第三方库的 model 的情况下(即代码无法更改的情况),首选 Jackson,否则选 Gson。