MyBatis中#{}占位符与${}拼接符的使用

深藏阁楼爱情的钟 2021-07-24 20:42 627阅读 0赞

# 1、关于\#\{\}占位符 #

先来看以下的示例，该示例是MyBatis中的SQL映射配置文件（Mapper配置文件），在该配置中使用了\#\{\}占位符。

<?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="test">
        
        <select id="findUserById" parameterType="int" resultType="com.pjb.mybatis.po.User">
            SELECT * FROM tb_user WHERE id = #{id}
        </select>
    
        
        <insert id="insertUser" parameterType="com.pjb.mybatis.po.User">
            INSERT INTO tb_user(user_name,blog_url,remark)
            VALUES(#{userName},#{blogUrl},#{remark});
        </insert>
    </mapper>

在SQL映射配置文章中，输入参数需要用占位符来标识对应的位置。在传统的JDBC编程中，占位符用“?”来标识，然后在加载SQL之前按照“?”的位置设置参数。而“\#\{\}”在MyBatis中也代表一种占位符，该符号接受输入参数，在大括号中编写参数名称来接受对应参数。“\#\{\}”接受的输入参数的类型可以是简单类型、普通JavaBean或者HashMap。当接受简单类型时，“\#\{\}”中可以写“value”或者其他任意名称。如果接受的是JavaBean，它会通过OGNL读取对象中的属性值。

# 2、关于$\{\}拼接符 #

再来看以下的示例，该示例是MyBatis中的SQL映射配置文件（Mapper配置文件），在该配置中使用了$\{\}拼接符。

<?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="test">
        
        <select id="findUserByUserName" parameterType="java.lang.String" resultType="com.pjb.mybatis.po.User">
            SELECT * FROM tb_user WHERE user_name LIKE '%${value}%'
        </select>
    </mapper>

在SQL映射配置文件中，有时候需要拼接SQL语句。例如在模糊查询的时候，就需要在查询条件的两侧拼接两个“%”字符串，这个时候如果使用“\#\{\}”占位符是不行的。在MyBatis中，“$\{\}”在SQL配置文件中代表一个“拼接符号”，可以在原有SQL语句上拼接新的符合SQL语法的语句。**但是要注意的是，使用“$\{\}”拼接的SQL语句，会引起SQL注入，所以一般不建议使用“$\{\}”。**“$\{\}”接受输入参数的类型可以是简单类型、普通JavaBean或者HashMap。当接受简单类型时，“$\{\}”中只能写“value”，而不能写其他任意名称。如果接受的是JavaBean，它会通过OGNL读取对象中的属性值。

另外，在MyBatis 3.4.2之后，还可以在“$\{\}”拼接符中设置一个默认值，格式如下：

${属性:默认值}

即在所需引入的属性名的后面添加“:”引号，然后紧跟着填写属性不存在或为空时的默认值。

**【示例】**设置“$\{\}”拼接符的默认值。

**（1）创建数据库连接的属性文件（db.properties）**

在src目录下创建db.propertie属性文件，并使用“\#”符号将属性项jdbc.username和jdbc.password注释掉，表示这两个属性项未进行配置。

jdbc.driver=com.mysql.cj.jdbc.Driver
    jdbc.url=jdbc:mysql://localhost:3306/db_admin?useSSL=false&amp
    #jdbc.username=root
    #jdbc.password=123456

**（2）启用拼接符默认值的配置**

**要使用“$\{\}”拼接符中设置一个默认值，需要在properties标签中设置启用拼接符默认值的配置项。**

在MyBatis配置文件（mybatis-config.xml）中，使用<properties>标签加载数据库连接属性文件（db.properties），并在该标签中设置**启用拼接符默认值的配置项**，该配置如下：

<properties resource="db.properties">
        
        <property name="org.apache.ibatis.parsing.PropertyParser.enable-default-value" value="true"/>
    </properties>

**注意：**在MyBatis配置文件（mybatis-config.xml）中，<properties>标签的配置必须写在<settings>标签的上面，因为MyBatis中的配置，不但有类型限制，还有顺序限制。

必须按照：<properties>、<settings>、<typeAliases>、<typeHandlers>、…顺序排放。

**（3）编写数据库配置信息，并使用“$\{\}”拼接符的默认值。**

**![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3Bhbl9qdW5iaWFv_size_16_color_FFFFFF_t_70][]**

**说明：**由于在db.propertie属性文件中，已经将jdbc.username和jdbc.password属性项注释掉了，然后在上面的配置信息中，给username和password配置项中的“$\{\}”拼接符中设置默认值，这样程序在启动时，就会读取默认值。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3Bhbl9qdW5iaWFv_size_16_color_FFFFFF_t_70]: /images/20210724/f4749808b9584b2abf465459b7ebc4b3.png