彻底搞懂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>

在为数据库表创立索引的示例中，表名，索引名和加索引的列的列名全部都需求运用${}作为参数占位符，不然会报错。在对查询成果集进行排序的示例中，假如列名占位符不运用${}而运用#{}，不会报错，可是无法完成根据指定列进行排序的功用。

总结

下面临#{}和${}这两种占位符的运用进行一个总结。

1. #{}占位符会被解析为JDBC中的预编译语句（Prepared Statement）中的参数占位符?，一个#{}会被解析为一个?，而${}占位符标识的位置会直接被替换为入参，是简单的字符串替换；
2. #{}进行占位符替换后参数会增加上''号，而${}不会；
3. #{}可以避免SQL注入，以及提高SQL语句履行效率，而${}不具备这些功用；
4. 当入参为表名和列名时，需求运用${}作为表名和列名的参数占位符。