Mybatis读取和存储json类型的数据

电玩女神 2024-03-22 10:49 49阅读 0赞

#### 目录 ####

*   *  一、测试使用JSONObject来获取json
     *  二、设置@TableName的autoResultMap为true，@TableField的typeHandler为JacksonTypeHandler.class
     *  三、设置xml当中的resultMap
     *  四、JacksonTypeHandler讲解
     *  五、新增假如是JSONObject异常问题
     *  六、遇到转义的问题

不管数据库当中是以json还是longtext数据类型来存json，都可以在mybatis当中使用string来接数据。这一点毋庸置疑！但是想要使用JSONObject类型的字段来取值是否可以呢？

### 一、测试使用JSONObject来获取json ###

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70][]

接下来我们来测试一下，我用的是mybatis-plus框架，mybatis-plus和mybatis是一样的，无非就是mybatis-plus封装好了一些crud方法。但是对于手写xml来说两个框架是一样的。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 1][]

实体类如下：这里的JSONObject我用的hutool工具包的，JSONObject一般引用的json框架都有

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 2][]

测试接口如下：这里一共写了两个接口，一个接口是手写的，一个是调用的mybatis-plus当中提供的BaseMapper的selectList方法

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 3][] ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 4][] ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 5][]

查询结果如下：假如想要使用JSONObject来映射数据库当中的json数据，不做任何配置是取不到的。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 6][]

这个是访问mybatis-plus当中提供的查询方法

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 7][]

> 得出结论：在不做任何配置的情况下，不管是手写的xml接口还是用mybatis-plus自带的查询接口，都是无法将json数据映射到JSONObject类型的字段当中的。

### 二、设置@TableName的autoResultMap为true，@TableField的typeHandler为JacksonTypeHandler.class ###

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 8][]

两个接口测试如下：调整过后，mybatis-plus当中自带的接口是可以将json数据映射到JSONObject类型的字段当中的（不管是longtext类型存储的json还是json类型存储的json数据）

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 9][] ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 10][]

> 对于mybatis-plus框架我们将@TableName的autoResultMap为true，然后@TableField的typeHandler为JacksonTypeHandler.class之后，调用mybatis-plus自带的查询接口是可以将json数据映射到JSONObject类型的字段当中的。

注意：如果@TableName的autoResultMap不设置为true，那么设置typeHandler不会生效

### 三、设置xml当中的resultMap ###

使用mybatis，有两个属性标签`<resultType>`、`<resultMap>`可以提供结果映射。

虽然resultType 属性在大部分情况下都够用，但是在一些特殊情况下无能为力，比如属性名和列名不一致，为一些连接的复杂语句编写映射代码。遇到这些情况，我们要使用`<resultMap>`标签，一份 `<resultMap>` 能够代替实现同等功能的数千行代码。

> resultMap 元素是 MyBatis 中最重要最强大的元素。resultMap 的设计思想是，对简单的语句做到零配置，对于复杂一点的语句，只需要描述语句之间的关系就行了。

> 注意：这里去掉了`<reslutType>`属性，用`<resultMap>`代替，二者只能选择其中的一个。

> 其实在上面设置@TableName的autoResultMap为true，@TableField的typeHandler为JacksonTypeHandler.class等同于在xml当中配置resultMap的某个属性使用JacksonTypeHandler。只不过mybatis-plus这块使用的是注解的形式，而mybatis应该是没有注解方式的。所以他只能用以下方式：

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
    <mapper namespace="com.gzl.cn.mysqljson.mapper.UserMapper">
        <resultMap id="BaseResultMap" type="com.gzl.cn.mysqljson.model.User">
            <id column="id" jdbcType="BIGINT" property="id" />
            <result column="name" jdbcType="VARCHAR" property="name" />
            <result column="age" jdbcType="INTEGER" property="age" />
            <result column="email" jdbcType="VARCHAR" property="email" />
            <result column="result_json" jdbcType="OTHER" property="resultJson" javaType="cn.hutool.json.JSONObject" typeHandler="com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler"/>
            <result column="result_text" jdbcType="VARCHAR" property="resultText" javaType="cn.hutool.json.JSONObject" typeHandler="com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler"/>
        </resultMap>
    
        <select id="getAllList" resultMap="BaseResultMap">
            select * from user
        </select>
    
    </mapper>

查询结果如下：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 11][]

### 四、JacksonTypeHandler讲解 ###

JacksonTypeHandler是mybatis-plus提供的，不管是使用注解方式还是使用xml方式当中都使用到了JacksonTypeHandler类。那么这个类到低是干什么的？假如我使用的是mybatis而并不是mybatis-plus该怎么办？

> JacksonTypeHandler就是专门用来做数据映射转换的。是mybatis-plus的，但是实际上继承的是BaseTypeHandler，而BaseTypeHandler是mybatis的，那么我们也就可以基于BaseTypeHandler来自己写一个。

import com.fasterxml.jackson.databind.ObjectMapper;
    import org.apache.ibatis.type.BaseTypeHandler;
    import org.apache.ibatis.type.JdbcType;
    
    import java.sql.CallableStatement;
    import java.sql.PreparedStatement;
    import java.sql.ResultSet;
    import java.sql.SQLException;
    
    public class JsonTypeHandler<T> extends BaseTypeHandler<T> {
        
        private static final ObjectMapper mapper = new ObjectMapper();
        private Class<T> clazz;
    
        public JsonTypeHandler(Class<T> clazz) {
        
            if (clazz == null) throw new IllegalArgumentException("Type argument cannot be null");
            this.clazz = clazz;
        }
    
        @Override
        public void setNonNullParameter(PreparedStatement ps, int i, T parameter, JdbcType jdbcType) throws SQLException {
        
            ps.setString(i, this.toJson(parameter));
        }
    
        @Override
        public T getNullableResult(ResultSet rs, String columnName) throws SQLException {
        
            return this.toObject(rs.getString(columnName), clazz);
        }
    
        @Override
        public T getNullableResult(ResultSet rs, int columnIndex) throws SQLException {
        
            return this.toObject(rs.getString(columnIndex), clazz);
        }
    
        @Override
        public T getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {
        
            return this.toObject(cs.getString(columnIndex), clazz);
        }
    
        private String toJson(T object) {
        
            try {
        
                return mapper.writeValueAsString(object);
            } catch (Exception e) {
        
                throw new RuntimeException(e);
            }
        }
    
        private T toObject(String content, Class<?> clazz) {
        
            if (content != null && !content.isEmpty()) {
        
                try {
        
                	// 核心转换，将数据库读取的字符串，转换为指定的class类型
                    return (T) mapper.readValue(content, clazz);
                } catch (Exception e) {
        
                    throw new RuntimeException(e);
                }
            } else {
        
                return null;
            }
        }
    }

### 五、新增假如是JSONObject异常问题 ###

而对于 typeHandler 属性，MyBatis 只支持写在 2 个地方:

*  定义在 resultMap 里，作用于查询结果的封装
 *  定义在 insert 和 update 语句的 \#\{property\} 中的 property后面  
    （例：\#\{property,typehandler=xxx.xxx.xxx\}），并且只作用于当前 设置值

假如不配置是会报错的！

![在这里插入图片描述][a4f74b75362d4d2d8033c2edc36bf953.png]

### 六、遇到转义的问题 ###

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 12][]

在使用JSONObject作为Java对象的类型存值和取值是可以原样返回的：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 13][]

那假如是使用的String存值和取值会发生什么样的场景呢？

首先使用String来直接接json对象肯定是不可以的，直接会报400异常。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 13][] ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 14][]

针对于这个问题有两种方案，一种是对json建立Java对象，还有一种是直接使用JSONObject

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 15][] ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 16][]

假如使用字符串来查询会出现转义的问题

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 17][]

遇到这个问题可以使用commons-lang3包下的StringEscapeUtils.unescapeJava进行转换一下

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 18][]

查询结果如下：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 19][]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/44ddff06e8e44bff9c676697b523cf43.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/263a72caa33b4f9d9e98cddfc0a69e24.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 2]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/6776e7304b61430db900941741a97a4d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 3]: https://img-blog.csdnimg.cn/d2e15acad4484508b72545fc98c8af62.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 4]: https://img-blog.csdnimg.cn/7fb6928385bc4fac9c116362afe0752c.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 5]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/fb004c177e034a28adb8e45599d5c4fd.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 6]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/16494f3016f5498286dfbe390f49310f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 7]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/1c6ed4b56d6a4d638703b14093bf64fc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 8]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/69314496b66d47f381b161536ccad0cf.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 9]: https://img-blog.csdnimg.cn/416ddd0332e14bc38d8630ab66b4d0e6.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 10]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/0b4ca96283fa4d0d8fe87cfb66ec9c3e.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 11]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/24da6855279a48209b4cd17fe77fa17e.png
[a4f74b75362d4d2d8033c2edc36bf953.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/d3f1d334aae54a14ac04bed6dc3e2373.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 12]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/42a323f52db8404d94deef88cbd72f07.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 13]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/5e01f47e7aa9410b88e9a485194d9fd9.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 14]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/cd60c96b64564d9ca6fa9283f25e311e.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 15]: https://img-blog.csdnimg.cn/7a5902cc26cf4edc9657099bd4984c33.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 16]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/03a26c0d5e1443128616c4f2c99f1a66.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 17]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/c3a25e7923b54036bee2bf1fe20bad78.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 18]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/3fb1fbd0f788417ea3208fbed15e61eb.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 19]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/b9c64618e0d04b4e8f21d88170bcb828.png