快捷導(dǎo)航

MyBatis 字段映射的解決方案

更新時(shí)間：2026年05月27日 10:15:35 作者：Sprintz4r

本文介紹了三種MyBatis數(shù)據(jù)庫(kù)字段與Java實(shí)體屬性映射解決方案：手動(dòng)@Results映射、可復(fù)用的@Results(id)映射及全局駝峰命名自動(dòng)轉(zhuǎn)換配置,通過(guò)這些方法,可以有效減少冗余代碼,簡(jiǎn)化Mapper接口設(shè)計(jì),感興趣的朋友跟隨小編一起看看吧

引言

在使用 MyBatis 進(jìn)行數(shù)據(jù)庫(kù)操作時(shí)，數(shù)據(jù)庫(kù)字段名（如下劃線命名 delete_flag）與 Java 實(shí)體類屬性名（駝峰命名 deleteFlag）之間的映射是一個(gè)常見(jiàn)問(wèn)題。本文將介紹三種解決方案：手動(dòng) @Results 映射、可復(fù)用的 @Results(id) 映射以及全局駝峰命名配置。

首先，我們定義一個(gè)實(shí)體類UserInfo，后續(xù)所有示例都基于這個(gè)類：

public class UserInfo {
    private Integer id;
    private String username;
    private String password;
    private Integer age;
    private String gender;
    private String phone;
    private Integer deleteFlag;   // 數(shù)據(jù)庫(kù)字段 delete_flag
    private Date createTime;      // 數(shù)據(jù)庫(kù)字段 create_time
    private Date updateTime;      // 數(shù)據(jù)庫(kù)字段 update_time
    // getter / setter 省略
}

手動(dòng) @Results 映射

最直接的方式是在每個(gè)查詢方法上使用 @Results 注解，手動(dòng)指定字段映射關(guān)系。

@Mapper
public interface UserInfoMapper {
    @Results({
        @Result(column = "delete_flag", property = "deleteFlag"),
        @Result(column = "create_time", property = "createTime"),
        @Result(column = "update_time", property = "updateTime")
    })
    @Select("select * from user_info")
    List<UserInfo> selectAll();
    // 另一個(gè)查詢方法，需要重復(fù)寫(xiě)一遍 @Results
    @Results({
        @Result(column = "delete_flag", property = "deleteFlag"),
        @Result(column = "create_time", property = "createTime"),
        @Result(column = "update_time", property = "updateTime")
    })
    @Select("select * from user_info where id = #{id}")
    UserInfo selectById(Integer id);
}

可復(fù)用的 @Results(id) 映射

為了解決重復(fù)代碼問(wèn)題，MyBatis 允許為@Results 注解指定一個(gè) id，其他方法可以通過(guò) @ResultMap 引用該映射。

@Mapper
public interface UserInfoMapper {
    @Results(id = "BaseMap", value = {
        @Result(column = "delete_flag", property = "deleteFlag"),
        @Result(column = "create_time", property = "createTime"),
        @Result(column = "update_time", property = "updateTime")
    })
    @Select("select * from user_info")
    List<UserInfo> selectAll();
    // 直接引用上面定義的 BaseMap，無(wú)需重復(fù)寫(xiě) @Results
    @ResultMap(value = "BaseMap")
    @Select("select * from user_info where id = #{id}")
    UserInfo selectById(Integer id);
    // 再多一個(gè)方法也能復(fù)用
    @ResultMap(value = "BaseMap")
    @Select("select * from user_info where username = #{username}")
    UserInfo selectByUsername(String username);
}

全局駝峰命名自動(dòng)轉(zhuǎn)換

如果數(shù)據(jù)庫(kù)字段命名規(guī)范統(tǒng)一（如下劃線命名），最優(yōu)雅的方式是開(kāi)啟 MyBatis 的全局駝峰命名自動(dòng)轉(zhuǎn)換功能。

# application.yml
mybatis:
  configuration:
    map-underscore-to-camel-case: true # 配置駝峰自動(dòng)轉(zhuǎn)換

開(kāi)啟后，Mapper 接口變得極其簡(jiǎn)潔，無(wú)需任何 @Results 注解：

@Mapper
public interface UserInfoMapper {
    @Select("select * from user_info")
    List<UserInfo> selectAll();
    @Select("select * from user_info where id = #{id}")
    UserInfo selectById(Integer id);
    @Select("select * from user_info where username = #{username}")
    UserInfo selectByUsername(String username);
}

MyBatis 會(huì)自動(dòng)將 delete_flag 映射為 deleteFlag，create_time 映射為 createTime，

建議在項(xiàng)目初期就統(tǒng)一數(shù)據(jù)庫(kù)命名規(guī)范，并開(kāi)啟 map-underscore-to-camel-case 配置，這樣可以最大程度減少冗余的映射代碼。

到此這篇關(guān)于MyBatis 字段映射的解決方案的文章就介紹到這了,更多相關(guān)mybatis 字段映射內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: