Mybatis框架学习笔记

学习完了雷丰阳老师视频教程的Mybatis，记录一下。
有些自己的体会，在对不同资源进行整合的时候对于普通java工程项目需要自行添加对应jar包文件到路径下，然后build path，如果是maven工程只需要写依赖就会自动导入。
MyBatis提供了非常丰富的对Sql进行自定义和调整的标签及其属性，很多东西我们只需要在xml文件中定义或者添加注解，MyBatis就会自动完成其他工作，框架开发应该也是这样的发展历程，需要手写的代码会越来越少。

mybatis基础

即ibatis3.0（源于Apache）之后的版本

三层架构：
表现层—展示数据
业务层—处理业务需求
持久层—和数据库交互

-持久层技术解决方案
JDBC技术（最底层）：
Connection、PreparedStatement、ResultSet
Spring的JdbcTemplate：
Spring中对jdbc的简单封装
Apache的DBUtils：
和Spring的JdbcTemplate类似
以上都不是框架，jdbc是规范，剩下两个是工具包
-封装不够细致，需要关注加载驱动、创建连接、创建Statement等繁杂过程。
-功能简单，sql语句编写在java代码里，硬编码高耦合（sql变化时需要修改源码）

框架：整体解决方案

Hibernate：全自动全映射ORM框架，旨在消除sql。但是存在开发人员无法自主优化sql语句的缺点。

mybatis是优秀的基于java持久层的框架（半自动），它内部封装了jdbc，sql与java编码分离（sql单独提取到配置文件中，由开发者控制），开发者只需要关注sql语句本身（剩下的预编译、设置参数、执行sql、封装结果由框架完成）。它使用了ORM的思想实现了结果集的封装。

ORM：Object Relational Mapping 对象关系映射
将数据库表和实体类、实体类的属性对应起来，让我们可以实现操作实体类即操作数据表

​ mybatis通过xml或注解的方式将要执行的statement（sql语句）配置起来，通过java对象 和statement中sql的动态参数进行映射生成最终执行的sql语句，最后由mybatis框架执行 语句并将结果映射为java对象返回。

mybatis实现总结

1.全局配置文件mybatis-config.xml
包含数据源、事务管理器、运行环境的信息
2.sql映射文件EmployeeMapper.xml -->关键文件，mybatis从该文件抽取出sql
配置每个sql，以及sql的封装规则（查出相应记录后如何封装）
3.将sql映射文件注册在全局配置文件中
4.写代码（MybatisTest.java）
关键：
1）根据配置文件获得SqlSessionFactory
2）使用SqlSessionFactory获取到SqlSession对象，使用该SqlSession对象中的方法进行增删查改
一个SqlSession就是和数据库的一次会话，使用完要关闭
使用sql的唯一标识（如selectOne方法的第一个参数）来告诉mybatis执行哪个sql

接口式编程（方便开发扩展）实现总结

1.创建一个接口(EmployeeMapper.java),其中定义抽象方法
2.将EmployeeMapper.xml中的namespace改为接口的全类名
3.将标签中的"id"改为与接口中定义的抽象方法相同的方法名
4.第2、3步实现了动态绑定，在标签中写方法的具体实现
5.在测试方法中不需要创建接口的实现类，mybatis会为接口自动创建一个代理对象去执行增删改查方法

在mybatis-config.xml和EmployeeMapper.xml文件的头部标签中xxx.dtd文件是约束，规定了xml文件编写规则，联网状态下会
自动加载，按Alt+/会有编写提示

遇到的问题

1.jUnit测试始终无法找到EmployeeMapper.xml映射文件
解决：config文件夹右键->Build Path->Use as Source Folder

2.测试运行MybatisTest的test方法时报错Client does not support authentication protocol
解决：更换mysql-connector-java-xxx.jar文件的版本

全局配置文件Config.xml

将数据库的连接信息提取到dbconfig.properties文件中，放在类路径config文件夹下
然后将全局配置文件中的

<property name="driver" value="com.mysql.jdbc.Driver" />
				<property name="url"
					value="jdbc:mysql://localhost:3306/mybatis" />
				<property name="username" value="root" />
				<property name="password" value="123456" />

修改为

<property name="driver" value="${jdbc.driver}" />
				<property name="url"
					value="${jdbc.url}" />
				<property name="username" value="${jdbc.username}" />
				<property name="password" value="${jdbc.password}" />

运行测试方法，一样成功。
项目庞大时更方便维护管理配置信息。
作为了解学习，使用spring整合后spring会帮我们完成配置。

properties设置

mybatis可以使用properties标签来引入外部properties配置文件的内容。

settings设置

极为重要的调整设置，它们会改变Mybatis运行时行为。

typeAliases设置

别名处理器，可自定义java类型别名。
包含单个处理和批量处理。
批量处理可能会出现别名冲突问题（包下的类和包下的包中的类名字相同），可以使用注解@Alias("")为某个类型指定新的别名。
不使用别名，使用类型的全类名，查找类时更方便。
typeHandles：类型处理器，架起java类型和数据库类型映射的桥梁。（互相转换，String<–>CHAR/VARCHAR）

plugins设置

插件，拦截对象方法。Executor、ParameterHandler、ResultSetHandler、StatementHandler。

environments设置

environments：环境，mybatis可以配置多种环境，开发时可以定义标签的default不同值快速切换环境。

databaseIdProvider设置

用来支持多数据库厂商，在全局配置文件中添加后为各数据库起别名，在mapper.xml中标签中添加databaseId属性，即可指定该sql语句适用的数据库。
然后修改的default值可以切换运行环境

mappers设置

mappers：将写好的sql映射文件（EmployeeMapper.xml）注册到全局配置文件中

标签编写顺序

在全局配置文件中的标签有严格顺序要求：
Content Model : (properties?, settings?, typeAliases?, typeHandlers?, objectFactory?,
objectWrapperFactory?, reflectorFactory?, plugins?, environments?, databaseIdProvider?, mappers?)

映射文件Mapper.xml

映射文件是mybatis的重中之重。
The true power of MyBatis is in the Mapped Statements. This is where the magic happens.

Mybatis支持增删改返回Integer、Long、Boolean类型返回值，在接口中直接在方法上中定义即可，Mybatis会自动封装

Mybatis参数处理

单个参数

​ mybatis不会做特殊处理，只有一个参数，即使参数名与bean中属性不一致，运行效果也一样。
​ #{参数名}：取出参数值。
​

多个参数

​ mybatis会做特殊处理，返回的多个参数会被封装成一个map。key是param1…paramN/参数的索引（0，1…）
​ value才是传入的参数值
​ #{}就是从map中获取指定key的值
​ 取值：#{param1}，#{param2}
​ 多个参数建议使用命名参数，即在封装参数为map时明确指定map的key。
​ public Employee getEmpByIdAndLastName(@Param(“id”)Integer id, @Param(“lastName”)String lastName);
​ 此时#{指定的key}即可取出对应的参数值
​

POJO

（简单java对象，简单JavaBean）
如果多个参数正好是业务逻辑的数据模型（传入的参数是Employee的属性值），我们可以直接传入pojo；
#{属性名}：取出传入的pojo的属性值

Map

​ 如果不是业务逻辑的数据模型，没有对应的pojo，不经常使用，为了方便也可以直接传入map
​ #{key}：取出map中对应的值
​

TO

（DTO，可以理解为写一个新的、继承原来model层实体类、添加新的业务处理方法、专注于数据传输的类）
如果不是业务逻辑的数据模型，但是该方法要经常使用，推荐来编写一个TO（Transfer Object）即数据传输对象
Page{
int index;
int size;
}

表现层与应用层之间是通过数据传输对象（DTO）进行交互的，数据传输对象是没有行为的POCO对象，它 的目的只是为了对领域对象进行数据封装，实现层与层之间的数据传递。为何不能直接将领域对象用于 数据传递？因为领域对象更注重领域，而DTO更注重数据。不仅如此，由于“富领域模型”的特点，这样 做会直接将领域对象的行为暴露给表现层。

需要了解的是，数据传输对象DTO本身并不是业务对象。数据传输对象是根据UI的需求进行设计的，而不 是根据领域对象进行设计的。比如，Customer领域对象可能会包含一些诸如FirstName, LastName, Email, Address等信息。但如果UI上不打算显示Address的信息，那么CustomerDTO中也无需包含这个 Address的数据。

参数处理扩展思考

一些应用场景

public Employee getEmp(@Param("id")Integer id, String lastName);

​ 取值：id==>#{id/param1} lastName==>#{param2}

public Employee getEmp(Integer id, @Param("e")Employee emp);

​ 取值：id==>#{param1} lastName==>#{param2.lastName/e.lastName}

特别注意

如果传入的是Collection（List、Set）类型或者是数组，也会特殊处理。

​ 也是把传入的list或者数组封装在map中；

​ key：Collection=>collection，List=>list，Array=>array

public Employee getEmpById(List<Integer> ids);

​ 取值：取出第一个id的值==>#{list[0]}

参数值的获取

#{}：可以获取map中的值或者pojo对象属性的值

${}：也可以获取map中的值或者pojo对象属性的值

#{}和${}的区别

select id, last_name lastName, email, gender from tbl_employee
运行后：
Preparing: select id, last_name lastName, email, gender from tbl_employee where id = 5 and last_name = ?

where id = ${id} and last_name = #{lastName}

​ #{}是以预编译形式将参数设置到sql语句中；PreparedStatement：防止sql注入

​ ${}是将取出的值直接封装在sql语句中；会有安全问题

​ 大多情况下使用#{}获取参数的值

​ 原生jdbc不支持占位符的地方就可以使用${}进行取值（即sql语句不支持？的地方）

​ 如：select * from ${year}_salary where xxx;

​ select * from tbl_employee order by ${f_name} ${order}

#{}更丰富的用法：

​ 取值的时候可以规定参数的一些规则

​ javaType、jdbcType、mode（存储过程）、numbericScale、resultMap、typeHandler、jdbcTypeName、expression（未来准备支持的功能）

​ jdbcType在某种特定场景下需要被设置，在有的数据为null的时候，有的数据库无法识别mybatis对null的默认处理。比如Oracle会报错，因为mybatis对所有的null都映射的是原生jdbc的OTHER类型，Oracle不兼容该类型。

​ 由于全局配置中，jdbcTypeForNull=OTHER，Oracle不支持。两种解决办法：

​ 1.修改为#{email, jdbcType=NULL}，表示为空时设置为NULL类型，运行成功。

​ 2.修改全局配置中jdbcTypeForNull=NULL。

总结

参数多时会封装map，为了不混乱可以使用注解@Param(“xxx”)来指定封装时哪个属性是key

#{xxx}就可以取出map中指定的值

查询相关

1.查询返回List集合

public List<Employee> getEmpsByLastNameLike(String lastName);

resultType：如果返回的是一个集合，要写集合中元素的类型

 <select id="getEmpsByLastNameLike" resultType="com.bean.Employee">
 	select * from tbl_employee where last_name like #{
   lastName}
 </select>

2.查询返回Map集合

返回一条记录的Map

key就是列名，value就是对应的值

public Map<String, Object> getEmpByIdReturnMap(Integer id);

<select id="getEmpByIdReturnMap" resultType="map">
 	select * from tbl_employee where id = #{
   id}
 </select>

返回多条记录的Map

返回多条记录封装成一个map，key是这条记录的主键，value是记录封装后的JavaBean

@MapKey("id")//用注解告诉mybatis封装这个map的时候用哪个属性值作为主键
public Map<Integer, Employee> getEmpByLastNameLikeReturnMap(String lastName);

 <select id="getEmpByLastNameLikeReturnMap" resultType="com.bean.Employee">
 	select * from tbl_employee where last_name like #{
   lastName}
 </select>

3.resultMap自定义javaBean的封装规则

Mapper.xml文件中的select标签中resultType和resultMap只能二选一

<!-- 自定义某个javaBean的封装规则 
 		type：自定义规则的java类型
 		id：唯一id方便引用
 	-->
 	<resultMap type="com.bean.Employee" id="MyEmp">
 		<!-- 指定主键列的封装规则 
 			用id定义主键会有底层优化，也可以使用result
 			column：指定哪一列
 			property：指定对应的javaBean属性
 		-->
 		<id column="id" property="id"/>
 		<!--