当前位置：首页 > news >正文

MyBatis解决实体类（POJO）的字段名和数据库表的列名不一致方法总结（四种方法）

news 2025/4/24 20:51:48

在 MyBatis 中，实体类（POJO）的字段名和数据库表的列名不一致时，有几种常见的方式来解决这个问题。下面将详细介绍每种方式，并给出对应的代码示例。

方法 1：使用 `@Results` 和 `@Result` 注解（适用于注解映射方式）

MyBatis 提供了注解方式，可以通过 @Results 和 @Result 来指定 POJO 中的字段与数据库列名之间的映射关系。

示例代码

假设数据库中的表 user_table 的列名为 user_id, user_name，而实体类 User 的字段名为 id, name。

实体类

public class User {private Integer id;private String name;// Getters and Setterspublic Integer getId() {return id;}public void setId(Integer id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}
}

Mapper 接口

使用 @Results 注解来指定映射关系：

import org.apache.ibatis.annotations.*;@Mapper
public interface UserMapper {@Select("SELECT user_id, user_name FROM user_table WHERE user_id = #{id}")@Results({@Result(property = "id", column = "user_id"),@Result(property = "name", column = "user_name")})User getUserById(@Param("id") Integer id);
}

在这个例子中，@Result 注解将实体类的 id 字段与数据库表的 user_id 列相对应，name 字段与 user_name 列相对应。

方法 2：使用 XML 映射文件

如果你使用的是 XML 映射文件方式，你可以通过 <resultMap> 元素来实现字段和列名的映射。

示例代码

实体类

public class User {private Integer id;private String name;// Getters and Setterspublic Integer getId() {return id;}public void setId(Integer id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}
}

Mapper XML 配置

在 XML 中通过 <resultMap> 来实现映射关系：

<mapper namespace="com.example.mapper.UserMapper"><resultMap id="UserResultMap" type="com.example.domain.User"><result property="id" column="user_id"/><result property="name" column="user_name"/></resultMap><select id="getUserById" resultMap="UserResultMap">SELECT user_id, user_name FROM user_table WHERE user_id = #{id}</select>
</mapper>

在这个例子中，resultMap 定义了 POJO 字段 id 和 name 与数据库列 user_id 和 user_name 的映射关系。然后，在 SQL 查询语句中，通过 resultMap 将结果映射到实体类。

方法 3：修改 SQL 查询语句中的别名

你也可以通过在 SQL 查询中使用列的别名来使其与实体类的字段名匹配。

示例代码

实体类

public class User {private Integer id;private String name;// Getters and Setterspublic Integer getId() {return id;}public void setId(Integer id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}
}

Mapper 接口

在 SQL 查询中使用别名：

import org.apache.ibatis.annotations.*;@Mapper
public interface UserMapper {@Select("SELECT user_id AS id, user_name AS name FROM user_table WHERE user_id = #{id}")User getUserById(@Param("id") Integer id);
}

在这个例子中，AS 关键字用于为查询结果中的列指定别名，使其与实体类字段名匹配。user_id 列被映射为 id，user_name 列被映射为 name。

方法 4：使用 MyBatis 配置的全局 `mapUnderscoreToCamelCase` 属性

MyBatis 提供了一个全局的配置选项，可以自动将数据库表中的下划线命名法转换为驼峰命名法。这在数据库列名使用下划线而实体类字段名使用驼峰命名时非常有用。

示例代码

实体类

public class User {private Integer id;private String name;// Getters and Setterspublic Integer getId() {return id;}public void setId(Integer id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}
}

MyBatis 配置文件

在 MyBatis 的全局配置文件 mybatis-config.xml 中设置 mapUnderscoreToCamelCase：

<configuration><settings><setting name="mapUnderscoreToCamelCase" value="true"/></settings>
</configuration>

Mapper 接口

在这种方式下，你无需做任何额外的映射工作，MyBatis 会自动将下划线命名的数据库列映射到驼峰命名的实体类字段。

import org.apache.ibatis.annotations.*;@Mapper
public interface UserMapper {@Select("SELECT user_id, user_name FROM user_table WHERE user_id = #{id}")User getUserById(@Param("id") Integer id);
}