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