MyBatis 中 Mapper 传递参数的多种方法

# MyBatis Mapper 传递参数的多种方法及其优势

在使用 MyBatis 进行数据库操作时，Mapper 接口的参数传递是一个非常基础但又十分重要的部分。不同的参数传递方式适用于不同的场景，合理选择可以大大提高代码的可读性和维护性。本文将详细介绍几种常见的 MyBatis Mapper 参数传递方法及其各自的优势。

## 1. 使用顺序传参法（不推荐）

### 方法描述
直接通过位置来引用参数，例如 `#{0}`、`#{1}` 等。MyBatis 会自动为每个参数分配一个从 0 开始的索引名称（`param1`, `param2`...）。

### 示例代码
```java
List<User> selectUsers(String name, Integer age);
```
XML 中：
```xml
<select id="selectUsers" resultType="User">
    SELECT * FROM users WHERE name = #{param1} AND age = #{param2}
</select>
```

### 优势与局限
- **简单直接**：对于少量且固定的参数，这种方式非常直观。
- **不易维护**：随着参数数量增加或参数顺序调整，容易导致混淆和错误。

## 2. 使用 @Param 注解显式指定参数名称

### 方法描述
通过在接口方法的参数前加上 `@Param` 注解来明确参数名，这样可以在 SQL 映射文件中直接使用该名称进行引用。

### 示例代码
```java
List<User> selectUsers(@Param("name") String name, @Param("age") Integer age);
```
XML 中：
```xml
<select id="selectUsers" resultType="User">
    SELECT * FROM users WHERE name = #{name} AND age = #{age}
</select>
```

### 优势
- **提高可读性**：参数名更加清晰，易于理解。
- **便于维护**：即使参数顺序发生变化，也不会影响 SQL 映射文件中的引用。

## 3. 使用 Map 传递参数

### 方法描述
当参数较多或不确定时，可以使用 Map 来封装参数。Map 的键作为参数名，值则对应实际参数值。

### 示例代码
```java
List<User> selectUsers(Map<String, Object> params);
```
调用时：
```java
Map<String, Object> params = new HashMap<>();
params.put("name", "John");
params.put("age", 30);
mapper.selectUsers(params);
```
XML 中：
```xml
<select id="selectUsers" resultType="User">
    SELECT * FROM users WHERE name = #{name} AND age = #{age}
</select>
```

### 优势
- **灵活性高**：适合动态参数的情况。
- **减少接口变更**：无需频繁修改接口定义。

## 4. 使用对象封装参数

### 方法描述
当一组参数经常一起出现时，可以创建一个 DTO 对象来封装这些参数。这不仅有助于组织代码，还能提供更好的类型安全。

### 示例代码
```java
public class UserQuery {
    private String name;
    private Integer age;
    // Getters and Setters
}

List<User> selectUsers(UserQuery query);
```
XML 中：
```xml
<select id="selectUsers" resultType="User">
    SELECT * FROM users WHERE name = #{name} AND age = #{age}
</select>
```

### 优势
- **增强代码结构**：使代码更加模块化，易于管理和扩展。
- **类型安全**：编译期间即可检查类型错误，减少运行时异常。

## 总结

选择哪种参数传递方式主要取决于具体的应用场景和个人偏好。一般来说：

- 如果只是简单的查询或更新操作，涉及少量参数，使用 `@Param` 注解是最佳选择。
- 当需要处理大量动态参数时，使用 Map 更加灵活。
- 针对一组经常使用的参数，建议使用对象封装，以提升代码的可读性和可维护性。

希望这篇博客能够帮助你更好地理解和选择合适的 MyBatis Mapper 参数传递方法！