# 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 參數傳遞方法！
)
