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

MVN--07

news 2026/6/8 21:02:06

一、MyBatis 参数封装规则

MyBatis 会根据接口方法的参数类型，自动进行不同的封装处理，核心由ParamNameResolver类实现。

1. 单个参数的封装规则

表格

参数类型	封装规则	XML 中取值方式
POJO 实体类	直接使用，无需额外处理	`#{属性名}`（属性名与占位符名称一致）
Map 集合	直接使用，无需额外处理	`#{键名}`（键名与占位符名称一致）
Collection 集合	封装为 Map，默认 key 为`collection`、`arg0`	`#{collection}`/`#{arg0}`，建议用`@Param`自定义 key
List 集合	封装为 Map，默认 key 为`collection`、`list`、`arg0`	`#{collection}`/`#{list}`/`#{arg0}`，建议用`@Param`自定义 key
Array 数组	封装为 Map，默认 key 为`array`、`arg0`	`#{array}`/`#{arg0}`，建议用`@Param`自定义 key
其他类型（String/int 等）	直接使用，无需封装	`#{任意名称}`（名称不影响取值）

2. 多个参数的封装规则

默认封装：MyBatis 会自动将多个参数封装为 Map，默认 key 为：
- arg0、arg1...（按参数顺序）
- param1、param2...（按参数顺序，MyBatis 3.4.2+ 支持）

@Param 注解优化：使用@Param("自定义key")注解，可替换默认的arg键名，大幅提升代码可读性。

java

运行

// 接口方法 User select(@Param("username") String username, @Param("password") String password); // XML 映射文件 <select id="select" resultType="user"> select * from tb_user where username = #{username} and password = #{password}; </select>

3. 核心建议

无论单个集合 / 数组参数，还是多个普通参数，都建议统一使用@Param注解自定义 key，避免依赖默认键名，提升代码可维护性和可读性。

二、MyBatis 注解开发

MyBatis 支持纯注解开发，无需编写 XML 映射文件，适合简单 CRUD 场景。

1. 核心注解

表格

操作类型	对应注解	示例
查询	`@Select`	`@Select("select * from tb_user where id = #{id}")`
添加	`@Insert`	`@Insert("insert into tb_user values(#{id},#{username},#{password})")`
修改	`@Update`	`@Update("update tb_user set username=#{username} where id=#{id}")`
删除	`@Delete`	`@Delete("delete from tb_user where id=#{id}")`

2. 完整示例

java

运行

public interface UserMapper { // 根据ID查询用户 @Select("select * from tb_user where id = #{id}") public User selectById(int id); // 新增用户 @Insert("insert into tb_user(username, password) values(#{username}, #{password})") public int add(User user); // 修改用户 @Update("update tb_user set username=#{username}, password=#{password} where id=#{id}") public int update(User user); // 删除用户 @Delete("delete from tb_user where id=#{id}") public int deleteById(int id); }

3. 注解 vs XML 开发对比

表格

开发方式	适用场景	优缺点
注解开发	简单 CRUD、单表操作	✅ 代码简洁、开发效率高；❌ 复杂 SQL、动态 SQL 维护困难
XML 开发	复杂 SQL、动态 SQL、多表关联	✅ 结构清晰、可维护性强；❌ 开发流程稍繁琐