java mybatis怎么用注解开发

在 MyBatis 中，使用注解开发可以省去 XML 映射文件，直接在 Mapper 接口上用注解写 SQL。下面从 基础用法 → 常用注解 → 示例 → 注意事项 给你讲清楚。

一、基本使用步骤

1️⃣ 创建 Mapper 接口

不需要写实现类，MyBatis 会自动生成代理对象。

@Mapper
public interface UserMapper {

    @Select("SELECT * FROM user WHERE id = #{id}")
    User getUserById(Integer id);
}

如果是 Spring Boot，@Mapper 或 @MapperScan 二选一即可。

2️⃣ 在 Spring Boot 中扫描 Mapper

@SpringBootApplication
@MapperScan("com.example.mapper")
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

二、常用注解汇总

三、CRUD 示例

1️⃣ 查询（单参数）

@Select("SELECT * FROM user WHERE id = #{id}")
User getUserById(@Param("id") Integer id);

2️⃣ 插入（返回自增主键）

@Insert("INSERT INTO user(name, age) VALUES(#{name}, #{age})")
@Options(useGeneratedKeys = true, keyProperty = "id")
int insertUser(User user);

3️⃣ 更新

@Update("UPDATE user SET name=#{name} WHERE id=#{id}")
int updateUser(User user);

4️⃣ 删除

@Delete("DELETE FROM user WHERE id = #{id}")
int deleteUser(Integer id);

四、结果映射（字段不一致）

方式一：@Results

@Select("SELECT id, user_name FROM user")
@Results({
    @Result(column = "user_name", property = "userName")
})
List<User> listUsers();

方式二：开启驼峰自动映射（推荐）

mybatis:
  configuration:
    map-underscore-to-camel-case: true

@Select("SELECT * FROM user")
List<User> listUsers();

五、多参数用法

@Select("SELECT * FROM user WHERE name=#{name} AND age=#{age}")
User getUser(@Param("name") String name, @Param("age") Integer age);

六、动态 SQL（复杂情况）

使用 @SelectProvider

@SelectProvider(type = UserSqlProvider.class, method = "findUser")
List<User> findUser(String name);

public class UserSqlProvider {
    public String findUser(String name) {
        return "SELECT * FROM user WHERE name = '" + name + "'";
    }
}

⚠️ 动态 SQL 复杂时，建议仍用 XML

七、注解 vs XML 如何选择？

✅ 适合注解

• SQL 简单
• CRUD 少
• 快速开发

❌ 不适合注解

• 复杂动态 SQL
• 多表关联
• SQL 很长

八、总结一句话

MyBatis 注解 = Mapper 接口 + SQL 注解，适合简单 SQL；复杂 SQL 用 XML 更清晰。

如果你愿意，我可以：

• 给你一个 完整 Spring Boot + MyBatis 注解 Demo
• 或对比 注解 vs XML 实战案例
• 或讲 MyBatis-Plus 注解方式

你想看哪个？