快捷導(dǎo)航

mybatisplus?JSON類型處理器詳解

更新時間：2025年10月13日 11:12:37 作者：D_FW

文章介紹了如何在數(shù)據(jù)庫中使用JSON字段類型及其在Java項目中的自動轉(zhuǎn)換處理,通過設(shè)置實體類屬性上的注解,使用JacksonTypeHandler自動處理JSON數(shù)據(jù)的保存和讀取,減少手動轉(zhuǎn)換JSON與String格式的需求,這樣可以提高數(shù)據(jù)操作的效率和代碼的簡潔性

應(yīng)用場景

當前有一個購物車功能，展示用戶所選商品的信息，如：規(guī)格、數(shù)量、商品名、價格等，其中商品規(guī)格存儲格式例如：{"尺寸": "xxl", "顏色": "黑色"}。

此處如果使用String類型存入數(shù)據(jù)庫，每次獲取數(shù)據(jù)以及保存數(shù)據(jù)都需要手動進行json格式和String類型的轉(zhuǎn)換，為了避免這個情況，可以直接在數(shù)據(jù)庫中設(shè)置該字段spData為json類型，并且在項目中使用JSON處理器進行自動轉(zhuǎn)換。

數(shù)據(jù)表結(jié)構(gòu)

如下：

接下來在實體類中配置JSON處理器

package com.zxs.weixinapi.domain.entity;

import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import java.io.Serializable;
import java.math.BigDecimal;
import java.util.Map;
import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.experimental.Accessors;

/**
 * <p>
 * 
 * </p>
 *
 * @author zxs
 * @since 2025-10-12
 */
@Data
@EqualsAndHashCode(callSuper = false)
@Accessors(chain = true)
@TableName(value = "ums_member_cart", autoResultMap = true)
public class MemberCart implements Serializable {

    private static final long serialVersionUID = 1L;

    @TableId(value = "id", type = IdType.AUTO)
    private Integer id;

    /**
     * 商品名稱
     */
    private String productName;

    /**
     * 用戶Id
     */
    private Integer memberId;

    /**
     * 數(shù)量
     */
    private Integer quantity;

    /**
     * 單價
     */
    private BigDecimal price;

    /**
     * 規(guī)格屬性
     */
    @TableField(typeHandler = JacksonTypeHandler.class)
    private Map<String, String> spData;


}

首先需要在@TableName中配置屬性autoResultMap = true
然后在需要進行json處理的屬性上添加注解@TableField(typeHandler = JacksonTypeHandler.class)

完整代碼

controller:

package com.zxs.weixinapi.controller;


import com.zxs.weixinapi.common.R;
import com.zxs.weixinapi.domain.dto.MemberCartDto;
import com.zxs.weixinapi.service.IMemberCartService;
import lombok.RequiredArgsConstructor;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.RestController;

/**
 * <p>
 *  前端控制器
 * </p>
 *
 * @author zxs
 * @since 2025-10-12
 */
@RestController
@RequestMapping("/member/cart")
@RequiredArgsConstructor
public class MemberCartController {

    private final IMemberCartService memberCartService;

    /**
     * 添加購物車
     * @param memberCartDto
     * @return
     */
    @PostMapping("/add")
    public R<Void> add(@RequestBody MemberCartDto memberCartDto) {
        memberCartService.add(memberCartDto);
        return R.success(null);
    }

}

mapper:

package com.zxs.weixinapi.mapper;

import com.zxs.weixinapi.domain.entity.MemberCart;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Mapper;

/**
 * <p>
 *  Mapper 接口
 * </p>
 *
 * @author zxs
 * @since 2025-10-12
 */
@Mapper
public interface MemberCartMapper extends BaseMapper<MemberCart> {

}

service:

package com.zxs.weixinapi.service;

import com.zxs.weixinapi.domain.dto.MemberCartDto;
import com.zxs.weixinapi.domain.entity.MemberCart;
import com.baomidou.mybatisplus.extension.service.IService;

/**
 * <p>
 *  服務(wù)類
 * </p>
 *
 * @author zxs
 * @since 2025-10-12
 */
public interface IMemberCartService extends IService<MemberCart> {

    /**
     * 添加購物車
     * @param memberCartDto
     */
    void add(MemberCartDto memberCartDto);
}

serviceImpl:

package com.zxs.weixinapi.service.impl;

import cn.hutool.core.bean.BeanUtil;
import com.zxs.weixinapi.domain.dto.MemberCartDto;
import com.zxs.weixinapi.domain.entity.MemberCart;
import com.zxs.weixinapi.mapper.MemberCartMapper;
import com.zxs.weixinapi.service.IMemberCartService;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import org.springframework.stereotype.Service;

/**
 * <p>
 *  服務(wù)實現(xiàn)類
 * </p>
 *
 * @author zxs
 * @since 2025-10-12
 */
@Service
public class MemberCartServiceImpl extends ServiceImpl<MemberCartMapper, MemberCart> implements IMemberCartService {

    @Override
    public void add(MemberCartDto memberCartDto) {
        MemberCart memberCart = BeanUtil.toBean(memberCartDto, MemberCart.class);
        memberCart.setMemberId(1);
        this.save(memberCart);
    }
}

dto:

package com.zxs.weixinapi.domain.dto;

import lombok.Data;

import java.math.BigDecimal;
import java.util.Map;

@Data
public class MemberCartDto {

    /**
     * 商品名稱
     */
    private String productName;

    /**
     * 數(shù)量
     */
    private Integer quantity;

    /**
     * 規(guī)格屬性
     */
    private Map<String, String> spData;

    /**
     * 單價
     */
    private BigDecimal price;
}

entity:

package com.zxs.weixinapi.domain.entity;

import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import java.io.Serializable;
import java.math.BigDecimal;
import java.util.Map;
import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.experimental.Accessors;

/**
 * <p>
 * 
 * </p>
 *
 * @author zxs
 * @since 2025-10-12
 */
@Data
@EqualsAndHashCode(callSuper = false)
@Accessors(chain = true)
@TableName(value = "ums_member_cart", autoResultMap = true)
public class MemberCart implements Serializable {

    private static final long serialVersionUID = 1L;

    @TableId(value = "id", type = IdType.AUTO)
    private Integer id;

    /**
     * 商品名稱
     */
    private String productName;

    /**
     * 用戶Id
     */
    private Integer memberId;

    /**
     * 數(shù)量
     */
    private Integer quantity;

    /**
     * 單價
     */
    private BigDecimal price;

    /**
     * 規(guī)格屬性
     */
    @TableField(typeHandler = JacksonTypeHandler.class)
    private Map<String, String> spData;


}