在使用 MyBatis-Plus 進(jìn)行業(yè)務(wù)開發(fā)時(shí)，我們時(shí)常需要把數(shù)據(jù)庫中的 JSON 字段（比如字符串形式的數(shù)組）自動(dòng)映射成 Java 中的 JSONArray 或 List<String> 類型。

默認(rèn)情況下，MyBatis-Plus 是不支持直接映射 JSON 類型的，這時(shí)候就需要借助：

• @TableField(typeHandler = ...)
• 自定義或已有的 TypeHandler
• 配合 @TableName(autoResultMap = true) 才能正確生效！

真實(shí)場(chǎng)景舉例

假設(shè)我們現(xiàn)在有一個(gè)旅游美食表 travel_cuisine，里面的字段 tag_list 是一個(gè) JSON Array，用來存儲(chǔ)標(biāo)簽 ID 列表，示例數(shù)據(jù)如下：

["tag-101", "tag-202", "tag-333"]

我們希望在 Java 實(shí)體中使用如下形式自動(dòng)映射：

@TableField(typeHandler = JsonArrayTypeHandler.class)
private JSONArray tagList;

接下來，教你一步步實(shí)現(xiàn)它。

一、@TableField + typeHandler 是什么？

@TableField 簡(jiǎn)介

@TableField 是 MyBatis-Plus 提供的字段級(jí)注解，用于說明字段與數(shù)據(jù)庫的映射關(guān)系。

核心參數(shù)如下：

typeHandler 作用

TypeHandler 是 MyBatis 中的一個(gè)重要機(jī)制，它負(fù)責(zé)Java 類型 和 JDBC 類型之間的轉(zhuǎn)換。

你可以用它來處理：

• JSON ↔ Java 對(duì)象（如 JSONArray、Map、List）
• 逗號(hào)分隔字符串 ↔ List
• 枚舉 ↔ 數(shù)據(jù)庫存儲(chǔ)值

簡(jiǎn)單來說，typeHandler 就是數(shù)據(jù)格式的橋梁！

二、@TableName(autoResultMap = true) 必須開啟

默認(rèn)情況下，MyBatis-Plus 的字段映射并不會(huì)使用 typeHandler，除非你在實(shí)體類加上：

@TableName(value = "travel_cuisine", autoResultMap = true)

autoResultMap 是什么？

這是告訴 MP：“請(qǐng)生成自定義的 ResultMap，否則我不支持 typeHandler 和復(fù)雜類型的轉(zhuǎn)換！”

如果你忘記加這一項(xiàng)，typeHandler 是不會(huì)生效的！

三、實(shí)戰(zhàn)代碼：映射 JSON 字段為 JSONArray

1.數(shù)據(jù)庫建表語句（簡(jiǎn)化版）

CREATE TABLE travel_cuisine (
  id BIGINT PRIMARY KEY AUTO_INCREMENT,
  name VARCHAR(100),
  tag_list TEXT -- JSON Array 字符串
);

2.實(shí)體類配置

@Data
@TableName(value = "travel_cuisine", autoResultMap = true)
public class TravelCuisineDO {

    private Long id;

    private String name;

    @TableField(typeHandler = JsonArrayTypeHandler.class)
    private JSONArray tagList;
}

3.自定義 TypeHandler（基于 FastJSON）

public class JsonArrayTypeHandler extends BaseTypeHandler<JSONArray> {

    @Override
    public void setNonNullParameter(PreparedStatement ps, int i, JSONArray parameter, JdbcType jdbcType) throws SQLException {
        ps.setString(i, parameter.toJSONString());
    }

    @Override
    public JSONArray getNullableResult(ResultSet rs, String columnName) throws SQLException {
        String result = rs.getString(columnName);
        return JSON.parseArray(result);
    }

    @Override
    public JSONArray getNullableResult(ResultSet rs, int columnIndex) throws SQLException {
        String result = rs.getString(columnIndex);
        return JSON.parseArray(result);
    }

    @Override
    public JSONArray getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {
        String result = cs.getString(columnIndex);
        return JSON.parseArray(result);
    }
}

提醒：這個(gè) JsonArrayTypeHandler 使用的是 FastJSON，如需 Jackson，請(qǐng)更換轉(zhuǎn)換邏輯。

四、常見問題排查指南

總結(jié)：三件事必須配套使用

到此這篇關(guān)于MyBatis-Plus實(shí)現(xiàn)優(yōu)雅處理JSON字段映射的文章就介紹到這了,更多相關(guān)MyBatis-Plus處理JSON字段映射內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論