快捷導(dǎo)航

MyBatis復(fù)雜對象處理的兩種方式示例代碼文檔

更新時間：2025年12月12日 17:17:09 作者：蛐蛐蜉蝣耶

本文檔詳細(xì)介紹了如何在MyBatis中處理復(fù)雜對象的兩種方式：使用MyBatis-PlusTypeHandler處理嵌套對象（自動序列化為JSON存儲）和使用關(guān)聯(lián)對象映射處理多個字段,文中還涵蓋了自定義Mapper方法、事務(wù)管理和關(guān)聯(lián)數(shù)據(jù)操作的注意事項,感興趣的朋友跟隨小編一起看看吧

MyBatis復(fù)雜對象處理示例代碼文檔

概述

本文檔詳細(xì)介紹了如何在 MyBatis中處理復(fù)雜對象的兩種方式：

使用 MyBatis-Plus TypeHandler 處理嵌套對象（自動序列化為 JSON 存儲）
使用關(guān)聯(lián)對象映射處理多個字段

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

文件路徑: db/schema.sql

-- 創(chuàng)建演示表結(jié)構(gòu)
drop table demo_entity;
-- 主表，使用TypeHandler方式存儲復(fù)雜對象
CREATE TABLE `demo_entity` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主鍵',
  `name` varchar(100) NOT NULL COMMENT '名稱',
  `create_time` datetime DEFAULT NULL COMMENT '創(chuàng)建時間',
  `config_data` varchar(1000) DEFAULT NULL COMMENT '配置數(shù)據(jù)(JSON格式，由TypeHandler處理)',
  `street` varchar(200) DEFAULT NULL COMMENT '街道地址',
  `city` varchar(100) DEFAULT NULL COMMENT '城市',
  `zip_code` varchar(20) DEFAULT NULL COMMENT '郵政編碼',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='演示實體表';
select * from demo_entity;

實體類設(shè)計

文件路徑: DemoEntity.java

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.extension.handlers.FastjsonTypeHandler;
import lombok.Data;
import java.io.Serializable;
import java.time.LocalDateTime;
import java.util.List;
@Data
@TableName(value = "demo_entity",autoResultMap = true)
public class DemoEntity implements Serializable {
    @TableId(value = "id", type = IdType.AUTO)
    private Long id;
    @TableField("name")
    private String name;
    @TableField("create_time")
    private LocalDateTime createTime;
    // 方式一：使用TypeHandler處理復(fù)雜對象
    @TableField(value = "config_data", typeHandler = FastjsonTypeHandler.class)
    private ConfigData configData;
    // 方式二：關(guān)聯(lián)對象（通過其他字段映射）
    // @TableField(exist = false)是由于mybatis-plus的原因，
    // 當(dāng)實體類中存在該字段時，會默認(rèn)認(rèn)為該字段是關(guān)聯(lián)字段，會自動填充關(guān)聯(lián)對象。
    @TableField(exist = false)
    private AddressInfo addressInfo;
    @Data
    public static class ConfigData implements Serializable {
        private String theme;
        private List<String> permissions;
        private Boolean enabled;
    }
    @Data
    public static class AddressInfo implements Serializable {
        private String street;
        private String city;
        private String zipCode;
    }
}

Mapper 接口

文件路徑: DemoEntityMapper.java

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.credithc.risk.entity.DemoEntity;
import org.apache.ibatis.annotations.Param;
public interface DemoEntityMapper extends BaseMapper<DemoEntity> {
    /**
     * 自定義插入方法，處理關(guān)聯(lián)對象
     */
    int insertWithAddress(@Param("entity") DemoEntity entity);
    /**
     * 自定義更新方法，處理關(guān)聯(lián)對象
     */
    int updateWithAddress(@Param("entity") DemoEntity entity);
    /**
     * 根據(jù)ID查詢包含關(guān)聯(lián)對象的完整實體
     */
    DemoEntity selectWithAddressById(@Param("id") Long id);
}

Mapper XML 映射文件

文件路徑: DemoEntityMapper.xml

<?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="DemoEntityMapper">
    <resultMap id="BaseResultMap" type="DemoEntity">
        <id property="id" column="id"/>
        <result property="name" column="name"/>
        <result property="createTime" column="create_time"/>
        <result property="configData" column="config_data"
                typeHandler="com.baomidou.mybatisplus.extension.handlers.FastjsonTypeHandler"/>
        <!-- 關(guān)聯(lián)對象映射 -->
        <association property="addressInfo" javaType="DemoEntity$AddressInfo">
            <result property="street" column="street"/>
            <result property="city" column="city"/>
            <result property="zipCode" column="zip_code"/>
        </association>
    </resultMap>
    <insert id="insertWithAddress" useGeneratedKeys="true" keyProperty="id">
        INSERT INTO demo_entity (name, create_time, config_data,street,city, zip_code)
        VALUES (#{entity.name}, #{entity.createTime},
                #{entity.configData, typeHandler=com.baomidou.mybatisplus.extension.handlers.FastjsonTypeHandler},
                #{entity.addressInfo.street},#{entity.addressInfo.city},#{entity.addressInfo.zipCode})
    </insert>
    <insert id="updateWithAddress">
        UPDATE demo_entity
        SET name = #{entity.name},
            create_time = #{entity.createTime},
            config_data = #{entity.configData, typeHandler=com.baomidou.mybatisplus.extension.handlers.FastjsonTypeHandler},
            street = #{entity.addressInfo.street},
            city = #{entity.addressInfo.city},
            zip_code = #{entity.addressInfo.zipCode}
        WHERE id = #{entity.id}
    </insert>
    <select id="selectWithAddressById" resultMap="BaseResultMap">
        SELECT
            id,name,create_time,config_data,
            street,
            city,
            zip_code
        FROM demo_entity
        WHERE id = #{id}
    </select>
</mapper>

Service 層接口與實現(xiàn)

Service 接口

文件路徑: DemoEntityService.java

import com.baomidou.mybatisplus.extension.service.IService;
import com.credithc.risk.entity.DemoEntity;
public interface DemoEntityService extends IService<DemoEntity> {
    /**
     * 保存Demo實體，同時處理兩種不同類型的復(fù)雜字段
     */
    DemoEntity saveDemoEntity(DemoEntity entity);
    /**
     * 獲取包含關(guān)聯(lián)地址信息的完整實體
     */
    DemoEntity getDemoEntityWithAddress(Long id);
}

Service 實現(xiàn)類

文件路徑: DemoEntityServiceImpl.java

import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.credithc.risk.dao.DemoEntityMapper;
import com.credithc.risk.entity.DemoEntity;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import javax.annotation.Resource;
import java.time.LocalDateTime;
@Service
public class DemoEntityServiceImpl extends ServiceImpl<DemoEntityMapper, DemoEntity> implements DemoEntityService {
    @Resource
    private DemoEntityMapper demoEntityMapper;
    @Override
    @Transactional
    public DemoEntity saveDemoEntity(DemoEntity entity) {
        // 保存主實體（TypeHandler方式自動處理configData）
        if (entity.getId() == null) {
            entity.setCreateTime(LocalDateTime.now());
            // demoEntityMapper.insert(entity);此方法為mybatis-plus提供的方法，會自動處理configData，但不會處理addressInfo
            // 下面的方法會自動處理configData和addressInfo
            demoEntityMapper.insertWithAddress(entity);
        } else {
            // demoEntityMapper.updateById(entity);此方法為mybatis-plus提供的方法，會自動處理configData，但不會處理addressInfo
            // 下面的方法會自動處理configData和addressInfo
            demoEntityMapper.updateWithAddress(entity);
        }
        return entity;
    }
    @Override
    public DemoEntity getDemoEntityWithAddress(Long id) {
        // demoEntityMapper.selectById(id);此方法為mybatis-plus提供的方法，會自動處理configData，但不會處理addressInfo
        // 下面的方法會自動處理configData和addressInfo
        return demoEntityMapper.selectWithAddressById(id);
    }
}

測試用例

文件路徑: DemoEntityServiceTest.java

import com.credithc.risk.entity.DemoEntity;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;
import javax.annotation.Resource;
import java.time.LocalDateTime;
import java.util.Arrays;
import static org.junit.jupiter.api.Assertions.*;
@SpringBootTest
public class DemoEntityServiceTest {
    @Resource
    private DemoEntityService demoEntityService;
    @Test
    public void testSaveAndRetrieveEntityWithTypeHandler() {
        // 創(chuàng)建測試實體
        DemoEntity entity = new DemoEntity();
        entity.setName("Test Entity With TypeHandler");
        // 設(shè)置TypeHandler處理的復(fù)雜對象
        DemoEntity.ConfigData configData = new DemoEntity.ConfigData();
        configData.setTheme("dark");
        configData.setPermissions(Arrays.asList("read", "write", "delete"));
        configData.setEnabled(true);
        entity.setConfigData(configData);
        // 保存實體
        DemoEntity savedEntity = demoEntityService.saveDemoEntity(entity);
        // 驗證保存成功
        assertNotNull(savedEntity.getId());
        assertEquals("Test Entity With TypeHandler", savedEntity.getName());
        assertNotNull(savedEntity.getConfigData());
        assertEquals("dark", savedEntity.getConfigData().getTheme());
        assertEquals(3, savedEntity.getConfigData().getPermissions().size());
        assertTrue(savedEntity.getConfigData().getEnabled());
        // 驗證從數(shù)據(jù)庫重新加載的數(shù)據(jù)
        DemoEntity reloadedEntity = demoEntityService.getById(savedEntity.getId());
        assertNotNull(reloadedEntity);
        assertEquals("Test Entity With TypeHandler", reloadedEntity.getName());
        assertNotNull(reloadedEntity.getConfigData());
        assertEquals("dark", reloadedEntity.getConfigData().getTheme());
        assertEquals(3, reloadedEntity.getConfigData().getPermissions().size());
        assertTrue(reloadedEntity.getConfigData().getEnabled());
    }
    @Test
    public void testSaveAndRetrieveEntityWithAssociation() {
        // 創(chuàng)建測試實體
        DemoEntity entity = new DemoEntity();
        entity.setName("Test Entity With Association");
        entity.setCreateTime(LocalDateTime.now());
        // 設(shè)置關(guān)聯(lián)對象
        DemoEntity.AddressInfo addressInfo = new DemoEntity.AddressInfo();
        addressInfo.setStreet("123 Main St");
        addressInfo.setCity("Beijing");
        addressInfo.setZipCode("100000");
        entity.setAddressInfo(addressInfo);
        // 保存實體
        DemoEntity savedEntity = demoEntityService.saveDemoEntity(entity);
        // 驗證保存成功
        assertNotNull(savedEntity.getId());
        assertEquals("Test Entity With Association", savedEntity.getName());
        assertNotNull(savedEntity.getAddressInfo());
        assertEquals("123 Main St", savedEntity.getAddressInfo().getStreet());
        assertEquals("Beijing", savedEntity.getAddressInfo().getCity());
        assertEquals("100000", savedEntity.getAddressInfo().getZipCode());
        // 驗證從數(shù)據(jù)庫重新加載的數(shù)據(jù)（包含關(guān)聯(lián)對象）
        DemoEntity reloadedEntity = demoEntityService.getDemoEntityWithAddress(savedEntity.getId());
        assertNotNull(reloadedEntity);
        assertEquals("Test Entity With Association", reloadedEntity.getName());
        assertNotNull(reloadedEntity.getAddressInfo());
        assertEquals("123 Main St", reloadedEntity.getAddressInfo().getStreet());
        assertEquals("Beijing", reloadedEntity.getAddressInfo().getCity());
        assertEquals("100000", reloadedEntity.getAddressInfo().getZipCode());
    }
}

技術(shù)要點說明

1. TypeHandler 方式處理復(fù)雜對象

在實體類中使用 @TableField 注解配合 typeHandler 參數(shù)指定處理器
MyBatis-Plus 提供了 FastjsonTypeHandler 來自動將復(fù)雜對象序列化為 JSON 字符串存儲到數(shù)據(jù)庫
適用于單個復(fù)雜對象字段的處理

2. 關(guān)聯(lián)對象映射方式

使用 @TableField(exist = false) 標(biāo)記非數(shù)據(jù)庫字段
在 XML 映射文件中使用 <association> 標(biāo)簽進(jìn)行關(guān)聯(lián)對象映射
適用于需要將復(fù)雜對象的屬性拆分存儲到多個數(shù)據(jù)庫字段的情況

3. 自定義 Mapper 方法

為了處理關(guān)聯(lián)對象，我們自定義了以下方法：

insertWithAddress: 插入實體及關(guān)聯(lián)對象數(shù)據(jù)
updateWithAddress: 更新實體及關(guān)聯(lián)對象數(shù)據(jù)
selectWithAddressById: 查詢實體及關(guān)聯(lián)對象數(shù)據(jù)
關(guān)聯(lián)數(shù)據(jù)的操作切勿使用mybatis-plus默認(rèn)方法可能會不生效

4. 事務(wù)管理

在 Service 實現(xiàn)類中使用了 @Transactional 注解確保數(shù)據(jù)一致性。

在MyBatis生態(tài)中，當(dāng)處理數(shù)據(jù)庫中的關(guān)聯(lián)關(guān)系時，Association和Collection是兩個非常重要的概念。它們能夠幫助我們高效地獲取和處理與主實體相關(guān)的其他實體信息。無論是一對一（Association）還是一對多（Collection）的關(guān)系，再加上MyBatis-Plus TypeHandler模式，可以根據(jù)具體業(yè)務(wù)需求選擇合適的方式，正確地使用它們可以讓我們的持久層代碼更加清晰和高效。

到此這篇關(guān)于MyBatis復(fù)雜對象處理示例代碼文檔的文章就介紹到這了,更多相關(guān)MyBatis復(fù)雜對象內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: