MyBatis 參數(shù)綁定的具體實現(xiàn)
更新時間：2026年01月26日 09:43:36 作者：Yrui.
本文主要介紹了MyBatis 參數(shù)綁定的具體實現(xiàn),包括默認參數(shù)名、@Param注解和POJO/DTO對象三種方式,文中通過示例代碼介紹的非常詳細,對大家的學(xué)習或者工作具有一定的參考學(xué)習價值,需要的朋友們下面隨著小編來一起學(xué)習學(xué)習吧
一、MyBatis 參數(shù)綁定機制
1.1 核心概念
當 Mapper 接口方法接收多個參數(shù)時，MyBatis 提供三種參數(shù)綁定方式：
- 默認參數(shù)名：
arg0、arg1（Java 8+）或param1、param2 - @Param 注解：顯式指定參數(shù)名稱
- POJO/DTO 對象：通過對象屬性訪問（本教程不涉及）
二、arg 參數(shù)（參數(shù)順序索引）
2.1 使用場景
適用于沒有使用 @Param 注解的情況，通過參數(shù)在方法中的順序位置進行綁定。
2.2 XML 映射示例
<select id="findBySalary2" resultType="Emp">
SELECT * FROM emp
WHERE salary >= #{arg0} AND salary <= #{arg1}
</select>2.3 Java 接口定義
List<Emp> findBySalary2(Double start, Double end);
2.4 特點
- 索引從
0開始 - 參數(shù)順序敏感（調(diào)換參數(shù)順序會導(dǎo)致邏輯錯誤）
- 可讀性較低（推薦在參數(shù)較少時使用）
三、param 參數(shù)（自動編號索引）
3.1 使用場景
MyBatis 為每個參數(shù)自動生成的別名，編號從 1 開始。
3.2 XML 映射示例
<select id="findBySalary1" resultType="Emp">
SELECT * FROM emp
WHERE salary >= #{param1} AND salary <= #{param2}
</select>3.3 Java 接口定義
List<Emp> findBySalary1(Double start, Double end);
3.4 特點
- 索引從
1開始 - 與
arg索引共存（可用兩種方式交叉訪問） - 適用于需要明確位置編號的場景
四、@Param 注解（顯式命名參數(shù)）
4.1 使用場景
當需要明確參數(shù)語義或方法有多個參數(shù)時推薦使用。
4.2 XML 映射示例
<select id="findBySalary3" resultType="Emp">
SELECT * FROM emp
WHERE salary >= #{minSalary} AND salary <= #{maxSalary}
</select>4.3 Java 接口定義
List<Emp> findBySalary3(
@Param("minSalary") Double start,
@Param("maxSalary") Double end
);
4.4 特點
- 參數(shù)名與業(yè)務(wù)語義強關(guān)聯(lián)
- 不依賴參數(shù)順序
- 代碼可維護性最佳
- 支持與
param/arg方式混用
五、對比總結(jié)
| 方式 | 索引起點 | 順序敏感性 | 可讀性 | 推薦場景 |
|---|---|---|---|---|
| arg0, arg1 | 0 | 高 | 差 | 簡單查詢（參數(shù)<2） |
| param1, param2 | 1 | 高 | 中 | 需要明確編號的場景 |
| @Param | 自定義 | 無 | 優(yōu) | 多參數(shù)/復(fù)雜業(yè)務(wù)場景 |
六、綜合使用示例
6.1 混合使用場景
<select id="findComplex" resultType="Emp">
SELECT * FROM emp
WHERE
salary >= #{min}
AND salary <= #{param2}
AND name LIKE #{arg2}
</select>6.2 對應(yīng)接口
List<Emp> findComplex(
@Param("min") Double minSalary,
Double maxSalary,
String nameKeyword
);
七、最佳實踐建議
- 參數(shù)超過 2 個時：必須使用 @Param 注解
- 涉及范圍查詢：建議使用 @Param 明確參數(shù)語義
- 維護性考量：優(yōu)先選用 @Param 方式
- 版本兼容性：注意不同 MyBatis 版本對默認別名的支持差異
到此這篇關(guān)于MyBatis 參數(shù)綁定的具體實現(xiàn)的文章就介紹到這了,更多相關(guān)MyBatis 參數(shù)綁定內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
解決SpringBoot使用@Value獲取不到y(tǒng)aml中配置值的問題
在最近的開發(fā)中遇到一個問題,使用@Value獲取yml文件中配置的屬性時始終獲取不到值,所以本文給大家詳細介紹了SpringBoot使用@Value獲取不到y(tǒng)aml中值的問題分析及解決方法,需要的朋友可以參考下2024-01-01
MyBatis?如何使項目兼容多種數(shù)據(jù)庫的解決方案
要想做兼容多種數(shù)據(jù)庫,那毫無疑問,我們首先得明確我們要兼容哪些數(shù)據(jù)庫,他們的數(shù)據(jù)庫產(chǎn)品名稱是什么,本次我們講解了一套使項目兼容多種數(shù)據(jù)庫的方案,對MyBatis項目兼容多種數(shù)據(jù)庫操作方法感興趣的朋友一起看看吧2024-05-05
這篇文章主要為大家分享了最有價值的三道關(guān)于消息隊列的面試題，涵蓋內(nèi)容全面，包括數(shù)據(jù)結(jié)構(gòu)和算法相關(guān)的題目、經(jīng)典面試編程題等，感興趣的小伙伴們可以參考一下2021-08-08
一招教你使用Java執(zhí)行g(shù)roovy腳本的兩種方式
本文主要介紹了一招教你使用Java執(zhí)行g(shù)roovy腳本的兩種方式,一種是通過腳本引擎ScriptEngine提供的eval(String)方法執(zhí)行腳本內(nèi)容,一種是執(zhí)行g(shù)roovy腳本,感興趣的可以了解一下2023-09-09
在SpringBoot中對接MQTT協(xié)議,可以使用Eclipse Paho客戶端和Spring Integration MQTT模塊,文中通過示例代碼介紹的非常詳細,對大家的學(xué)習或者工作具有一定的參考學(xué)習價值,需要的朋友們下面隨著小編來一起學(xué)習學(xué)習吧2026-02-02
Android中PreferenceActivity使用詳解
本文主要介紹了Android中PreferenceActivity使用詳解，文中通過示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2021-09-09
這篇文章主要介紹了Java在web頁面上的編碼解碼處理及中文URL亂碼解決,文中所介紹的兩種使用過濾器解決中文鏈接亂碼的方法非常有效,需要的朋友可以參考下2016-02-02
SpringBoot 使用Prometheus采集自定義指標數(shù)據(jù)的方案
這篇文章主要介紹了SpringBoot 使用Prometheus采集自定義指標數(shù)據(jù),我們在k8s集群成功搭建了Prometheus服務(wù)，今天，我們將在springboot2.x中使用prometheus記錄指標，需要的朋友可以參考下2022-10-10
在 Java 編程的精彩世界里,方法重寫是一項極為重要且實用的特性,它猶如一把神奇的鑰匙,為我們開啟了面向?qū)ο缶幊讨卸鄳B(tài)性的大門,今天,就讓我們一同深入探索 Java 方法重寫的奧秘,感興趣的小伙伴跟著小編一起來看看吧2025-03-03
在Spring中,要想更簡單的存儲和讀取對象的核心是使用注解,這篇文章主要給大家介紹了關(guān)于Spring如何通過注解存儲和讀取對象的相關(guān)資料,文中通過實例代碼介紹的非常詳細,需要的朋友可以參考下2022-07-07