java mybatis怎么映射实体类

在 Java + MyBatis 中，映射实体类（Entity / POJO）主要有 几种常见方式，下面从最常用到进阶给你讲清楚。

一、最基础：resultType 自动映射（推荐）

1️⃣ 实体类

public class User {
    private Integer id;
    private String username;
    private String password;
    // getter / setter
}

2️⃣ Mapper XML

<select id="getUserById" resultType="com.example.entity.User">
    SELECT id, username, password
    FROM user
    WHERE id = #{id}
</select>

✅ 要求

• 数据库字段名 = 实体类属性名（或符合驼峰规则）

二、字段名不一致：resultMap 显式映射（最常用）

数据库字段

user_id
user_name

实体类

public class User {
    private Integer userId;
    private String userName;
}

Mapper XML

<resultMap id="UserMap" type="com.example.entity.User">
    <id column="user_id" property="userId"/>
    <result column="user_name" property="userName"/>
</resultMap>

<select id="getUserById" resultMap="UserMap">
    SELECT user_id, user_name
    FROM user
    WHERE user_id = #{id}
</select>

✅ 适合

• 字段名和属性名不一致
• 复杂结果映射

三、驼峰自动映射（非常推荐）

开启驼峰

# application.yml
mybatis:
  configuration:
    map-underscore-to-camel-case: true

或

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

数据库

user_id  ->  userId
create_time -> createTime

✅ 不需要写 resultMap

四、注解方式（无 XML）

@Select("SELECT id, username FROM user WHERE id = #{id}")
@Results({
    @Result(column = "user_id", property = "userId")
})
User getUserById(Integer id);

✅ 适合 简单项目 / 快速开发

五、MyBatis-Plus（最省事）

@TableName("user")
public class User {
    @TableId
    private Integer id;
    private String username;
}

User user = userMapper.selectById(1);

✅ 几乎零配置

六、常见坑总结

七、你适合哪种？

• ✅ 新手 / 快速开发：驼峰 + resultType
• ✅ 老项目 / 复杂 SQL：resultMap
• ✅ 企业项目：MyBatis-Plus

如果你愿意，可以告诉我：

• 用的是 XML 还是 注解
• 是否 MyBatis-Plus
• 具体报错或字段不一致情况

我可以帮你直接写完整示例。