MyBatis-Plus中JSON字段反序列化泛型问题的分析与解决

MyBatis-Plus中JSON字段反序列化泛型问题的分析与解决

【免费下载链接】mybatis-plus mybatis 增强工具包，简化 CRUD 操作。 文档 http://baomidou.com 低代码组件库 http://aizuda.com 项目地址: https://gitcode.com/baomidou/mybatis-plus

问题背景

在使用MyBatis-Plus进行数据库操作时，开发者经常会遇到需要将JSON格式数据存储在数据库字段中的场景。MyBatis-Plus提供了Fastjson2TypeHandler等类型处理器来简化这类操作。然而，在处理包含泛型的JSON字段时，开发者可能会遇到类型转换不准确的问题。

问题现象

具体表现为：当数据库字段定义为long类型时，经过JSON序列化/反序列化后，结果却变成了int类型。这种情况通常发生在使用Fastjson2TypeHandler处理包含泛型的集合字段时，如List<Long>。

原因分析

1. 泛型类型擦除：Java的泛型在运行时会被擦除，导致类型处理器无法准确获取集合元素的真实类型。

2. TypeHandler实现限制：默认的Fastjson2TypeHandler在处理泛型集合时，可能无法正确识别集合元素的类型信息。

3. ResultMap生成问题：当通过ResultMap自动生成TypeHandler时，可能缺少必要的类型信息，导致无法正确推断泛型参数。

解决方案

1. 自定义TypeHandler

对于需要精确控制类型转换的场景，可以继承Fastjson2TypeHandler并重写相关方法：

public class CustomFastjson2TypeHandler<T> extends Fastjson2TypeHandler<T> {
    private final Type type;
    
    public CustomFastjson2TypeHandler(Type type) {
        super(type);
        this.type = type;
    }
    
    @Override
    protected T parse(String json) {
        return JSON.parseObject(json, type);
    }
    
    @Override
    protected String toJson(T obj) {
        return JSON.toJSONString(obj);
    }
}

2. 显式指定类型

在使用TypeHandler时，显式指定具体的泛型类型：

@TableField(typeHandler = CustomFastjson2TypeHandler.class)
@JsonTypeInfo(use = JsonTypeInfo.Id.CLASS)
private List<Long> ids;

3. 使用TypeReference

对于复杂的泛型结构，可以使用TypeReference来保留类型信息：

TypeReference<List<Long>> typeReference = new TypeReference<List<Long>>() {};

最佳实践

1. 明确字段类型：在定义实体类时，尽可能明确指定字段的具体类型，避免依赖自动推断。

2. 测试验证：对于包含泛型的JSON字段，编写单元测试验证序列化和反序列化的正确性。

3. 版本兼容性：确保使用的MyBatis-Plus版本与JSON库版本兼容，避免因版本问题导致类型处理异常。

总结

MyBatis-Plus在处理JSON字段时提供了便利的类型处理器，但在处理泛型集合时需要特别注意类型信息的保留。通过自定义TypeHandler或显式指定类型信息，可以有效解决类型转换不准确的问题。开发者应根据实际业务场景选择最适合的解决方案，确保数据类型的正确性和一致性。

【免费下载链接】mybatis-plus mybatis 增强工具包，简化 CRUD 操作。 文档 http://baomidou.com 低代码组件库 http://aizuda.com 项目地址: https://gitcode.com/baomidou/mybatis-plus