Mybatis的基本概念

Mybatis VS Hibernate

• Mybatis是开发的起点是SQL，需要写SQL（或者通过代码生成工具生成），把SQL查询结果转成Object。
• Hibernate开发的起点是实体（对象），由对象和表的对应关系，自动生成SQL。
• 较之Hibernate，Mybatis更接近原生的SQL开发，更容易理解。
• 开始入手的工作量大一点，需要写java和sql，但后期维护理解的成本比较低，借助Mybatis和IDEA的开发插件，手写代码量也减少很多。
• 能灵活扩展复杂的SQL，比较适合复杂业务场景的开发

Mybatis的开发流程

主要的开发Mybatis的开发流程

第一步：建表

第二步：基于表用mybatis的代码生成工具，生成代码。

• 方法一：用IDE插件来生成代码。例如在Idea中利用插件MyBatisCodeHelper（收费）来生成代码，在IDEA中配置好Database，在Datasource页面上利用插件生成。

• 方法二：用mybatis的maven插件mybatis-generator

第三步：扩展开发

当需要做扩展开发的时候，比如生成新的复杂的统计语句。为了不和自动生成的代码冲突，把自定义的内容写到另外的XML和JAVA代码中。例如goods表的自定义SQL写到。GoodMapperExt.xml ,而Java类写到GoodMapperExt.java，这样自动生成的代码可以重复生成而对自定义的内容没有影。

Mybatis的核心内容

1. Mapper文件

通常由表名+Mapper来命名。主要内容有SQL、动态OGNL、ResultMap。

2. sql语句的种类。

• insert – 映射插入语句。
• update – 映射更新语句。
• delete – 映射删除语句。
• select – 映射查询语句。
• sql – 可被其它语句引用的可重用语句块。比如不同的select语句的where部分可以提炼出来给count和select共用。

3. 编写mapper
   编写mapper文件需要留意
1. namespace中需要与使用@Mapper的接口对应
2. UserMapper.xml文件名称必须与使用@Mapper的接口一致
3. 标签中的id必须与@Mapper的接口中的方法名一致，且参数一致

4. SQL片段的复用
   SQL存在着复用的情况，例如，例如list和count的条件语句都一样，不同select的语句返回的字段都一样。

5. 动态SQL

根据参数的状态定义灵活的条件语句，例如字段内容不为空的时候作为where条件的一部分。

• if

<if test="条件表达式">{sql片段} </if>

test内的表达式为true{sql片段}的内容生效

• choose

<choose> 
  <when test="条件表达式"> 
    {sql片段}
  </when> 
  <otherwise>
    {sql片段}
	</otherwise>
</choose>

test内的表达式为true {sql片段}的内容生效

• foreach

<foreach item="item" index="index" collection="list" >...</foreach>

集合进行遍历（尤其是在构建 IN 条件语句的时候）。从下图里面理解一下foreach

再举个例子

<select id="selectPostIn"resultType="domain.blog.Post"> 
  SELECT * FROM POST P WHERE ID in
    <foreach item="item"
      index="index"
      collection="list" 
      open="(" separator="," close=")">     
        #{item}  
         foreach>
</select>

• where

<where>{动态SQL} </where> 用来解决动态SQL过程中where 后的查询条件都没有的情况下不能输出where 和首个条件不能and的问题。通常都用where 1=1 来解决，在mybatis里面通过where就简单很多。

• set

<set>{动态SQL} </set>

• trim

<trim>{动态SQL} </trim>用来对动态的SQL进行处理保证前缀有where 前缀有AND 或者 OR 去覆盖掉，效果类似 <where/>

保证前缀有set ，后缀去掉，效果类似 <SET/>

• OGNL动态表达式

<if test="动态表达式"> {动态语句}</if>

用到了表达式，mybatis里面用的是OGNL表达式。完整的参考资料 https://commons.apache.org/proper/commons-ognl/language-guide.html

常用表达式有

1. e1 or e2
2. e1 and e2
3. e1 == e2,
4. e1 eq e2
5. e1 != e2
6. e1 neq e2
7. e1 lt e2 :小于
8. e1 lte e2：小于等于，其他gt（大于）,gte（大于等于）
9. e1 in e2
10. e1 not in e2
11. e1 + e2,e1 * e2,e1/e2,e1- e2,e1%e2
12. !e,not e：非，求反
13. e.method(args)调用对象方法
14. e.property对象属性值e1[ e2 ]按索引取值，List,数组和Map
15. @class@method(args)调用类的静态方法
16. @class@field调用类的静态字段值

6. 查询结果转换

实现从jdbc的resultset转换到POJO的过程,有两种方式resultType和resultMap

• resultType=“java类名称” 就是select语句返回对象的类型，mybatis会搞定对象的转换。
• <resultMap/>如果列名和java对象的属性不匹配java的映射规范，就可以通过resultmap来定制转换逻辑。

默认情况下在resultmap中没被定义的字段默认也会自动进行转换。mybatis定义了3种转换模式。

- NONE - 禁用自动映射。仅对手动映射的属性进行映射。

- PARTIAL - 对除在内部定义了嵌套结果映射（也就是连接的属性）以外的属性进行映射

- FULL - 自动映射所有属性

在mybatis中可以自己定义映射模式，配置的方式是在mybatis的config文件中

<settings>    
  <settingname="autoMappingBehavior"value="PARTIAL"/>
 </settings>

7. 其他

• “关联的嵌套 Select 查询”很少用，避免N+1问题

Mybatis和SpringBoot的整合

• 增加依赖

<dependency>    
  <groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter
</artifactId>    
<version>2.1.3</version>
</dependency>
<dependency>    

<groupId>org.mybatis.spring.boot</groupId>   
 <artifactId>mybatis-spring-boot-starter-test</artifactId> 
  <version>2.1.3</version>
	<scope>test</scope>
</dependency>

• 增加配置

在application文件中增加

mybatis.mapper-locations=classpath:mybatis/mapper/*.xml

这个配置项的值对应到mapper文件的地址

mybatis的配置项比较多，如果都放到application.properties或者yml中,导致配置复杂，可以增加一个mybatis-config.xml ，然后在application文件中指定配置文件的地址

 mybatis.config-location=classpath:mybatis/mybatis-config.xml

<?xmlversion="1.0"encoding="UTF-8"?>
<!DOCTYPEconfigurationPUBLIC"-//mybatis.org//DTDConfig3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>

<!--<propertiesresource="db.properties"></properties>-->
<settings>
<!--打印查询语句-->
<settingname="logImpl"value="STDOUT_LOGGING"/>
<!--控制全局缓存（二级缓存）-->
<settingname="cacheEnabled"value="true"/>
<!--延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。默认false-->
<settingname="lazyLoadingEnabled"value="true"/>
<!--当开启时，任何方法的调用都会加载该对象的所有属性。默认false，可通过select标签的fetchType来覆盖-->
<settingname="aggressiveLazyLoading"value="false"/>
<!--Mybatis创建具有延迟加载能力的对象所用到的代理工具，默认JAVASSIST-->
<!--<settingname="proxyFactory"value="CGLIB"/>-->
<!--STATEMENT级别的缓存，使一级缓存，只针对当前执行的这一statement有效-->
<!--
<settingname="localCacheScope"value="STATEMENT"/>
-->
<settingname="localCacheScope"value="SESSION"/>
</settings>

</configuration>

• Mybatis的Springboot集成原理

引入了mybatis-spring-boot-starter以后，在mybatis-spring-boot-autoconfigure-XXXX.jar里面生命了mybatis的自动化配置类，主要的类是MybatisAutoConfiguration

MybatisAutoConfiguration会读取application文件中mybatis相关的配置，并设置到SqlSessionFactoryBean 。我们配置的mapper文件、config文件地址都会设置给SqlSessioinFactory。SqlSessionFactoryBean 是一个SqlSessioinFactory的FactoryBean。 这个SqlSessionFactoryBean是mybatis自己的逻辑，会解析、验证配置项生成SqlSessionFactory。

总体的初始化过程如下