MyBatis-Plus12：JSON处理器

一、JSON 类型 在 Mysql中的使用

MySQL 5.7.8 版本开始就原生支持 JSON 类型了。

1-1、基本用法

建表时直接用JSON作为字段类型：

CREATE TABLE orders ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT, extra JSON -- JSON 类型字段 );

插入数据：

INSERT INTO orders (user_id, extra) VALUES (1, '{"color": "red", "size": "XL"}');

1-2、常用的 JSON 函数

查询 JSON 中的某个字段：

-- -> 返回 JSON 格式，->> 返回纯文本 SELECT extra->'$.color' FROM orders; -- 返回 "red"（带引号） SELECT extra->>'$.color' FROM orders; -- 返回 red（不带引号）

修改 JSON 中的某个字段：

UPDATE orders SET extra = JSON_SET(extra, '$.color', 'blue') WHERE id = 1;

按 JSON 字段的值来查询：

SELECT * FROM orders WHERE extra->>'$.color' = 'red';

1-3、和直接存 VARCHAR 字符串的区别

虽然你插入时写的是 JSON 字符串，但 MySQL 内部会把它解析并转换成二进制格式存储。

所以本质上存的是二进制，只是展示给你看的时候会格式化成 JSON 字符串的样子。

1-4、MySQL 内置的 JSON 操作函数：JSON_SET

JSON_SET是 MySQL 内置的 JSON 操作函数，作用是修改 JSON 中某个字段的值，如果字段不存在就新增，存在就覆盖。

1、语法

JSON_SET(json字段, 路径, 新值, 路径, 新值, ...)

支持一次修改多个字段。

2、举个例子

假设extra字段当前值是：

{"color": "red", "size": "XL"}

修改已有字段：

UPDATE orders SET extra = JSON_SET(extra, '$.color', 'blue'); -- 结果：{"color": "blue", "size": "XL"}

新增不存在的字段：

UPDATE orders SET extra = JSON_SET(extra, '$.price', 99); -- 结果：{"color": "red", "size": "XL", "price": 99}

同时修改多个：

UPDATE orders SET extra = JSON_SET(extra, '$.color', 'blue', '$.size', 'M'); -- 结果：{"color": "blue", "size": "M"}

3、相似函数对比

大多数情况用JSON_SET就够了，因为它最灵活。

二、在 MyBatis-Plus 中使用

Java 实体类中对应字段用String或自定义对象接收，需要加json类型处理器。

【注意】：

没有application.yml全局配置！！！

2-1、完整示例

1、定义json类型字段对应的java类

@Data @NoArgsConstructor @AllArgsConstructor(staticName = "of") public class JsonInfo { private String color; private String size; }

2、在对应的table entity类上添加两个注解：

3、postman测试

（1）查询

（2）插入

三、@TableName(autoResultMap = true) 详解

这是MyBatis-Plus框架中的注解属性，主要用于处理特殊类型字段的映射问题。

【备注】：

ResultMap是 MyBatis 中用于定义数据库查询结果与 Java 对象之间映射关系的核心配置。

数据库查询结果 (ResultSet) ↓ ResultMap (映射规则) ↓ Java 对象 (POJO/Entity)

简单说：ResultMap 告诉 MyBatis"如何把数据库的列映射到 Java 对象的属性"

---

ResultMap vs resultType

对比项	resultType	resultMap
配置方式	自动映射	手动配置映射规则
适用场景	字段名=属性名	字段名≠属性名/关联查询/类型转换
灵活性	低	高
代码量	少	多
TypeHandler	不支持	✅ 支持·

3-1、核心含义

当设置为true时，MyBatis-Plus 会自动生成 ResultMap，支持自定义类型处理器（TypeHandler）生效。

3-2、典型使用场景

场景一：MySQL JSON 类型字段（最常见）

当数据库字段是JSON 类型，实体类属性是Java 对象/集合时：

// 实体类 @TableName(value = "users", autoResultMap = true) public class User { @TableId private Long id; // JSON 字段，需要类型转换 @TableField(typeHandler = JacksonTypeHandler.class) private UserInfo info; @TableField(typeHandler = JacksonTypeHandler.class) private List<String> tags; }

# application.yml 配置 mybatis-plus: type-handlers-package: com.example.demo.handler type-aliases-package: com.example.demo.entity

场景二：自定义 TypeHandler

// 自定义类型处理器 public class EncryptTypeHandler extends BaseTypeHandler<String> { @Override public void setParameter(PreparedStatement ps, int i, String parameter, JdbcType jdbcType) { ps.setString(i, encrypt(parameter)); } @Override public String getNullableResult(ResultSet rs, String columnName) { return decrypt(rs.getString(columnName)); } // ... 其他方法 }

// 实体类 @TableName(value = "users", autoResultMap = true) public class User { @TableField(typeHandler = EncryptTypeHandler.class) private String phone; // 数据库中加密存储 }

3-3、注意事项

3-4、完整示例

// 实体类 @TableName(value = "articles", autoResultMap = true) @Data public class Article { @TableId private Long id; private String title; // JSON 字段存储为对象 @TableField(typeHandler = JacksonTypeHandler.class) private ArticleContent content; // JSON 字段存储为列表 @TableField(typeHandler = JacksonTypeHandler.class) private List<String> tags; }

// JSON 对象 @Data public class ArticleContent { private String text; private String coverImage; private Integer wordCount; }

// Mapper 接口 @Mapper public interface ArticleMapper extends BaseMapper<Article> { // 自定义查询也需要 ResultMap 支持 @Select("SELECT * FROM articles WHERE id = #{id}") Article selectDetail(Long id); }

3-5、什么时候需要设置？

总结

autoResultMap = true ↓ 让 MyBatis-Plus 自动生成 ResultMap ↓ 使 @TableField(typeHandler = ...) 生效 ↓ 实现 数据库特殊类型 ↔ Java 对象 的转换

简单说：处理 JSON 字段或自定义类型转换时，必须开启这个选项！