一文搞懂Mybatis中Mapper配置文件獲取參數(shù)的五種方式
前提提要
本系列Mybatis筆記基于mybatis3.5.2 , https://github.com/mybatis/mybatis-3/releases/tag/mybatis-3.5.2中有詳細(xì)的文檔說(shuō)明,可以進(jìn)行下載閱讀,本文只是對(duì)Mybatis的一些常用操作進(jìn)行匯總總結(jié)。
- IDE: IntelliJ IDEA 2021.3
- 構(gòu)建工具: apache-maven-3.6.3
- MySQL版本:MySQL 5.7.35
- MyBatis版本:MyBatis 3.5.7
對(duì)于mybatis框架的使用,按照上次介紹的,我們配置的映射文件中,通過(guò)namespace將映射文件和接口關(guān)聯(lián)起來(lái)了。
具體方法通過(guò)id精確的對(duì)應(yīng)。然后,方法對(duì)應(yīng)的具體數(shù)據(jù)操作,在mapper文件中的<insert><select>.... 書(shū)寫具體的SQL語(yǔ)句來(lái)進(jìn)行實(shí)現(xiàn)。
但是,對(duì)于一些需要傳輸數(shù)據(jù)的行為,如條件查詢,插入操作等等,都需要將用戶調(diào)用接口的實(shí)際參數(shù)數(shù)據(jù),落實(shí)到具體的mapper文件中的各個(gè)方法中。
問(wèn)題來(lái)了?
給接口的實(shí)際參數(shù),mapper實(shí)際操作如何取對(duì)應(yīng)的數(shù)據(jù), 數(shù)據(jù)是以什么方式傳遞給mapper中各標(biāo)簽實(shí)現(xiàn)數(shù)據(jù)的CRUD操作的呢?
一,IDEA中設(shè)置各種配置文件的模板
這節(jié)內(nèi)容主要就是平時(shí)開(kāi)發(fā)過(guò)程中的技巧性操作。
1. 設(shè)置mybatis-config.xml文件模板
模板內(nèi)容:
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<properties resource="jdbc.properties"></properties>
<typeAliases>
<package name=""></package>
</typeAliases>
<!--設(shè)置連接數(shù)據(jù)庫(kù)的環(huán)境-->
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${jdbc.driver}"/>
<property name="url"
value="${jdbc.url}"/>
<property name="username" value="${jdbc.username}"/>
<property name="password" value="${jdbc.password}"/>
</dataSource>
</environment>
</environments>
<!--引入映射文件-->
<mappers>
<package name=""/>
</mappers>
</configuration>
在IDEA中添加mybatis-config.xml文件模板的具體操作:

最后的效果如圖所示,新建完上述模板之后,就可以按照上述你創(chuàng)建的模板創(chuàng)建一個(gè)mybatis-config.xml文件。

2. 設(shè)置 **mapper.xml映射文件模板
和上述mybatis-confg.xml設(shè)置文件模板一樣,模板內(nèi)容如下:
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="">
</mapper>
具體的操作和設(shè)置mybatis-config.xml操作是一樣的。

二,獲取參數(shù)的兩種方式
在談將調(diào)用接口的實(shí)際參數(shù)傳給mapper中各個(gè)標(biāo)簽實(shí)際操作是什么樣之前,我們先看看mapper中獲取參數(shù)的兩種方式,我們知道JDBC中有兩種設(shè)置參數(shù)的方式:
通過(guò)參數(shù)預(yù)處理的方式 2. 通過(guò)拼接SQL的方式
@Test
public void testJDBC() throws SQLException, ClassNotFoundException {
String username = "cherry";
Class.forName("");
Connection connection = DriverManager.getConnection("", "", "");
// 1. 字符串拼接 ->獲得預(yù)編譯對(duì)象 -》sql注入問(wèn)題
PreparedStatement preparedStatement = connection.prepareStatement("select * from t_user where username = '" + username + "'");
// 2. 占位符
PreparedStatement ps2 = connection.prepareStatement("select * from t_user where username = ?");
ps2.setString(1, username);
}
對(duì)應(yīng)于MyBatis中,我們也有這兩種方式:1. 字符串拼接 2. 占位符
MyBatis獲取參數(shù)值的兩種方式:${}和#{},就和JDBC中的兩種方式一脈相承。
${}的本質(zhì)就是字符串拼接#{}的本質(zhì)就是占位符賦值
${}使用字符串拼接的方式拼接sql,若為字符串類型或日期類型的字段進(jìn)行賦值時(shí),需要手動(dòng)加單引號(hào);
但是#{}使用占位符賦值的方式拼接sql,此時(shí)為字符串類型或日期類型的字段進(jìn)行賦值時(shí),可以自動(dòng)添加單引號(hào)(盡量使用這一種)。
三,MyBatis獲取參數(shù)值的五種情況
通過(guò)了上述說(shuō)明了Mybatis中兩種獲取基本方式的區(qū)別。下面通過(guò)給接口床傳遞實(shí)參不同的形式來(lái)劃分為一下五種情況進(jìn)行一一的說(shuō)明。
3.1 單個(gè)字面量類型的參數(shù)
也就是如果調(diào)用的形式是:
getUserById(1)
若mapper接口中的方法參數(shù)為單個(gè)的字面量類。此時(shí)可以使用${}和#{}以任意的名稱獲取參數(shù)的值,注意${}需要手動(dòng)加單引號(hào)。
如下所示:
public interface ParameterMapper {
/**
* 單個(gè)的字面量類型:
* 根據(jù)用戶名查詢用戶信息
*/
User getUserByUserName(String username);
}
在對(duì)應(yīng)的配置類中進(jìn)行配置,按照上述的方式,都可以進(jìn)行配置,如下:
Notice:使用#{},里面內(nèi)容可以隨便寫,都是傳進(jìn)來(lái)的username的值。
方式一:
<!-- User getUserByUserName(String username);-->
<!-- 使用#{},里面內(nèi)容可以隨便寫,都是傳進(jìn)來(lái)的username的值-->
<select id="getUserByUserName" resultType="User">
select * from t_user where username = #{username}
</select>
方式二:
<!-- User getUserByUserName(String username);-->
<select id="getUserByUserName" resultType="User">
<!--
select * from t_user where username = ${username}
如果使用這種方式,得到的sql語(yǔ)句是:
Preparing: select * from t_user where username = RUOYI
而其中username的值‘RUOYI'沒(méi)有單引號(hào),語(yǔ)句不正確,會(huì)報(bào)錯(cuò)。
因此要手動(dòng)添加單引號(hào)
-->
select * from t_user where username = '${username}'
</select>
測(cè)試類:
/**
* MyBatis獲取參數(shù)值的各種情況:
* 情況1: mapper接口方法的參數(shù)為單個(gè)字面量的參數(shù)
* 可以通過(guò)${} #{}以任意的字符串獲得參數(shù)值,但需要注意${}的單引號(hào)問(wèn)題
*/
@Test
public void testgetUserByUserName(){
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
ParameterMapper mapper = sqlSession.getMapper(ParameterMapper.class);
User user = mapper.getUserByUserName("");
System.out.println(user);
}
3.2 多個(gè)字面量類型的參數(shù)
若在mapper接口的方法中有多個(gè)參數(shù)的時(shí)候,我們MyBatis的操作是會(huì)自動(dòng)的將這些參數(shù)放到一個(gè)Map集合中。通過(guò)以arg0, arg1, arg2... argn,以參數(shù)值為值。還有一種就是通過(guò)param1, param2...,以參數(shù)為值。
因此,只要通過(guò)#{}或者是${}訪問(wèn)map集合中的鍵就可以獲取到對(duì)應(yīng)的值。但是需要注意的是${}需要手動(dòng)加上單引號(hào)。
public interface ParameterMapper {
/**
* 驗(yàn)證登錄
*/
User checkLogin(String username, String password);
}
對(duì)應(yīng)在mapper映射文件中:
<!-- User checkLogin(String username, String password);-->
<select id="checkLogin" resultType="User">
<!--
寫:select * from t_user where username = #{username} and password = #{password}
會(huì)報(bào)錯(cuò):Parameter 'username' not found. Available parameters are [arg1, arg0, param1, param2]
因?yàn)閟ql語(yǔ)句沒(méi)有解析成功-->
<!--以map集合形式存儲(chǔ),arg0->param0, arg1->param1,這時(shí)直接用鍵arg訪問(wèn)就好了,用param訪問(wèn)也行。
以下兩種方式選一個(gè):-->
select * from t_user where username = #{arg0} and password = #{arg1}
select * from t_user where username = '${param1}' and password = '${param2}'
</select>
測(cè)試類:
/**
* 情況2:mapper接口方法的參數(shù)為多個(gè)時(shí)
* 此時(shí)MyBatis會(huì)將這些參數(shù)放在一個(gè)map集合中,以兩種方式進(jìn)行存儲(chǔ)
* a》以arg0,arg1。。為鍵,參數(shù)為值
* b》以param0,param1。。為鍵,參數(shù)位置
* 因此只需要通過(guò)#{}和${}以鍵的方式訪問(wèn)值即可,但需要注意${}的單引號(hào)問(wèn)題
*/
@Test
public void testCheckLogin(){
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
ParameterMapper mapper = sqlSession.getMapper(ParameterMapper.class);
User user = mapper.checkLogin("fangshaolei","123456");
System.out.println(user);
}
Notice: 寫:select * from t_user where username = #{username} and password = #{password}
會(huì)報(bào)錯(cuò):Parameter 'username' not found. Available parameters are [arg1, arg0, param1, param2] 因?yàn)?code>sql語(yǔ)句沒(méi)有解析成功
3.3 Map集合類型的參數(shù)
我們大概有了一些思路,基本上對(duì)于所有的參數(shù)。Mybatis的操作都是先將所有的參數(shù)都封裝到一個(gè)map中,然后在mapper中使用#{}或者是${}來(lái)進(jìn)行取。
如果mapper接口中的方法需要的參數(shù)為多個(gè)時(shí),此時(shí)可以手動(dòng)創(chuàng)建map集合,也就是我們不在通過(guò)mybatis來(lái)進(jìn)行創(chuàng)建參數(shù),而是手動(dòng)的自己傳過(guò)去一個(gè)map。
所以,將這些數(shù)據(jù)放在map中只需要通過(guò)${}和#{}訪問(wèn)map集合的鍵就可以獲取相對(duì)應(yīng)的值,注意${}需要手動(dòng)加單引號(hào).
public interface ParameterMapper {
/**
* 驗(yàn)證登錄
*/
User checkLoginByMap(Map<String, Object> map);
}
在對(duì)應(yīng)的map中進(jìn)行取用的操作。
<!-- User checkLoginByMap(Map<String, Object> map);-->
<select id="checkLoginByMap" resultType="User">
select * from t_user where username = #{username} and password = #{password}
</select>
測(cè)試類:
/**
* 情況3:若mapper接口方法的參數(shù)有多個(gè)時(shí),可以手動(dòng)將這些參數(shù)放在一個(gè)map中存儲(chǔ)
* 只需要通過(guò)#{} ${}以鍵的方式訪問(wèn)值即可,但是需要注意${}的單引號(hào)問(wèn)題
*/
@Test
public void testCheckLoginByMap(){
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
ParameterMapper mapper = sqlSession.getMapper(ParameterMapper.class);
Map<String, Object> map = new HashMap<>();
map.put("username","RUOYI");
map.put("password","123456");
User user = mapper.checkLoginByMap(map);
System.out.println(user);
}
Notice:但是需要注意的是,對(duì)于自己封裝的map的形式,在使用兩種方式進(jìn)行取用的時(shí)候,需要指定在map中的鍵,也就是我們自己存在map數(shù)據(jù)中的鍵。
3.4 實(shí)體類參數(shù)
如果mapper接口中的方法參數(shù)是實(shí)體類對(duì)象的時(shí)候,此時(shí)可以使用 #{}和${},通過(guò)訪問(wèn)實(shí)體類對(duì)象中的屬性名獲取屬性值,同樣需要注意的是:${}需要手動(dòng)加上單引號(hào)。
其實(shí),實(shí)體類對(duì)象參數(shù),在mybatis中會(huì)被封裝成map對(duì)象的形式。Mapper對(duì)應(yīng)的接口:
public interface ParameterMapper {
/**
* 添加用戶信息
*/
int insertUser(User user);
}
Mapper.xml文件中的配置:
<!-- int insertUser(User user);-->
<!-- 找到相對(duì)應(yīng)的get方法,如username->找getUsername(),看get/set方法-->
<insert id="insertUser">
insert into t_user values(null, #{username}, #{password}, #{age}, #{gender}, #{email})
</insert>
測(cè)試類:
/**
* 情況4:mapper接口方法的參數(shù)是實(shí)體類類型的參數(shù)(web從control層傳過(guò)來(lái)的)
* 只需要通過(guò)#{} ${}以屬性的方式訪問(wèn)屬性值即可,但是需要注意${}的單引號(hào)問(wèn)題
*/
@Test
public void testInsertUser(){
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
ParameterMapper mapper = sqlSession.getMapper(ParameterMapper.class);
User user = new User(null, "fangshaolei", "123456", 66, "m", "sl.fang@gmail.com");
mapper.insertUser(user);
}
Notice:同樣需要注意的是,#{}中的參數(shù)名稱不能隨意的寫,要和屬性名稱一致。
3.5 使用@Param標(biāo)識(shí)參數(shù)
通過(guò)上述的四種方法,我們知道,除了只有一個(gè)字面量參數(shù)之外。其他的參數(shù)通過(guò)#{}或者是${}取用的值都需要正確的給定Mybatis內(nèi)部map的鍵。
如果是多個(gè)字面量,按照Mybatis內(nèi)部默認(rèn)的鍵來(lái)進(jìn)行取用。如果傳過(guò)來(lái)的參數(shù)是自己定義的Map或者是實(shí)體類對(duì)象的形式。則在取用的時(shí)候,指定參數(shù)名稱和自定義Map的鍵一致和如果參數(shù)是實(shí)體類對(duì)象,則需要和對(duì)象的屬性名一致。
但是,我們能夠自定義Mybatis內(nèi)部已經(jīng)封裝好的Map的key,從而通過(guò)#{}或者是${}的形式,利用我們自定義的key來(lái)進(jìn)行取用呢?
這就需要通過(guò)@Param來(lái)實(shí)現(xiàn)。
可以通過(guò)@Param注解標(biāo)識(shí)mapper接口中的方法參數(shù)。此時(shí),會(huì)將這些參數(shù)放在map集合中,以@Param注解的value屬性值為鍵,以參數(shù)為值;
以 param1,param2...為鍵,以參數(shù)為值;
只需要通過(guò)${}和#{}訪問(wèn)map集合的鍵就可以獲取相對(duì)應(yīng)的值, 注意${}需要手動(dòng)加單引號(hào)。
public interface ParameterMapper {
/**
* 驗(yàn)證登錄 (使用@Param)
*/
User checkLoginByParam(@Param("username") String username, @Param("password") String password);
}
對(duì)應(yīng)的mapper.xml配置:
<!-- 以@Param的值為鍵,參數(shù)為值; 或以"param1"/"param2"為鍵,參數(shù)為值-->
<!-- User checkLoginByParam(@Param("username") String username, @Param("password") String password);-->
<select id="checkLoginByParam" resultType="User">
select * from t_user where username = #{username} and password = #{password}
</select>
測(cè)試類:
/**
* 情況5:使用@Param注解來(lái)命名參數(shù)
* 此時(shí)MyBatis會(huì)將這些參數(shù)放在一個(gè)map集合中,以兩種方式進(jìn)行存儲(chǔ)
* a》以@Param的值為鍵,參數(shù)為值; @Param(value = "xxx")
* b》以param0,param1...為鍵,參數(shù)為值
*/
@Test
public void testCheckLoginByParam(){
SqlSession sqlSession = SqlSessionUtils.getSqlSession();
ParameterMapper mapper = sqlSession.getMapper(ParameterMapper.class);
User user = mapper.checkLoginByParam("fangshaolei","123456");
System.out.println(user);
}
四,總結(jié)
以上就是一文搞懂Mybatis中Mapper配置文件獲取參數(shù)的五種方式的詳細(xì)內(nèi)容,更多關(guān)于Mybatis Mapper獲取參數(shù)的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章!
- Mybatis之mapper接口多參數(shù)方式
- Mybatis往Mapper.xml文件中傳遞多個(gè)參數(shù)問(wèn)題
- MyBatis在mapper中傳遞參數(shù)的四種方式
- Mybatis中關(guān)于自定義mapper.xml時(shí),參數(shù)傳遞的方式及寫法
- MyBatis在Mapper中傳遞多個(gè)參數(shù)的四種方法詳解
- Mybatis?Mapper中多參數(shù)方法不使用@param注解報(bào)錯(cuò)的解決
- mybatis?mapper.xml?注釋帶參數(shù)的坑及解決
- MyBatis Mapper接受參數(shù)的四種方式代碼解析
- 解決Mybatis?mappe同時(shí)傳遞?List?和其他參數(shù)報(bào)錯(cuò)的問(wèn)題
相關(guān)文章
Spring?Boot?整合RocketMq實(shí)現(xiàn)消息過(guò)濾功能
Java中CopyOnWriteArrayList的使用解析
在SpringBoot項(xiàng)目中解決依賴沖突問(wèn)題的方法
mybatis+lombok出現(xiàn)java.lang.IndexOutOfBoundsException錯(cuò)誤及解決
從基礎(chǔ)到實(shí)戰(zhàn)詳解SpringBoot獲取資源文件全指南

