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ì)象三種方式,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(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ì)象：通過對(duì)象屬性訪問（本教程不涉及）
二、arg 參數(shù)（參數(shù)順序索引）
2.1 使用場景
適用于沒有使用 @Param 注解的情況，通過參數(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 使用場景
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索引共存（可用兩種方式交叉訪問） - 適用于需要明確位置編號(hào)的場景
四、@Param 注解（顯式命名參數(shù)）
4.1 使用場景
當(dāng)需要明確參數(shù)語義或方法有多個(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ù)語義強(qiáng)關(guān)聯(lián)
- 不依賴參數(shù)順序
- 代碼可維護(hù)性最佳
- 支持與
param/arg方式混用
五、對(duì)比總結(jié)
| 方式 | 索引起點(diǎn) | 順序敏感性 | 可讀性 | 推薦場景 |
|---|---|---|---|---|
| arg0, arg1 | 0 | 高 | 差 | 簡單查詢（參數(shù)<2） |
| param1, param2 | 1 | 高 | 中 | 需要明確編號(hào)的場景 |
| @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 對(duì)應(yīng)接口
List<Emp> findComplex(
@Param("min") Double minSalary,
Double maxSalary,
String nameKeyword
);
七、最佳實(shí)踐建議
- 參數(shù)超過 2 個(gè)時(shí)：必須使用 @Param 注解
- 涉及范圍查詢：建議使用 @Param 明確參數(shù)語義
- 維護(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)文章
這篇文章主要介紹了java讀取txt文件內(nèi)容,示例很簡單，代碼里有注釋，大家直接看代碼吧2014-01-01
Kotlin基本類型自動(dòng)裝箱出現(xiàn)問題解決辦法
這篇文章主要介紹了Kotlin基本類型自動(dòng)裝箱出現(xiàn)問題解決辦法的相關(guān)資料,希望通過本文能幫助到大家，讓大家遇到這樣的問題順利解決，需要的朋友可以參考下2017-10-10
在Spring Boot中集成RabbitMQ的實(shí)戰(zhàn)記錄
本文介紹SpringBoot集成RabbitMQ的步驟,涵蓋配置連接、消息發(fā)送與接收,并對(duì)比兩種定義Exchange與隊(duì)列的方式:手動(dòng)聲明(適合復(fù)雜路由)和注解綁定(適合快速開發(fā)),感興趣的朋友跟隨小編一起看看吧2025-06-06
解決Mybatis中mapper.xml文件update,delete及insert返回值問題
這篇文章主要介紹了解決Mybatis中mapper.xml文件update,delete及insert返回值問題，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。一起跟隨小編過來看看吧2020-11-11
Java中DTO與Entity拷貝轉(zhuǎn)換的方法小結(jié)
在?Java?開發(fā)中,DTO（Data?Transfer?Object）和?Entity（實(shí)體類）是常見的兩種數(shù)據(jù)模型,本文將介紹幾種常見的工具類和自定義方式來實(shí)現(xiàn)這種轉(zhuǎn)換,感興趣的可以了解下2025-02-02
這篇文章主要介紹了詳解如何熱更新線上的Java服務(wù)器代碼，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-04-04
這篇文章主要介紹了 MyBatis 復(fù)雜查詢的相關(guān)知識(shí)，本文給大家介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2021-01-01
很多項(xiàng)目都會(huì)封裝規(guī)定好本身項(xiàng)目的接口規(guī)范,所以大多數(shù)需要去調(diào)用對(duì)方提供的接口或第三方接口(短信、天氣等),下面這篇文章主要給大家介紹了關(guān)于Java調(diào)用第三方接口方法的相關(guān)資料,需要的朋友可以參考下2022-06-06
IDEA中調(diào)用方法時(shí),如何同步顯示方法的注釋信息
這篇文章主要介紹了IDEA中調(diào)用方法時(shí),如何同步顯示方法的注釋信息問題,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2025-03-03
MyBatisPlus中使用or()和and()遇到的問題及細(xì)節(jié)處理
這篇文章主要介紹了MyBatisPlus中使用or()和and()遇到的問題,本文通過多種寫法實(shí)例代碼相結(jié)合給大家介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值，需要的朋友可以參考下2020-08-08