mysql JSON字段使用

1.背景

Mysql5.7.8版本以后新增的功能,Mysql提供了一个原生的Json类型,Json值将不再以字符串的形式存储,而是采用一种允许快速读取文本元素(document elements)的内部二进制(internal binary)格式,并提供了不少内置函数,通过计算列,甚至还可以直接索引json中的数据。

2.数据库基本操作

1.表结构

新建表

复制代码
CREATE TABLE `table_name` (  
   `id` INT UNSIGNED NOT NULL,
   `business_attr` JSON NOT NULL,
   PRIMARY KEY (`id`)
);

新增json类型字段

复制代码
alter table table_name add column `business_attr` JSON NULL;

2.插入操作

在json数据列提供json格式的字符串即可

复制代码
insert into table_name values(1,'{"attr_key1":"attr_value1","attr_key2":"attr_value2"}');

如果是字符串,可以通过cast函数转成json

复制代码
insert into table_name values(1,CAST('{"attr_key1":"attr_value1","attr_key2":"attr_value2"}', as JSON));

3.更新操作

1.json_set更新json字段

复制代码
update table_name set business_attr=json_set('{"num":1,"name":"abc"}','$.num',2,'$.age',16,'$.class.id',1) where id=1;
  • JSON_SET(json_doc, path, val[, path, val] ...)

  • path中$就代表整个doc,然后可以用javascript的方式指定对象属性或者数组下标等.

  • 值存在就修改,值不存在就设置,路径不存在将直接被忽略。

2.json_merge_patch更新json字段

复制代码
update table_name set business_attr=JSON_MERGE_PATCH(IFNULL(business_attr,json_object()),JSON_OBJECT('attr_key1',CAST('attr_value1' as JSON))) where id=1;

MySQL JSON_MERGE_PATCH() 函数返回一个由参数指定的多个 JSON 文档合并后的 JSON 文档。JSON_MERGE_PATCH() 执行的是替换合并,即在相同键值时,只保留后面的值。

3.json_insert插入json字段

  • JSON_INSERT(json_doc, path, val[, path, val] ...)

  • 如果不存在对应属性则插入,否则不做任何变动

4.删除操作

json_remove方法删除某个属性

复制代码
update table_name set business_attr=JSON_REMOVE(business_attr,'$.attr_key1') where id=1;
  • JSON_REMOVE(json_doc, path[, path] ...)

  • 如果存在则删除对应属性,否则不做任何变动

5.查询操作

1.使用json_extract函数查询,获得doc中某个或多个节点的值。

JSON_EXTRACT(json_doc, path[, path] ...)

复制代码
SELECT JSON_EXTRACT(business_attr, '$.attr_key1') where id=1;

2.使用 字段->'$.json属性'进行查询条件

mysql5.7.9开始增加了一种简写方式:column->path

复制代码
SELECT business_attr->'$.attr_key1' where id=1;

JSON相关函数参考

https://www.sjkjc.com/mysql-ref/json-functions/

3.结合Mybatis使用

TypeHandler 是 Mybatis 中用来处理 Java 类型与数据库类型之间的映射的一个接口。当你需要自定义数据类型的映射规则时,就需要实现这个接口。

例如,需要将新增的JSON字段business_attr映射成Map类型,就需要实现一个MapTypeHandler,用来处理Java中Map和数据JSON字段类型的转换。

[注意] 在自定义类型转换逻辑的情况下,需要显式的配置启用autoResultMap,从而自动映射sql查询结果到相应的实体对象。

1.Java实体类配置

如前所述,需要自定义一个MapTypeHandler,并在JSON类型字段上配置,同时启用autoResultMap。

复制代码
@TableName(value = "table_name", autoResultMap = true)
public class TableName {
    @TableId(type = IdType.ASSIGN_ID)
    private Long id;
    
    @TableField(typeHandler = MapTypeHandler.class)
    private Map<String, Object> businessAttr;
}

2.增删改操作

为了操作方便,这里统一都使用JSON_MERGE_PATCH作为字段插入和更新的方法,JSON_REMOVE作为字段删除的方法,可根据实际需要调整。

复制代码
//新增和修改
public Boolean updateBusinessAttr(AttrDTO dto){
    String setSql = " business_attr=JSON_MERGE_PATCH(IFNULL(business_attr,json_object()),JSON_OBJECT('%s',CAST('%s' as JSON)))";
    LambdaUpdateWrapper<TableName> updateWrapper = new LambdaUpdateWrapper<>();
    updateWrapper.eq(TableName::getId, dto.getId());
    updateWrapper.setSql(String.format(setSql, dto.getAttrKey(), UniMybatisJacksonUtil.toJson(dto.getValue())));
    this.update(updateWrapper);
    return true;
}
​
//删除
public Boolean deleteBusinessAttr(AttrDTO dto) {
    LambdaUpdateWrapper<TableName> updateWrapper = new LambdaUpdateWrapper<>();
    updateWrapper.eq(TableName::getId, dto.getId());
    String setSql = " business_attr=JSON_REMOVE(business_attr,'$.%s')";
    updateWrapper.setSql(String.format(setSql, dto.getAttrKey()));
    this.update(updateWrapper);
    return true;
}

3.查询操作

直接在mapper.xml文件里编写对应字段查询条件。

复制代码
<!-- 查询attrKey=attrValue的记录 -->
<if test="pageQuery.attrs != null and pageQuery.attrs.size() > 0">
    and
    <foreach collection="pageQuery.attrs" index="attrKey" item="attrValue" open="("
             separator="and" close=")">
        table_name.business_attr->'$.${attrKey}' = #{attrValue}
    </foreach>
</if>

对查询结果进行操作,直接将数据库查询结果强转成入库时的格式即可。

复制代码
//入库时kvMap值格式是Map<String, String>,查询结果可以直接强转
Map<String, String> kvMap = (Map<String, Object>) tableName.getBusinessAttr().get("kvMap");

4.json特殊字符处理

如果json字符串中含有转义符或者mysql不支持的字符,会导致入库失败,因此需要自定义JSON字符串处理类UniMybatisJacksonUtil对特殊字符处理一下。

  • typeHandler在入库前,重写setNonNullParameter方法:
复制代码
public void setNonNullParameter(PreparedStatement ps, int i, Map<K, V> parameter, JdbcType jdbcType) throws SQLException {
    ps.setString(i, this.toJson(parameter));
}
​
private String toJson(Map<K, V> params) {
    try {
        return UniMybatisJacksonUtil.toJson(params);
    } catch (Exception var3) {
        var3.printStackTrace();
        return "{}";
    }
}
  • 单独更新字段时,处理待更新对象
复制代码
updateWrapper.setSql(String.format(setSql, dto.getAttrKey(), UniMybatisJacksonUtil.toJson(dto.getValue())));

[注意] Java实体类中map的value是一个对象,注意在入库前不要把value序列化成String,否则会导致入库的值带有转义符;如果有逻辑要求必须序列化,在入库之前再额外执行一次反序列化成对象。

复制代码
if (JSONUtil.isTypeJSON(updateAttrs.get(key))) {
    //如果value已经是JSON格式,反序列化成对象
    attrDTO.setValue(JSON.parse(updateAttrs.get(key)));
}
相关推荐
路口游子1 分钟前
unresolved external symbol _ossl_ed25519_keymgmt_functions
java·服务器·前端
vibag4 分钟前
Hadoop(HDFS)
java·大数据·hadoop·hdfs
路口游子10 分钟前
_ossl_ed25519_keymgmt_functions
java·开发语言·算法
qtvb198744 分钟前
推荐JDK1.8 API 中文文档
java
开源哥661 小时前
【含文档】基于ssm+jsp的高校成绩报送系统(含源码+数据库+lw)
java·开发语言·数据库
码农不惑2 小时前
转化古老的Eclipse项目为使用gradle构建
java·ide·eclipse·gradle
weixin_537590452 小时前
《MySQL 8 DBA基础教程》第一章习题
数据库·mysql
Code成立2 小时前
《Java核心技术 卷I》JFrame组件中显示信息
java·前端·python
阿伟*rui2 小时前
初始MQ(安装使用RabbitMQ,了解交换机)
java·rabbitmq·java-rabbitmq
整不会了2 小时前
php反序列化入门
java·安全