在SpringBoot+MyBatis中優(yōu)雅處理多表數(shù)據(jù)清洗的實現(xiàn)步驟

更新時間：2025年03月06日 11:31:13 作者：好奇的菜鳥

數(shù)據(jù)清洗是指對數(shù)據(jù)進行處理和糾錯,以去除或修復數(shù)據(jù)集中存在的錯誤、不致、不完整和冗余的數(shù)據(jù),從而使數(shù)據(jù)更加準確、可靠和有用,本文給大家介紹了在SpringBoot和MyBatis中優(yōu)雅處理多表數(shù)據(jù)清洗的實現(xiàn)步驟,需要的朋友可以參考下

問題背景

在實際業(yè)務中，我們常會遇到數(shù)據(jù)冗余問題。例如，一個公司表（sys_company）中存在多條相同公司名的記錄，但只有一條有效（del_flag=0），其余需要刪除。刪除前需將關聯(lián)表（如合同草稿表、發(fā)票表等）的外鍵字段（如purchaser_id）替換為保留記錄的ID。這類問題通常涉及多表、多字段的動態(tài)更新，如何高效且安全地實現(xiàn)？

解決方案

我們將通過以下步驟實現(xiàn)：

配置化驅(qū)動：用配置類聲明需要處理的表和字段，避免硬編碼。
動態(tài)SQL更新：通過MyBatis XML實現(xiàn)批量更新和刪除。
事務一致性：確保所有操作原子化執(zhí)行。

實現(xiàn)步驟

1. 定義實體類

CompanyRetainedInfo：封裝需保留的公司信息

import lombok.Data;

@Data
public class CompanyRetainedInfo {
    private String companyName;   // 公司名稱
    private Long retainedId;      // 需保留的公司ID（del_flag=0的記錄）
    private String retainedName;  // 需保留的公司名稱（與companyName一致）
}

• 作用：映射查詢結果，傳遞保留記錄的ID和名稱。
• Lombok：@Data 自動生成Getter/Setter和toString()方法。

2. 定義配置類

TableConfig：聲明需處理的表和外鍵關系

public class TableConfig {
    private String tableName;    // 表名（如contract_draft）
    private String idColumn;     // 外鍵ID字段（如purchaser_id）
    private String nameColumn;  // 名稱字段（如purchaser_name，可能為null）

    // 構造器 + Getter/Setter
    public TableConfig(String tableName, String idColumn, String nameColumn) {
        this.tableName = tableName;
        this.idColumn = idColumn;
        this.nameColumn = nameColumn;
    }
}

3. 編寫MyBatis Mapper接口

CompanyCleanMapper：定義數(shù)據(jù)操作接口（無注解，純XML映射）

@Mapper
public interface CompanyCleanMapper {
    // 查詢需保留的公司信息（del_flag=0）
    List<CompanyRetainedInfo> selectRetainedCompanies();

    // 根據(jù)公司名查詢待刪除的ID列表（del_flag!=0）
    List<Long> selectIdsToDelete(String companyName);

    // 更新關聯(lián)表的外鍵引用
    void updateForeignKeys(
        @Param("config") TableConfig config,
        @Param("retainedId") Long retainedId,
        @Param("retainedName") String retainedName,
        @Param("ids") List<Long> ids
    );

    // 刪除冗余公司記錄
    void deleteCompanies(@Param("ids") List<Long> ids);
}

4. 實現(xiàn)XML映射文件

CompanyCleanMapper.xml：定義動態(tài)SQL邏輯

<?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="com.example.mapper.CompanyCleanMapper">

    <!-- 查詢需保留的公司 -->
    <select id="selectRetainedCompanies" resultType="CompanyRetainedInfo">
        SELECT 
            company_name AS companyName, 
            id AS retainedId, 
            company_name AS retainedName
        FROM sys_company
        WHERE del_flag = 0
          AND company_name IN (
            SELECT company_name
            FROM sys_company
            GROUP BY company_name
            HAVING COUNT(*) > 1 AND SUM(del_flag = 0) = 1
          )
    </select>

    <!-- 查詢待刪除的ID列表 -->
    <select id="selectIdsToDelete" resultType="long">
        SELECT id
        FROM sys_company
        WHERE company_name = #{companyName}
          AND del_flag != 0
    </select>

    <!-- 動態(tài)更新外鍵引用 -->
    <update id="updateForeignKeys">
        UPDATE ${config.tableName}
        SET
            <choose>
                <when test="config.nameColumn != null">
                    <!-- 同時更新ID和名稱字段 -->
                    ${config.idColumn} = #{retainedId},
                    ${config.nameColumn} = #{retainedName}
                </when>
                <otherwise>
                    <!-- 僅更新ID字段 -->
                    ${config.idColumn} = #{retainedId}
                </otherwise>
            </choose>
        WHERE
            ${config.idColumn} IN
            <foreach item="id" collection="ids" open="(" separator="," close=")">
                #{id}
            </foreach>
    </update>

    <!-- 批量刪除公司記錄 -->
    <delete id="deleteCompanies">
        DELETE FROM sys_company
        WHERE id IN
        <foreach item="id" collection="ids" open="(" separator="," close=")">
            #{id}
        </foreach>
    </delete>

</mapper>

5. 服務層實現(xiàn)

CompanyCleanService：配置化驅(qū)動批量處理

@Service
@RequiredArgsConstructor
public class CompanyCleanService {
    private final CompanyCleanMapper companyCleanMapper;

    // 配置需要處理的表和字段
    private static final List<TableConfig> TABLE_CONFIGS = Arrays.asList(
        new TableConfig("contract_draft", "purchaser_id", "purchaser_name"),
        new TableConfig("invoice", "company_id", "company_name")
        // 按需添加其他表...
    );

    @Transactional
    public void cleanDuplicateCompanies() {
        // 1. 查詢所有需保留的公司
        List<CompanyRetainedInfo> retainedCompanies = companyCleanMapper.selectRetainedCompanies();
        
        for (CompanyRetainedInfo info : retainedCompanies) {
            // 2. 查詢待刪除的ID列表
            List<Long> idsToDelete = companyCleanMapper.selectIdsToDelete(info.getCompanyName());
            
            if (!idsToDelete.isEmpty()) {
                // 3. 更新所有關聯(lián)表的外鍵引用
                TABLE_CONFIGS.forEach(config -> 
                    companyCleanMapper.updateForeignKeys(
                        config, 
                        info.getRetainedId(), 
                        info.getRetainedName(), 
                        idsToDelete
                    )
                );
                
                // 4. 刪除冗余公司記錄
                companyCleanMapper.deleteCompanies(idsToDelete);
            }
        }
    }
}

關鍵設計說明

實體類與數(shù)據(jù)映射
• CompanyRetainedInfo 通過別名（AS retainedId）直接映射查詢結果，避免額外轉(zhuǎn)換。
• companyName 和 retainedName 字段值相同，但保留后者以明確語義。
XML動態(tài)SQL優(yōu)勢
• <choose>：根據(jù)配置動態(tài)決定是否更新名稱字段。
• <foreach>：自動展開ID列表為IN (id1, id2...)，支持批量操作。
• ${}占位符：安全引用配置的表名和字段名（非用戶輸入，無注入風險）。
事務與性能優(yōu)化
• @Transactional：保證“更新外鍵”和“刪除公司”操作的原子性。
• 索引建議：對sys_company.company_name和關聯(lián)表的外鍵字段添加索引。