MyBatis中#{}占位符与${}拼接符的用法说明

时间:2021-05-20

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.Driverjdbc.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)编写数据库配置信息,并使用“${}”拼接符的默认值。

说明:

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

补充:MyBatis映射——SQL占位符及传参

简介

本篇主要讲述Mybatis映射SQL通过#{}获取引入类型参数的属性值及通过@Param注解指定名称传参。

关于占位符与字符拼接:

占位符:占位符就是在某个地方占领一个位置,把它单独作为某个东西,比如这里就是把它作为 值。

#{}表示一个占位符号,通过#{}可以实现 preparedStatement 向占 位符中设置值, 自动进行 java

类型和 jdbc 类型转换。#{}可以有效防止 sql 注入。 #{}可以接 收简单类型值或 pojo 属性值。 如果 parameterType 传输单个简单类型值,#{} 括号中可以是 value 或其它名称。

字符拼接:字符拼接就是简单的对字符串拼接。没有特殊的其它含义。

表 示 拼 接 s q l 串 , 通 过 可 以 将 p a r a m e t e r T y p e 传 入 的 内 容 拼 接 在 s q l 中 且 不 进 行 j d b c 类 型 转 换 , 可 以 将 p a r a m e t e r T y p e 传 入 的 内 容 拼 接 在 s q l 中 且 不 进 行 j d b c 类 型 转 换 , 可 以 接 收 简 单 类 型 值 或 p o j o 属 性 值 , 如 果 p a r a m e t e r T y p e 传 输 单 个 简 单 类 型 值 , {}表示拼接 sql 串,通过可以将parameterType传入的内容拼接在sql中且不进行jdbc类型转换,可以将parameterType传入的内容拼接在sql中且不进行jdbc类型转换,{}可以接收简单类型值或 pojo 属性值,如果 parameterType 传输单个简单类型值,表示拼接sql串,通过可以将parameterType传入的内容拼接在sql中且不进行jdbc类型转换,可以将parameterType传入的内容拼接在sql中且不进行jdbc类型转换,可以接收简单类型值或pojo属性值,如果parameterType传输单个简单类型值,{}括号中只能是 value。

关于@Param:

在用注解来简化xml配置的时候(比如Mybatis的Mapper.xml映射文件中的sql参数引入);

@Param注解的作用是给参数命名,参数命名后就能根据名字得到参数值,正确的将参数传入sql语句中(一般通过#{}的方式,${}会有sql注入的问题)。

#{}: 解析为一个 JDBC 预编译语句(prepared statement)的参数标记符,一个 #{ } 被解析为一个参数占位符 。 ${}: 仅仅为一个纯碎的 string 替换,在动态 SQL 解析阶段将会进行变量替换。

MyBatis 的真正强大在于它的映射语句

Mapper.xml映射文件中定义了操作数据库的sql,每个sql是一个statement,映射文件是mybatis的核心。

映射文件中有很多属性,常用的就是parameterType(输入类型)、resultType(输出类型)、resultMap()、rparameterMap()。

实例步骤

先建好实体类Teacher和接口类

Teacher类

package com.lanou3g.mybaties.bean;import lombok.Getter;import lombok.Setter;@Getter@Setterpublic class Teacher { private Integer id; private String tname; private Integer age; private Integer salary;public Teacher(){} @Override public String toString() { return "Teacher{" + "id=" + id + ", tname='" + tname + '\'' + ", salary=" + salary + ", remark='" + remark + '\'' + ", age=" + age + '}'; } private String remark; public Teacher(Integer id, String tname, Integer age, Integer salary, String remark) { this.id = id; this.tname = tname; this.age = age; this.salary = salary; this.remark = remark; } public Teacher(Integer id) { this.id = id; } }

接口类

package com.lanou3g.mybaties.dao;import com.lanou3g.mybaties.bean.Teacher;import org.apache.ibatis.annotations.Param;import java.util.List;public interface TeacherDao { List<Teacher> queryAll(); Teacher queryById(int id); Teacher queryByIdAndAge(@Param("id") int id, @Param("age") int age); int insertTeacher(Teacher teacher); int insertTeacherByParam(@Param("tname") String tname, @Param("age") int age); int updateTeacherById(Teacher teacher); int deleteTeacherById(int id);}

主要还是xml配置文件的配置,下面是 mybatis_conf.xml文件,它主要引入外部的properties文件(用于配置数据源)、定义类型别名(全局)、配置多套环境的数据库连接参数及引入哪些Mapper映射文件等

mybatis_conf.xml配置文件

<?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" /> <settings> <setting name="mapUnderscoreToCamelCase" value="false"/> </settings> <typeAliases> <!--这样我们就可以在mybatis的的上下文中使用Teacher来代替全路径名了,减少配置的复杂度。 --> <typeAlias type="com.lanou3g.mybaties.bean.Teacher" alias="Teacher" /> <!--default属性,这个属性作用就是指定当前情况下使用哪个数据库配置, 也就是使用哪个<environment>节点的配置, default的值就是配置的<environment>标签元素的id值。--> <environments default="test"> <environment id="test"> <!-- 事务管理器: MANAGED: 这个配置就是告诉mybatis不要干预事务,具体行为依赖于容器本身的事务处理逻辑。 JDBC: 这个配置就是直接使用了 JDBC 的提交和回滚设置,它依赖于从数据源得到的连接来管理事务作用域。 --> <!-- 使用jdbc事务管理 --> <transactionManager type="JDBC"/> <!-- 数据库连接池 --> <dataSource type="POOLED"> <property name="driver" value="${jdbc.driver}"/> <property name="url" value="${jdbc.url}"/> <property name="username" value="${jdbc.user}"/> <property name="password" value="${jdbc.password}"/> </dataSource> </environment> </environments> <!--<mappers>用来在mybatis初始化的时候,告诉mybatis需要引入哪些Mapper映射文件。--> <mappers> <!--通过class属性指定mapper接口名称,此时对应的映射文件必须与接口位于同一路径下, 并且名称相同--> <!--通过resource属性引入classpath路径的相对资源--> <mapper resource="mapper/TeacherMapper.xml" /> </mappers></configuration>

TeacherMapper.xml映射文件

<?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"><!-- namespace对应空Dao接口的全名 --><!--namespace属性在MyBatis中,Mapper中的namespace用于绑定Dao接口的,即面向接口编程。它的好处在于当使用了namespace之后就可以不用写接口实现类,业务逻辑会直接通过这个绑定寻找到相对应的SQL语句进行对应的数据处理--><mapper namespace="com.lanou3g.mybaties.dao.TeacherDao"> <!-- 此处的id是查询语句的名称,对应接口中的方法名 --> <!--指定 resultType 返回值类型时 Teacher 类型的, Teacher 在这里是一个别名,代表的是 com.lanou3g.mybaties.bean.Teacher 对于引用数据类型,都是将大写字母转小写,比如 HashMap 对应的别名是 'hashmap' 基本数据类型考虑到重复的问题,会在其前面加上 '_',比如 byte 对应的别名是 '_byte'--> <select id="queryAll" resultType="Teacher"> <!-- 通过 resultType 指定查询的结果是 Teacher 类型的数据 只需要指定 resultType 的类型,MyBatis 会自动将查询的结果映射成 JavaBean 中的属性 --> select * from teacher; </select> <!-- 带一个简单类型的参数, 这种情况下parameterType属性可以省略, mybatis可以自动推断出类型 --> <select id="queryById" resultType="Teacher"> select * from teacher where id = #{id}; </select> <!-- 带两个参数,需要在接口中通过@Param注解指定名称(因为编译时参数名不会保留) --> <select id="queryByIdAndAge" resultType="Teacher"> select * from teacher where id = #{id} and age &lt;= #{age}; </select> <!-- insert、update、delete的返回值都是int(影响行数) --> <!-- 自定义类型参数,通过#{属性名}可以直接获取引入类型参数的属性值 --> <insert id="insertTeacher" parameterType="Teacher"> insert into teacher(tname) values (#{tname}); </insert> <insert id="insertTeacherByParam"> insert into teacher(tname, age) values (#{tname}, #{age}); </insert> <update id="updateTeacherById" parameterType="Teacher"> update teacher set tname = #{tname}, age = #{age} where id = #{id} </update> <delete id="deleteTeacherById"> delete from teacher where id = #{id}; </delete></mapper>

前面完成后,就要测试了。不过在测试时需要实例化创建对象,因要实现多个方法,在这先建MyBatisTools.java工具类,其主要进行封装Mybatis初始化操作,要求支持创建多env sqlSessionFactory,整个应用生命周期内相同env的sqlSessionFactory对象只有一个(这个类不要过于探究,会用即可)。

MyBatisTools.java

package com.lanou3g.mybaties;import lombok.extern.slf4j.Slf4j;import org.apache.ibatis.io.Resources;import org.apache.ibatis.session.ExecutorType;import org.apache.ibatis.session.SqlSession;import org.apache.ibatis.session.SqlSessionFactory;import org.apache.ibatis.session.SqlSessionFactoryBuilder;import java.io.InputStream;import java.util.concurrent.ConcurrentHashMap;/** * 封装Mybatis初始化操作 * 支持创建多env sqlSessionFactory * 整个应用生命周期内相同env的sqlSessionFactory对象只有一个 */@Slf4jpublic class MyBatisTools { private static ConcurrentHashMap<String, SqlSessionFactory> factoryMap = new MyConcurrentHashMap(); private static MyBatisTools myBatisTools; private MyBatisTools() {} public static MyBatisTools getInstance() { if(myBatisTools == null) { synchronized (MyBatisTools.class) { if(myBatisTools == null) { myBatisTools = new MyBatisTools(); } } } log.debug("当前一共有: " + factoryMap.size() +"个SqlSessionFactory实例"); log.debug("他们分别是: " + factoryMap); return myBatisTools; } public SqlSessionFactory getSessionFactory(String env) { try { // 1. 读入配置文件 InputStream in = Resources.getResourceAsStream("mybatis_conf.xml"); // 2. 构建SqlSessionFactory(用于获取sqlSession) SqlSessionFactory sessionFactory = null; synchronized (factoryMap) { if(factoryMap.containsKey(env)) { return factoryMap.get(env); } else { sessionFactory = new SqlSessionFactoryBuilder().build(in, env); factoryMap.put(env, sessionFactory); } } return sessionFactory; } catch (Exception e) { log.error("初始化SqlSessionFactory失败", e); return null; } } public SqlSession openSession() { return getSessionFactory(null).openSession(); } public SqlSession openSession(boolean autoCommit) { return getSessionFactory(null).openSession(autoCommit); } public SqlSession openSession(ExecutorType executorType, boolean autoCommit) { return getSessionFactory(null).openSession(executorType, autoCommit); }}/** * 继承原生ConcurrentHashMap,处理null key问题 */class MyConcurrentHashMap extends ConcurrentHashMap { @Override public Object put(Object key, Object value) { if(key == null) { key = "null"; } return super.put(key, value); } @Override public boolean containsKey(Object key) { if(key == null) { key = "null"; } return super.containsKey(key); } @Override public Object get(Object key) { if(key == null) { key = "null"; } return super.get(key); }}

最后就是测试,在AppTest类测试

AppTest

@Slf4jpublic class AppTest { /** * Rigorous Test :-) */ TeacherDao teacherDao = null; @Before public void setUp() { teacherDao = MyBatisTools.getInstance().openSession(true).getMapper(TeacherDao.class); } /** * 练习查询多个库(用到了多环境配置) */ @Test public void textqueryById(){ Teacher teacher=teacherDao.queryById(1); System.out.println(teacher); } @Test public void text(){ List<Teacher> teachers=teacherDao.queryAll(); System.out.println(teachers); } /** * 多个参数查询语句 */ @Test public void testQueryByIdAndAge() { Teacher teacherList = teacherDao.queryByIdAndAge(1, 65); log.info("查询结果:" + teacherList); } @Test public void testInsert() { // 新增Teacher表 System.out.println("--------------插入前:"); List<Teacher> teacherList = teacherDao.queryAll(); System.out.println(teacherList); int ret = teacherDao.insertTeacher(new Teacher("好人")); log.info("影响的行数: " + ret); // 比较low的写法(不推荐) //int ret = teacherDao.insertTeacherByParam("哈哈哥", 99); //log.info("影响的行数: " + ret); System.out.println("--------------插入后:"); teacherList = teacherDao.queryAll(); System.out.println(teacherList); } @Test public void testUpdate() { Teacher teacher = new Teacher(); teacher.setId(6); teacher.setAge(99); teacher.setTname("乔巴老师"); int rows = teacherDao.updateTeacherById(teacher); log.info("更新行数:" + rows); } @Test public void testDelete() { int rows = teacherDao.deleteTeacherById(13); log.info("删除行数:" + rows); } @Test public void testinsertTeacherByParam(){int row=teacherDao.insertTeacherByParam("hh",22); System.out.println(row); }}

以上为个人经验,希望能给大家一个参考,也希望大家多多支持。如有错误或未考虑完全的地方,望不吝赐教。

声明:本页内容来源网络,仅供用户参考;我单位不保证亦不表示资料全面及准确无误,也不保证亦不表示这些资料为最新信息,如因任何原因,本网内容或者用户因倚赖本网内容造成任何损失或损害,我单位将不会负任何法律责任。如涉及版权问题,请提交至online#300.cn邮箱联系删除。

相关文章