MyBatis 是一款优秀的持久层框架,一个半 ORM(对象关系映射)框架,它支持定制化 SQL、存储过程以及高级映射,MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及 获取结果集,MyBatis 可以使用简单的 XML 或注解来配置和映射原生类型、接口和 Java 的 POJO(Plain Old Java Objects,普通老式 Java 对象)为数据库中的记录
ORM(Object Relational Mapping),对象关系映射,是一种为了解决关系型数据库数 据与简单Java对象(POJO)的映射关系的技术,简单的说,ORM 是通过使用描述对象和 数据库之间映射的元数据,将程序中的对象自动持久化到关系型数据库中
Hibernate 属于全自动 ORM 映射工具,使用 Hibernate 查询关联对象或者关联集合对象时, 可以根据对象关系模型直接获取,所以它是全自动的
而Mybatis在查询关联对象或关联集合对象时,需要手动编写sql来完成,所以,称之为半自动ORM映射工具
MyBatis专注于SQL本身,是一个足够灵活的DAO层解决方案。
对性能的要求很高,或者需求变化较多的项目,如互联网项目,MyBatis将是不错的选择
读取 MyBatis 配置文件:mybatis-config.xml 为 MyBatis 的全局配置文件,配置了 MyBatis 的运行环境等信息,例如数据库连接信息
加载映射文件,映射文件即 SQL 映射文件,该文件中配置了操作数据库的 SQL 语句, 需要在 MyBatis 配置文件 mybatis-config.xml 中加载,mybatis-config.xml 文件可以加 载多个映射文件,每个文件对应数据库中的一张表
构造会话工厂:通过 MyBatis 的环境等配置信息构建会话工厂 SqlSessionFactory
创建会话对象:由会话工厂创建 SqlSession 对象,该对象中包含了执行 SQL 语句的所有方法
Executor 执行器:MyBatis 底层定义了一个 Executor 接口来操作数据库,它将根据 SqlSession 传递的参数动态地生成需要执行的 SQL语句,同时负责查询缓存的维护
MappedStatement 对象:在 Executor 接口的执行方法中有一个 MappedStatement 类型的参数,该参数是对映射信息的封装,用于存储要映射的 SQL 语句的 id、参数等信息
输入参数映射:输入参数类型可以是 Map、List 等集合类型,也可以是基本数据类型和 POJO 类型,输入参数映射过程类似于 JDBC 对preparedStatement 对象设置参数的过程
输出结果映射:输出结果类型可以是 Map、 List 等集合类型,也可以是基本数据类型 和 POJO 类型,输出结果映射过程类似于 JDBC 对结果集的解析过程
我们把 Mybatis 的功能架构分为三层:
API接口层:提供给外部使用的接口API,开发人员通过这些本地API来操纵数据库,接口层一接收到调用请求就会调用数据处理层来完成具体的数据处理
数据处理层:负责具体的 SQL 查找、SQL解析、SQL执行和执行结果映射处理等,它主要的目的是根据调用的请求完成一次数据库操作
基础支撑层:负责最基础的功能支撑,包括连接管理、事务管理、配置加载和缓存处理,这些都是共用的东西,将他们抽取出来作为最基础的组件为上层的数据处理层提供最基础的支撑
加载配置:配置来源于两个地方,一处是配置文件,一处是Java代码的注解,将SQL的 配置信息加载成为一个个MappedStatement对象,包括了传入参数映射配置、执行的SQL 语句、结果映射配置,存储在内存中。
SQL解析:当API接口层接收到调用请求时,会接收到传入 SQL 的 ID 和传入对象,可以是 Map、JavaBean 或者基本数据类型,Mybatis会根据 SQL 的 ID 找到对应的 MappedStatement,然后根据传入参数对象对MappedStatement进行解析,解析后可以得到最终要执行的SQL语句和参数
SQ L执行:将最终得到的SQL和参数拿到数据库进行执行,得到操作数据库的结果
结果映射:将操作数据库的结果按照映射的配置进行转换,可以转换成 HashMap、 JavaBean 或者基本数据类型,并将最终结果返回
SQL 预编译指的是数据库驱动在发送 SQL 语句和参数给 DBMS 之前对 SQL 语句进行编译,这样 DBMS 执行 SQL 时,就不需要重新编译
JDBC 中使用对象 PreparedStatement 来抽象预编译语句,预编译阶段可以优化 SQL 的执行
预编译之后的 SQL 多数情况下可以直接执行,DBMS 不需要再次编译,越复杂的SQL,编译的复杂度将越大,预编译阶段可以合并多次操作为一个操作
同时预编译语句对象可以重复利用,把一个 SQL 预编译后产生的 PreparedStatement 对象缓存下来,下次对于同一个SQL,可以直接使用这个缓存的 PreparedState 对象
Mybatis 默认情况下,将对所有的 SQL 进行预编译
Mybatis 有三种基本的 Executor 执行器,SimpleExecutor、ReuseExecutor、 BatchExecutor
ReuseExecutor:执行 update 或 select,以 sql 作为 key 查找 Statement 对象,存在就使用,不存在就创建,用完后,不关闭Statement对象,而是放置于 Map<String, Statement> 内,供下一次使用,简言之,就是重复使用Statement对象
BatchExecutor:执行 update,没有select,JDBC批处理不支持select,将所有 sql 都添加到批处理中,等待统一执行,它缓存了多个 Statement对象,每个Statement对象都是 addBatch 完毕后,等待逐一执行 executeBatch 批处理,与JDBC批处理相同
作用范围:Executor的这些特点,都严格限制在SqlSession生命周期范围内
在 Mybatis 配置文件中,可以指定默认的 ExecutorType 执行器类型,也可以手动给 DefaultSqlSessionFactory 的创建 SqlSession 的方法传递 ExecutorType 类型参数
配置默认的执行器,SIMPLE 就是普通的执行器,REUSE 执行器会重用预处理语句,BATCH 执行器将重用语句并执行批量更新
Mybatis 仅支持 association 关联对象和 collection 关联集合对象的延迟加载,association 指的就是一对一,collection 指的就是一对多查询,在Mybatis配置文件中,可以配置是否启用延迟加载 lazyLoadingEnabled=true|false
它的原理是,使用 CGLIB 创建目标对象的代理对象,当调用目标方法时,进入拦截器方法, 比如调用a.getB().getName(),拦截器invoke()方法发现 a.getB() 是 null 值,那么就会单独发送事先保存好的查询关联B对象的 sql,把 B 查询上来,然后调用a.setB(b),于是a的对象 b 属性就有值了,接着完成 a.getB().getName() 方法的调用,这就是延迟加载的基本原理
当然了,不光是Mybatis,几乎所有的包括Hibernate,支持延迟加载的原理都是一样的
#{}是占位符,预编译处理,${}是拼接符,字符串替换,没有预编译处理
Mybatis在处理 #{} 时,#{} 传入参数是以字符串传入,会将SQL中的 #{} 替换为 ? 号,调用 PreparedStatement 的 set 方法来赋值
变量替换后,#{} 对应的变量自动加上单引号,而 ${} 对应的变量不会加上单引号
#{} 可以有效的防止 SQL 注入,提高系统安全性,而${} 不能防止SQL 注入
#{} 的变量替换是在 DBMS 中,${} 的变量替换是在 DBMS 外
使用CONCAT()函数:CONCAT(’%’,#{question},’%’)
顺序传参法
public User selectUser(String name, int deptId);
<select id="selectUser" resultMap="UserResultMap">
select * from user
where user_name = #{0} and dept_id = #{1}
</select>
#{} 里面的数字代表传入参数的顺序
这种方法不建议使用,sql 层表达不直观,且一旦顺序调整容易出错
@Param注解传参法
public User selectUser(@Param("userName") String name, int @Param("deptId") deptId);
<select id="selectUser" resultMap="UserResultMap">
select * from user
where user_name = #{userName} and dept_id = #{deptId}
</select>
#{} 里面的名称对应的是注解@Param括号里面修饰的名称
这种方法在参数不多的情况还是比较直观的,推荐使用
Map 传参法
public User selectUser(Map<String, Object> params);
<select id="selectUser" parameterType="java.util.Map" resultMap="UserResultMap">
select * from user
where user_name = #{userName} and dept_id = #{deptId}
</select>
#{} 里面的名称对应的是 Map 里面的 key 名称
这种方法适合传递多个参数,且参数易变能灵活传递的情况
Java Bean传参法
public User selectUser(User user);
<select id="selectUser" parameterType="com.jourwon.pojo.User"resultMap="UserResultMap">
select * from user
where user_name = #{userName} and dept_id = #{deptId}
</select>
#{} 里面的名称对应的是 User 类里面的成员属性
这种方法直观,需要建一个实体类,扩展不容易,需要加属性,但代码可读性强,业务逻辑处理方便,推荐使用
使用 foreach标签,foreach 的主要用在构建 in 条件中,它可以在SQL语句中进行迭代一个集合,foreach标签的属性主要有item,index,collection,open,separator,close
item:表示集合中每一个元素进行迭代时的别名,随便起的变量名
index:指定一个名字,用于表示在迭代过程中,每次迭代到的位置,不常用
open:表示该语句以什么开始
separator:表示在每次进行迭代之间以什么符号作为分隔符
close:表示以什么结束
在使用 foreach 的时候最关键的也是最容易出错的就是 collection 属性,该属性是必须指定的,但是在不同情况下,该属性的值是不一样的,主要有一下3种情况:
如果传入的是单参数且参数类型是一个 List 的时候,collection 属性值为 list
如果传入的是单参数且参数类型是一个array数组的时候,collection 的属性值为 array
如果传入的参数是多个的时候,我们就需要把它们封装成一个Map了,当然单参数也可以封装成map,实际上如果你在传入参数的时候,在MyBatis里面也是会把它封装成一个 Map的,map的key就是参数名,所以这个时候 collection 属性值就是传入的 List 或 array 对象在自己封装的 map 里面的 key
具体用法如下:
<!‐‐ 批量保存(foreach插入多条数据两种方法)
int addEmpsBatch(@Param("emps") List<Employee> emps); ‐‐>
<!‐‐ MySQL下批量保存,可以foreach遍历 mysql支持values(),(),()语法
<insert id="addEmpsBatch">
INSERT INTO emp(ename,gender,email,did)
VALUES
<foreach collection="emps" item="emp" separator=",">
(#{emp.eName},#{emp.gender},#{emp.email},#{emp.dept.id})
</foreach>
</insert>
<!‐‐ 这种方式需要数据库连接属性allowMutiQueries=true的支持如jdbc.url=jdbc:mysql://localhost:3306/mybatis?allowMultiQueries=true ‐‐
>
<insert id="addEmpsBatch">
<foreach collection="emps" item="emp" separator=";">
INSERT INTO emp(ename,gender,email,did)
VALUES(#{emp.eName},#{emp.gender},#{emp.email},#{emp.dept.id})
</foreach>
</insert>
使用ExecutorType.BATCH
Mybatis内置的 ExecutorType 有3种,默认为 simple,该模式下它为每个语句的执行创建一个新的预处理语句,单条提交sql,而 batch模式重复使用已经预处理的语句,并且批量执行所有更新语句,显然batch性能将更优,但 batch 模式也有自己的问题,比如在 Insert 操作时,在事务没有提交之前,是没有办法获取到自增的id,这在某型情形下是不符合业务要求的
对于支持主键自增的数据库(MySQL)
<insert id="insertUser" useGeneratedKeys="true" keyProperty="userId" >
insert into user(
user_name, user_password, create_time)
values(#{userName}, #{userPassword} , #{createTime, jdbcType=TIMESTAMP})
</insert>
parameterType 可以不写,Mybatis可以推断出传入的数据类型,如果想要访问主键,那么 parameterType 应当是 java 实体或者Map,这样数据在插入之后可以通过 Java 实体或者 Map 来获取主键值,通过 getUserId获取主键
不支持主键自增的数据库(Oracle)
对于像Oracle这样的数据,没有提供主键自增的功能,而是使用序列的方式获取自增主键
可以使用<selectKey>标签来获取主键的值,这种方式不仅适用于不提供主键自增功能的 数据库,也适用于提供主键自增功能的数据库
<selectKey>一般的用法
<insert id="insert">
<selectKey resultType="java.lang.Long" keyProperty="id" order="AFTER">
SELECT
LAST_INSERT_ID()
</selectKey>
<!‐‐ 这里写插入的语句-->
</insert>
接口绑定,就是在 MyBatis 中任意定义接口,然后把接口里面的方法和 SQL 语句绑定,我们直接调用接口方法就可以,这样比起原来SqlSession 提供的方法我们可以有更加灵活的选择和设置
接口绑定有两种实现方式
通过注解绑定,就是在接口的方法上面加上 @Select、@Update 等注解,里面包含Sql 语句来绑定
通过xml里面写 SQL 来绑定, 在这种情况下,要指定xml映射文件里面的 namespace 必须为接口的全路径名,当Sql语句比较简单时候,用注解绑定, 当SQL语句比较复杂时候,用 xml绑定,一般用xml绑定的比较多
Mapper 接口方法名和 mapper.xml 中定义的每个 sql 的 id 相同
Mapper 接口方法的输入参数类型和 mapper.xml 中定义的每个 sql 的 parameterType 的类型相同
Mapper 接口方法的输出参数类型和 mapper.xml 中定义的每个 sql 的 resultType 的类型相同
Mapper.xml文件中的 namespace 即是 mapper 接口的类路径
Dao接口,就是人们常说的 Mapper 接口,接口的全限名,就是映射文件中的 namespace 的值,接口的方法名,就是映射文件中MappedStatement 的 id 值,接口方法内的参数,就是传递给sql的参数
Mapper接口是没有实现类的,当调用接口方法时,接口全限名 + 方法名拼接字符串作为key值,可唯一定位一个MappedStatement,举例: com.mybatis3.mappers.StudentDao.findStudentById,可以唯一找到 namespace 为 com.mybatis3.mappers.StudentDao下面 id = findStudentById 的 MappedStatement
在Mybatis中,每一个<select>、<insert>、<update>、<delete>标签,都会被解析为 一个 MappedStatement 对象
Dao 接口里的方法,是不能重载的,因为是全限名 + 方法名的保存和寻找策略
Dao 接口的工作原理是 JDK 动态代理,Mybatis 运行时会使用 JDK 动态代理为 Dao 接口生成代理 proxy 对象,代理对象 proxy 会拦截接口方法,转而执行 MappedStatement 所代表的 sql,然后将 sql 执行结果返回
不同的 Xml 映射文件,如果配置了namespace,那么 id 可以重复,如果没有配置 namespace,那么id不能重复
原因就是 namespace + id 是作为 Map<String, MappedStatement> 的 key 使用的,如果没有 namespace,就剩下 id,那么,id 重复会导致数据互相覆盖,有了namespace,自然id 就可以重复,namespace 不同,namespace + id自然也就不同
<parameterMap> 标签会被解析为 ParameterMap 对象,其每个子元素 会被解析为ParameterMapping对象<resultMap> 标签会被解析为 ResultMap 对象,其每个子元素会被解析为 ResultMapping 对象<select>、<insert>、<update>、 <delete>标签均会被解析为 MappedStatement 对象,标签内的 sql 会被解析为 BoundSql 对象第一种是使用 <resultMap> 标签,逐一定义列名和对象属性名之间的映射关系
第二种是使用 sql 列的别名功能,将列别名书写为对象属性名,比如 T_NAME AS NAME, 对象属性名一般是 name,小写,但是列名不区分大小写,Mybatis 会忽略列名大小写,智能找到与之对应对象属性名,你甚至可以写成 T_NAME AS NaMe,Mybatis 一样可以正常 工作
有了列名与属性名的映射关系后,Mybatis通过反射创建对象,同时使用反射给对象的属性 逐一赋值并返回,那些找不到映射关系的属性,是无法完成赋值的
有联合查询和嵌套查询,联合查询是几个表联合查询,只查询一次,通过在 resultMap 里面的 association,collection 节点配置一对一,一对多的类就可以完成
嵌套查询是先查一个表,根据这个表里面的结果的外键id,去再另外一个表里面查询数据, 也是通过配置 association,collection,但另外一个表的查询通过 select 节点配置
Mybatis 可以映射枚举类,不单可以映射枚举类,Mybatis可以映射任何对象到表的一列上,映射方式为自定义一个TypeHandler,实现TypeHandler 的 setParameter() 和 getResult() 接口方法
TypeHandler 有两个作用,一是完成从 javaType 至jdbcType 的转换,二是完成 jdbcType 至 javaType 的转换,体现为 setParameter()和 getResult() 两个方法,分别代表设置 sql 问号占位符参数和获取列查询结果
<cache/>