MyBatis中的占位符入参全面详解
更新时间：2023年03月01日 11:27:11 作者：半夏之沫
这篇文章主要为大家介绍了MyBatis中的占位符全面详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
前言
#{}占位符会被解析为JDBC中的预编译语句（Prepared Statement）中的参数占位符?，一个#{}会被解析为一个?。
${}占位符标识的位置会直接被替换为入参，是简单的字符串替换。
本篇文章将结合不同的入参场景对#{}和${}进行分析。
正文
一. 入参是基本类型并且参数个数为1
映射接口中查询单条记录的方法定义如下。
// 使用#{}作为参数占位符
MyInfo getMyInfoByNameUseWell(String infoName);
// 使用${}作为参数占位符
MyInfo getMyInfoByNameUseDollar(String infoName);
与之对应的映射文件中的查询标签定义如下。
<select id="getMyInfoByNameUseWell" resultMap="myInfoMap">
SELECT * FROM myinfo WHERE info_name = #{name}
</select>
<select id="getMyInfoByNameUseDollar" resultMap="myInfoMap">
SELECT * FROM myinfo WHERE info_name = '${name}'
</select>
入参是基本类型（示例中是String类型）且参数个数只有一个时，使用#{}和${}占位符均不要求占位符指定的名称与映射接口中的参数名相等，但是#{}进行占位符替换后参数会添加上''号，而${}进行占位符替换是直接进行字符串替换，所以上述示例中，使用${}占位符时需要在占位符两侧添加''号。
二. 入参是基本类型并且参数个数大于1
映射接口中查询单条记录的方法定义如下。
// 使用#{}作为参数占位符
MyInfo getMyInfoByNameTypeUseWell(@Param("infoName") String infoName, @Param("infoType") String infoType);
// 使用${}作为参数占位符
MyInfo getMyInfoByNameTypeUseDollar(@Param("infoName") String infoName, @Param("infoType") String infoType);
与之对应的映射文件中的查询标签定义如下。
<select id="getMyInfoByNameTypeUseWell" resultMap="myInfoMap">
SELECT * FROM myinfo WHERE info_name = #{infoName} AND info_type = #{infoType}
</select>
<select id="getMyInfoByNameTypeUseDollar" resultMap="myInfoMap">
SELECT * FROM myinfo WHERE info_name = '${infoName}' AND info_type = '${infoType}'
</select>
入参是基本类型且参数个数大于一个时，此时需要在映射接口的方法中使用@Param注解定义参数的名称，并且要求占位符指定的名称需要与@Param注解定义的名称相等，否则报错。
三. 入参是自定义类型
映射接口中查询单条记录的方法定义如下。
// 使用#{}作为参数占位符
MyInfo getMyInfoByQueryParamUseWell(QueryParam queryParam);
// 使用${}作为参数占位符
MyInfo getMyInfoByQueryParamUseDollar(QueryParam queryParam);
其中自定义类型QueryParam定义如下。
@Data
public class QueryParam {
private String infoName;
private String infoType;
public QueryParam(String infoName, String infoType) {
this.infoName = infoName;
this.infoType = infoType;
}
}
与之对应的映射文件中的查询标签定义如下。
<select id="getMyInfoByQueryParamUseWell" resultMap="myInfoMap"
parameterType="com.learn.mybatis.dynamic.entity.QueryParam">
SELECT * FROM myinfo WHERE info_name = #{infoName} AND info_type = #{infoType}
</select>
<select id="getMyInfoByQueryParamUseDollar" resultMap="myInfoMap"
parameterType="com.learn.mybatis.dynamic.entity.QueryParam">
SELECT * FROM myinfo WHERE info_name = '${infoName}' AND info_type = '${infoType}'
</select>
入参是自定义类型时，占位符指定的名称需要与自定义类型中的字段名相同，否则报错。
四. 入参是Map类型
映射接口中查询单条记录的方法定义如下。
// 使用#{}作为参数占位符
MyInfo getMyInfoByMapUseWell(Map<String, Object> queryParamMap);
// 使用${}作为参数占位符
MyInfo getMyInfoByMapUseDollar(Map<String, Object> queryParamMap);
与之对应的映射文件中的查询标签定义如下。
<select id="getMyInfoByMapUseWell" resultMap="myInfoMap">
SELECT * FROM myinfo WHERE info_name = #{infoName} AND info_type = #{infoType}
</select>
<select id="getMyInfoByMapUseDollar" resultMap="myInfoMap">
SELECT * FROM myinfo WHERE info_name = '${infoName}' AND info_type = '${infoType}'
</select>
入参是Map时，占位符指定的名称需要与Map的key相等，这样才能将key对应的value与占位符进行替换。
五. 只能使用${}的场景
通过上面几点分析，发现大多数能够使用${}占位符的场景都可以使用#{}占位符，而且#{}占位符相比${}占位符还具有能够防止SQL注入和提高执行速度的功能，但是如下几种场景，只能够使用${}占位符。
1. 入参是表名
当入参是表名时，此时如果表名的参数占位符使用#{}，会报错，因为表名不确定时，是无法进行预编译SQL的，所以这种场景只能使用${}作为表名的参数占位符。下面是示例。
映射接口中的示例方法定义如下。
// 传入表名实现动态创建表
void createMyInfoTable(String tableName);
// 传入表名动态指定被查询的表
MyInfo getMyInfoByNameUseWellDynmic(@Param("tableName") String tableName, @Param("infoName") String infoName);
与之对应的映射文件中的标签定义如下。
<update id="createMyInfoTable">
CREATE TABLE ${tableName} (
id INT(11) PRIMARY KEY AUTO_INCREMENT,
info_name VARCHAR(255),
info_type ENUM('USER', 'HOUSE', 'CAR'),
info_detail VARCHAR(255),
info_seq INT(11)
)
</update>
<select id="getMyInfoByNameUseWellDynmic" resultMap="myInfoMap">
SELECT * FROM ${tableName} WHERE info_name = #{infoName}
</select>
2. 入参是列名
当入参是列名时，此时也只能使用${}作为列名的参数占位符。下面是示例。
映射接口中的方法定义如下。
// 为数据库表创建索引
// 表名，索引名，加索引的列的列名全部动态指定
void createIndex(@Param("tableName") String tableName,
@Param("indexName") String indexName,
@Param("columnNames") List<String> columnNames);
// 对查询结果集进行排序并动态指定排序的列名
List<MyInfo> getMyInfosSorted(String columnName);
与之对应的映射文件中的标签定义如下。
<update id="createIndex">
CREATE INDEX
${indexName}
ON
${tableName}
<foreach collection="columnNames" item="columnName"
open="(" separator="," close=")">
${columnName}
</foreach>
</update>
<select id="getMyInfosSorted" resultMap="myInfoMap">
SELECT * FROM myinfo ORDER BY ${columnName} DESC
</select>
在为数据库表创建索引的示例中，表名，索引名和加索引的列的列名全部都需要使用${}作为参数占位符，否则会报错。在对查询结果集进行排序的示例中，如果列名占位符不使用${}而使用#{}，不会报错，但是无法实现根据指定列进行排序的功能。
总结
下面对#{}和${}这两种占位符的使用进行一个总结。
#{}占位符会被解析为JDBC中的预编译语句（Prepared Statement）中的参数占位符?，一个#{}会被解析为一个?，而${}占位符标识的位置会直接被替换为入参，是简单的字符串替换；#{}进行占位符替换后参数会添加上''号，而${}不会；#{}可以防止SQL注入，以及提高SQL语句执行效率，而${}不具备这些功能；- 当入参为表名和列名时，需要使用
${}作为表名和列名的参数占位符。
以上就是MyBatis中的占位符全面详解的详细内容，更多关于MyBatis占位符的资料请关注脚本之家其它相关文章！
相关文章
这篇文章主要介绍了Spring Boot加密配置文件特殊内容的相关知识，本文通过图文并茂的形式给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下2020-05-05
这篇文章主要介绍了Java中的模板模式说明与实现,模板方法模式,又叫模板模式,在一个抽象类公开定义了执行它的方法的模板,它的子类可以更需要重写方法实现,但可以成为典型类中定义的方式进行,需要的朋友可以参考下2023-10-10
MyBatis是一个优秀的持久层框架，它对jdbc的操作数据库的过程进行封装，使开发者只需要关注SQL本身，而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码，本文将作为最终篇为大家介绍MyBatis的使用2022-07-07
这篇文章主要介绍了Java之Thread的join方法,实例形式讲述了join方法的应用,需要的朋友可以参考下2014-10-10
这篇文章主要介绍了Java中List＜T＞和List＜?＞的区别详解。文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2020-12-12
在日常Java学习或项目开发中,经常会遇到需要int[]数组和List列表相互转换的场景,然而往往一时难以想到有哪些方法,最后可能会使用暴力逐个转换法,往往不是我们所满意的,下面这篇文章主要给大家介绍了关于Java中List与数组之间的相互转换,需要的朋友可以参考下2023-05-05
这篇文章主要为大家分享了最有价值的三道关于并发编程的面试题，涵盖内容全面，包括数据结构和算法相关的题目、经典面试编程题等，感兴趣的小伙伴们可以参考一下2021-08-08
这篇文章主要介绍了springboot中使用rabbitt,通过本文学习让我们了解如何在Spring Boot中使用RabbitMQ，并使用不同的交换机和队列类型以及消息确认模式，需要的朋友可以参考下2023-05-05
这篇文章主要介绍了Java工程mybatis实现多表查询过程详解,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2020-06-06
这篇文章主要介绍了Java实现的微信公众号获取微信用户信息,结合实例形式分析了Java微信公众号获取微信用户信息相关原理、步骤与操作注意事项,需要的朋友可以参考下2019-10-10
最新评论