MyBatis

1. Mybatis历史

1.1 MyBatis 特性

1. MyBatis 是支持定制化SQL、存储过程以及高级映射的优秀的持久层框架
2. MyBatis 避免了几乎所有的 JDBC 代码或手动设置参数以及获取结果集
3. MyBatis 可以使用简单的 XML 或注解用于配置和原始映射，将接口和java的POJO映射成数据库中的记录
4. MyBatis 是一个半自动的ORM 框架

1.2 和其他持久化层技术对比

• JDBC
  • SQL 夹杂在Java代码中耦合度高，导致硬编码内伤
  • 维护不易且实际开发需求中SQL有变化，频繁修改的情况多见
  • 带啊冗长，开发效率低
• Hibernate 和 JPA
  • 操作简单，开发效率高
  • 程序中的长难复杂的SQL需要绕过框架
  • 内部自动生产的SQL，不易做特殊优化
  • 基于全映射的全自动框架，大量字段的POJO进行部分映射时比较困难
  • 反射操作太多，导致数据库性能下降
• MyBatis
  • 轻量级，性能出色
  • SQL和java 编码分开，功能边界清晰。java代码专注业务、SQL语句专注数据
  • 开发效率稍逊于Hlbernate，但是完全能够接收

2. 搭建MyBatis

2.1 Maven 依赖

	<dependencies>
        <!-- Mybatis核心 -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.7</version>
        </dependency>
        <!-- junit测试 -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>
        <!-- MySQL驱动 -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.16</version>
        </dependency>
    </dependencies>

2.2 创建MyBatis的核心配置文件

习惯上命名为mybatis-config.xml，这个文件名仅仅只是建议，并非强制要求。将来整合Spring之后，这个配置文件可以省略，所以大家操作时可以直接复制、粘贴。核心配置文件主要用于配置连接数据库的环境以及MyBatis的全局配置信息核心配置文件存放的位置是放在src/main/resources目录下

<?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>
    <!--设置连接数据库的环境-->
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/ssm?serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <!--引入映射文件-->
    <mappers>
        <mapper resource="mappers/UserMapper.xml"/>
    </mappers>
</configuration>

2.3 创建mapper接口

MyBatis中的mapper接口相当于以前的dao。但是区别在于，mapper仅仅是接口，我们不需要提供实现类。

package com.cxaou.mybatis.mapper;

public interface UserMapper {
    int insertUser();
}

2.3 创建MyBatis的映射文件

相关概念：ORM(Object Relationship Mapping) 对象关系映射

• 对象： java的实体对象
• 关系： 关系型数据库
• 映射： 二者之间的对应关系

Java概念	数据库概念
类	表
属性	字段/列
对象	记录/行

1、映射文件的命名规则：表所对应的实体类的类名+Mapper.xml例如：表t_user，映射的实体类为User，所对应的映射文件为UserMapper.xml，因此一个映射文件对应一个实体类，对应一张表的操作，MyBatis映射文件用于编写SQL，访问以及操作表中的数据

MyBatis映射文件存放的位置是src/main/resources/mappers目录下

2、 MyBatis中可以面向接口操作数据，要保证两个一致：a>mapper接口的全类名和映射文件的命名空间（namespace）保持一致b>mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致

<?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="com.cxaou.mybatis.mapper.UserMapper">
    <!--int insertUser();-->
    <!--
       mapper 接口和映射文件要保证两个一致
       1. mapper接口的全类名和映射文件的namespace一致
       2. mapper接口中的方法的方法名要和映射文件中的SQL的id保持一致
       -->
    <insert id="insertUser">
        insert into t_user values(null,"admian","000000",23,"男","123456@qq.com")
    </insert>
</mapper>

2.3 测试代码

public class MyBatisTest {

    @Test
    public void testInsert(){

        try {
            //获取核心配置文件
            InputStream resourceAsStream = Resources.getResourceAsStream("mybatis-config.xml");
            //SqlSessionFactoryBuilder对象
            SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
            //获取SqlSessionFactory对象
            SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(resourceAsStream);
            //获取 SQL 的会话对象,是MyBatis提供操作数据库的对象
            
             SqlSession sqlSession = sqlSessionFactory.openSession(); // 不会自动提交事务
            //SqlSession sqlSession = sqlSessionFactory.openSession(true); // 会自动自交事务
            
            // 获取UserMapper的代理对象
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            //调用userMapper接口中的方法，实现添加用户信息的功能柜
            int result = userMapper.insertUser();
            System.out.println("result = " + result);
            //提交事务
            sqlSession.commit();
            //关闭会话
            sqlSession.close();
        } catch (IOException e) {
            e.printStackTrace();
        }

    }
}

2.4 加入log4j日志功能

① 加入依赖

<!-- log4j日志 -->
 <!-- https://mvnrepository.com/artifact/org.apache.logging.log4j/log4j-core -->
         <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>

② 加入log4j日志功能

log4j的配置文件名为log4j.xml，存放的位置是src/main/resources目录下

<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
    <appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
        <param name="Encoding" value="UTF-8"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS} %m (%F:%L) \n"/>
        </layout>
    </appender>
    <logger name="java.sql">
        <level value="debug"/>
    </logger>
    <logger name="org.apache.ibatis">
        <level value="info"/>
    </logger>
    <root>
        <level value="debug"/>
        <appender-ref ref="STDOUT"/>
    </root>
</log4j:configuration>

日志的级别

FATAL(致命)>ERROR(错误)>WARN(警告)>INFO(信息)>DEBUG(调试)

从左到右打印的内容越来越详细

3. 核心配置文件详解

<?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>
    <!--
    MyBatis 核心配置文件中的标签必须要按照指定的顺序配置
    (properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,
    objectWrapperFactory?,reflectorFactory?,plugins?,environments?,
    databaseIdProvider?,mappers?)"
    -->

    <!-- 引入properties文件，此后就可以在当前文件中使用${key}的方式访问value的值  -->
    <properties resource="jdbc.properties"/>
    <!--
    给类型起别名,既为某一个具体的类型设置别名在MyBatis的范围中，就可以使用别名访问具体类型

     -->
    <typeAliases>
        <!--
          type：设置需要起别名的类型
          alias: 设置某个类型的别名，可以省略，默认类名，不区分大小写
         -->
        <!--<typeAlias type="com.cxaou.mybatis.pojo.User" alias="user"/>-->
        <!-- 这样写该包下的所有类都有默认别名，既类名不区分大小写        -->
        <package name="com.cxaou.mybatis.pojo"/>
    </typeAliases>
    <!--
    environments: 设置连接数据库的环境
    可以配置多个数据库信息
    default="development" 默认使用数据库环境的Id
    -->
    <environments default="development">
        <!--
            environment： 设置一个具体的连接数据库的环境
            属性：
            id： 设置环境的唯一标识，不能重复
        -->
        <environment id="development">
            <!--
             transactionManager : 设置事务管理器
             属性：
             type：设置事务管理器
             type="JDBC|MANAGED"
             JDBC: 表示使用JDBC中原生的事务管理器
             MANAGED：被管理，例如Spring
             -->
            <transactionManager type="JDBC"/>
            <!--
            dataSource: 设置数据源
            属性：
            type： 设置数据源的类型
            POOLED： 表示使用数据库连接池
            UNPOOLED： 表示不使用数据库连接池
            JNDI： 表示使用上下文中的数据源
            -->
            <dataSource type="POOLED">
                <property name="driver" value="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>

        <environment id="test">
        <transactionManager type="JDBC"/>
        <dataSource type="POOLED">
            <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
            <property name="url" value="jdbc:mysql://localhost:3306/ssm?serverTimezone=UTC"/>
            <property name="username" value="root"/>
            <property name="password" value="000000"/>
        </dataSource>
        </environment>
    </environments>
    <!--引入映射文件-->
    <mappers>
    <!--        <mapper resource="mappers/UserMapper.xml"/>-->
    <!--
        以包的形式引入映射文件，但是必须满足两个条件：
        1. mapper 接口和映射文件所在的包必须一致
        2. mapper 接口的名字和映射文件的名字必须一致
     -->
        <package name="com.cxaou.mybatis.mapper"/>
    </mappers>
</configuration>

4. MyBatis的增删改查

4.1 增

<!--int insertUser();-->
<insert id="insertUser">
    insert into t_user values(null,"admian","000000",23,"男","123456@qq.com")
</insert>

4.2 删

<!--void deleteUser();-->   
<delete id="deleteUser">
    delete from t_user where  id = 4
</delete>

4.3 改

<!-- void updateUser();--> 
<update id="updateUser">
      update t_user set  username="root",password="123456" where id = 3
</update>

4.4 查

    <!--User getUserById()-->
   	<!--
    resultType: 设置结果类型，既查询的数据要转换的java类型
    resultMap: 自定义映射，处理多对一或者一对多的映射关系
    -->
	<select id="getUserById" resultType="com.cxaou.mybatis.pojo.User">
        select * from t_user where id=3
    </select>
	<!-- 查询List集合-->
	<!--    List<User> getAllUser();    -->
    <select id="getAllUser" resultType="com.cxaou.mybatis.pojo.User">
        select * from t_user;
    </select>

5. MyBatis 获取参数值的两种情况

MyBatis获取参数值的两种方式：${}和#{}

${}的本质就是字符串拼接

#{}的本质就是占位符赋值

${}使用字符串拼接的方式拼接sql，若为字符串类型或日期类型的字段进行赋值时，需要手动加单引号；但是#{}使用占位符赋值的方式拼接sql，此时为字符串类型或日期类型的字段进行赋值时，可以自动添加单引号

5.1 单个字面量类型的参数

若mapper接口中的方法参数为单个的字面量类型

此时可以使用KaTeX parse error: Expected 'EOF', got '#' at position 4: {}和#̲{}以任意的名称获取参数的值，…{}需要手动加单引号**

	<!--    User getUserById(Integer id);-->
    <select id="getUserById" resultType="user">
    <!--select * from t_user where id = #{userId}-->
        select * from t_user where id = '${userId}'
    </select>

5.2 多个字面量类型参数时

若mapper接口中的方法参数为多个时，此时MyBatis会自动将这些参数放在一个map集合中，以arg0,arg1…为键，以参数为值；以param1,param2…为键，以参数为值；因此只需要通过KaTeX parse error: Expected 'EOF', got '#' at position 4: {}和#̲{}访问map集合的键就可以获…{}需要手动加单引号**

   	<!--User checkLogin(String userName,String pwd);-->
	<select id="checkLogin" resultType="user">
      <!--  select * from t_user where username = #{arg0} and password= #{arg1} -->
      select * from t_user where username = '${arg0}' and password= '${arg1}'
    </select>

5.3 map 集合类型的参数

若mapper接口中的方法需要的参数为多个时，此时可以手动创建map集合，将这些数据放在map中只需要通过KaTeX parse error: Expected 'EOF', got '#' at position 4: {}和#̲{}访问map集合的键就可以获…{}需要手动加单引号

	 <!--  User checkLoginByMap(Map<String,Object> map); -->
    <select id="checkLoginByMap" resultType="user">
        select * from t_user where username = #{userName} and password = #{pwd}
    </select>

java测试代码

    @Test
    public void testCheckLoginByMap(){
        SqlSession sqlSession = SqlSessionUtil.getSqlSession(true);
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        Map<String,Object> map = new HashMap<>();
        map.put("userName","root");
        map.put("pwd","123456");
        User root = userMapper.checkLoginByMap(map);
        System.out.println("root = " + root);
         sqlSession.close();
    }

5.4 实体类类型的参数

若mapper接口中的方法参数为实体类对象时

此时可以使用KaTeX parse error: Expected 'EOF', got '#' at position 4: {}和#̲{}，通过访问实体类对象中的属…{}需要手动加单引号

    <!--void insertUser(User user);-->
    <insert id="insertUser" >
        insert into t_user values(null,#{userName},#{passWord},#{age},#{gender},#{email});
    </insert>

5.5 使用@Param标识参数

	<!--User checkLoginByParam(@Param("userName") String userName,@Param("pwd") String  pwd);-->
    <select id="checkLoginByParam" resultType="user">
        select  * from t_user where username= #{userName} and password = #{pwd}
    </select>

6. MyBatis的各种查询功能

6.1 查询一个实体对象

    <!-- User getUserById(@Param("id") Integer id);   -->
    <select id="getUserById" resultType="user">
        select * from t_user where id = #{id}
    </select>

6.2 查询一个List集合

	<!--  List<User> getAllUser();  -->
    <select id="getAllUser" resultType="user">
        select * from t_user
    </select>

当查询的数据为多条时，不能使用实体类作为返回值，否则会抛出异常 TooManyResultsException；但是若查询的数据只有一条，可以使用实体类或集合作为返回值

6.3 查询单个数据

	<!-- 
	  Integer getCount(); 
	  在MyBatis中，对于Java中常用的类型都设置了类型别名 
	  例如： java.lang.Integer ->int|integer 
	  例如： int -> _int|_integer 
	  例如： Map ->map,List  ->list
	-->
    <select id="getCount" resultType="integer" >
        select count(*) from t_user;
    </select>

6.4 查询一条数据为 map 的集合

    <!-- Map<String,Object> getUserByIdToMap(@Param("id") Integer id);-->
    <select id="getUserByIdToMap" resultType="map">
        select * from t_user where id = #{id}
    </select>

查询的结果字段名做键，字段值做值

如果字段的值为null,则不会放在对应的map集合中

6.5 查询多条数据为 map 集合

① 方式一

将表中的数据以map集合的方式查询，一条数据对应一个map；若有多条数据，就会产生多个map集合，此 时可以将这些map放在一个list集合中获取

    <!--  List<Map<String,Object>> getAllUserToMap();   -->
    <select id="getAllUserToMap" resultType="map">
        select * from t_user
    </select>

② 方式二

将表中的数据以map集合的方式查询，一条数据对应一个map；若有多条数据，就会产生多个map集合，并 且最终要以一个map的方式返回数据，此时需要通过@MapKey注解设置map集合的键，值是每条数据所对应的map集合

    <!--
		 // 设置 map 的key, 是数据库中的字段
         @MapKey("id")
         Map<String, Object> getAllUserToMap();   
     -->
    <select id="getAllUserToMap" resultType="map">
        select * from t_user
    </select>

7. 特殊SQL的执行

7.1 模糊查询

三种解决方案

  <!--  List<User> getUserByLike(@Param("dim") String dim); -->
    <select id="getUserByLike" resultType="user">
        <!--select * from t_user where username like '%${dim}%'-->
        <!-- concat() 字符串拼接 -->
       <!-- select * from t_user where username like concat('%',#{dim},'%') -->
        select * from t_user where username like "%"#{dim}"%"
    </select>

7.2 批量删除

    <!--void deleteMoreUser(@Param("ids") String ids); //ids 传入参数形式： 9,10,11-->
    <delete id="deleteMoreUser">
        delete from t_user where id in (${ids})
    </delete>

7.3 动态设置表名

    <!--  List<User> getUserList(@Param("tableName") String tableName);  -->
    <select id="getUserList" resultType="user">
        select * from ${tableName}
    </select>

7.4 添加功能获取自增的主键

    <!--  void insertUser(User user);   -->
    <!--
     useGeneratedKeys: 表示当前添加功能使用自增的主键
     keyProperty: 因为增删改有统一的返回值是受影响的行数，因此只能将获取的自增的主键放在传输的参数user对象的某个属性中
     -->
    <insert id="insertUser" useGeneratedKeys="true" keyProperty="id" >
        insert into t_user values(null,#{userName},#{passWord},#{age},#{gender},#{email})
    </insert>

8. 自定义映射resulMap

8.1 使用全局配置文件处理字段名和属性名不一致的情况

在全局配置文件（mybatis-config.xml）中加入

    <settings>
        <!-- 将下划线映射为驼峰-->
        <setting name="mapUnderscoreToCamelCase" value="true"/>
    </settings>

EmpMapper.xml文件

    <!--Emp getEmpByEmpId(@Param("empId") Integer empId);-->
    <select id="getEmpByEmpId" resultType="emp">
      <!--  SELECT emp_id empId,emp_name empName,age,gender FROM t_emp where emp_id = #{empId}-->
        SELECT * FROM t_emp where emp_id = #{empId}
    </select>

8.2 resultMap 处理字段和属性的映射关系

若字段名和实体类中的属性名不一致，则可以通过resultMap设置自定义映射

 	 <!--resultMap：设置自定义映射 属性： 
		id：表示自定义映射的唯一标识 
		type：查询的数据要映射的实体类的类型 
			子标签： 
				id：设置主键的映射关系 
				result：设置普通字段的映射关系
				association：设置多对一的映射关系 
				collection：设置一对多的映射关系 
					属性： 
						column：设置映射关系中表中的字段名
                        property：设置映射关系中实体类中的属性名 
                        
 	-->
	<resultMap id="empResultMap" type="emp">
        <id column="emp_id" property="empId"/>
        <result column="emp_name" property="empName"/>
        <result column="age" property="age"/>
        <result column="gender" property="gender"/>
    </resultMap>
    <!--Emp getEmpByEmpId(@Param("empId") Integer empId);-->
    <select id="getEmpByEmpId" resultMap="empResultMap">
        SELECT * FROM t_emp where emp_id = #{empId}
    </select>

8.3 处理多对一的映射关系

场景模拟：

查询员工信息以及员工所对应的部门信息

8.3.1 级联方式处理映射关系

    <resultMap id="empAndDeptResultMap" type="emp">
        <id column="emp_id" property="empId"/>
        <result column="emp_name" property="empName"/>
        <result column="age" property="age"/>
        <result column="gender" property="gender"/>
        <result column="dept_id" property="dept.deptId"/>
        <result column="dept_name" property="dept.deptName"/>
    </resultMap>
    <!--Emp getEmpAndDeptByEmpId(@Param("empId") Integer empId);-->
    <select id="getEmpAndDeptByEmpId" resultMap="empAndDeptResultMap">
         SELECT
            t_emp.*,
            t_dept.dept_name
        FROM
            t_emp
            LEFT JOIN t_dept ON t_emp.dept_id = t_dept.dept_id
        WHERE
            t_emp.emp_id = #{empId}
    </select>

8.3.2 使用association处理映射关系

    <resultMap id="empAndDeptResultMap" type="emp">
        <id column="emp_id" property="empId"/>
        <result column="emp_name" property="empName"/>
        <result column="age" property="age"/>
        <result column="gender" property="gender"/>
        <!--
            association: 处理多对一的映射关系(处理实体类类型属性)
            property: 设置需要处理映射关系的属性的属性名
            javaType: 设置要处理的属性类型
         -->
        <association property="dept" javaType="Dept">
            <id column="dept_id" property="deptId"/>
            <result column="dept_name" property="deptName"/>
        </association>
    </resultMap>
    <!--Emp getEmpAndDeptByEmpId(@Param("empId") Integer empId);-->
    <select id="getEmpAndDeptByEmpId" resultMap="empAndDeptResultMap">
         SELECT
            t_emp.*,
            t_dept.dept_name
        FROM
            t_emp
            LEFT JOIN t_dept ON t_emp.dept_id = t_dept.dept_id
        WHERE
            t_emp.emp_id = #{empId}
    </select>

8.3.3 分步查询

第一步 查询员工信息

 	<resultMap id="empAndDeptByStepResultMap" type="emp">
        <id column="emp_id" property="empId"/>
        <result column="emp_name" property="empName"/>
        <result column="age" property="age"/>
        <result column="gender" property="gender"/>
        <!-- select 第二步sql的唯一标识，也就是查询部门信息的SQL语句 -->
        <association property="dept"
                     select="com.cxaou.mybatis.mapper.DeptMapper.getEmpAndDeptByStepTwo"
                     column="dept_id">
        </association>
    </resultMap>
    <!--Emp getEmpAndDeptByStepOne(@Param("empId") Integer empId);-->
    <select id="getEmpAndDeptByStepOne" resultMap="empAndDeptByStepResultMap">
        select * from t_emp where emp_id = #{empId}
    </select>

第二步 查询部门信息

    <!-- Dept getEmpAndDeptByStepTwo(@Param("deptId") Integer deptId);-->
    <select id="getEmpAndDeptByStepTwo" resultType="Dept">
        select * from t_dept where dept_id = #{deptId}
    </select>

注意 这样写核心配置文件(mybatis-config.xml)要有如下配置：

	<settings>
        <!-- 将下划线映射为驼峰-->
        <setting name="mapUnderscoreToCamelCase" value="true"/>
    </settings>

或者把查询部门信息 resultType 改成 resultMap

    <resultMap id="getEmpAndDeptByStepTwoResultMap" type="dept">
        <id column="dept_id" property="deptId"/>
        <result column="dept_name" property="deptName"/>
    </resultMap>
    <select id="getEmpAndDeptByStepTwo" resultMap="getEmpAndDeptByStepTwoResultMap">
        select * from t_dept where dept_id = #{deptId}
    </select>

分布查询的优点(延迟加载)

分步查询的优点：可以实现延迟加载但是必须在核心配置文件中设置全局配置信息：

lazyLoadingEnabled：延迟加载的全局开关。当开启时，所有关联对象都会延迟加载，也就是如果用不到执行第二步SQL所获得的数据就不会执行第二步的SQL语句

aggressiveLazyLoading：当开启时，任何方法的调用都会加载该对象的所有属性。否则，每个属性会按需加载此时就可以实现按需加载，获取的数据是什么，就只会执行相应的sql。此时可通过association和collection中的fetchType属性设置当前的分步查询是否使用延迟加载， fetchType=“lazy(延迟加载)|eager(立即加载)”

以下两个属性配合实现了延迟加载

   <settings>
        <!-- 将下划线映射为驼峰-->
        <setting name="mapUnderscoreToCamelCase" value="true"/>
        <!-- 开启延迟加载 -->
        <setting name="lazyLoadingEnabled" value="true"/>
        <!-- 按需加载  -->
        <setting name="aggressiveLazyLoading" value="fleas"/>
    </settings>

8.4 一对多映射处理

8.4.1 collection

    <resultMap id="getDeptAndEmpResultMap" type="Dept">
        <id column="dept_id" property="deptId"/>
        <result column="dept_name" property="deptName"/>
        <!--
            ofType: 设置集合类型的属性中存储的数据类型
         -->
        <collection property="empList" ofType="Emp">
            <id column="emp_id" property="empId"/>
            <result column="emp_name" property="empName"/>
            <result column="age" property="age"/>
            <result property="gender" column="gender"/>
        </collection>
    </resultMap>
    <!-- Dept getDeptAndEmp(@Param("deptId")Integer deptId); -->
    <select id="getDeptAndEmp" resultMap="getDeptAndEmpResultMap">
         SELECT
            d.*,
            e.emp_id,
            e.emp_name,
            e.age,
            e.gender
        FROM
            t_dept d
            LEFT JOIN t_emp e ON d.dept_id = e.dept_id
        WHERE
            d.dept_id = #{deptId};
    </select>

8.4.2 分布查询

第一步 查询部门信息

   <resultMap id="getDeptAndEmpByStepOneResultMap" type="Dept">
        <id property="deptId" column="dept_id"/>
        <result property="deptName" column="dept_Name"/>
        <collection property="empList"
                    select="com.cxaou.mybatis.mapper.EmpMapper.getDeptAndEmpByStepTwo"
                    column="dept_id">
        </collection>
    </resultMap>
    <!-- Dept getDeptAndEmpByStepOne(@Param("deptId") Integer deptId);   -->
    <select id="getDeptAndEmpByStepOne" resultMap="getDeptAndEmpByStepOneResultMap">
        select * from t_dept where dept_id = #{deptId}
    </select>

第二步 根据部门Id查询部门中的所有员工信息

    <resultMap id="empResultMap" type="emp">
        <id column="emp_id" property="empId"/>
        <result column="emp_name" property="empName"/>
        <result column="age" property="age"/>
        <result column="gender" property="gender"/>
    </resultMap>
	<!-- List<Emp> getDeptAndEmpByStepTwo(@Param("deptId") Integer deptId); -->
    <select id="getDeptAndEmpByStepTwo" resultMap="empResultMap">
        select * from t_emp where dept_id = #{dept_id}
    </select>

9. 动态sql

Mybatis框架的动态SQL技术是一种根据特定条件动态拼装SQL语句的功能，它存在的意义是为了解决 拼接SQL语句字符串时的痛点问题。

9.1 if

if标签可通过test属性的表达式进行判断，若表达式的结果为true，则标签中的内容会执行；反之标签中的内容不会执行

    <!--   List<Emp> getEmpByCondition(Emp emp);   -->
    <select id="getEmpByCondition" resultType="Emp">
        select * from t_emp where 1 = 1
        <if test="empName != null and empName != '' ">
            and emp_name = #{empName}
        </if>
        <if test="age != null and age != '' ">
            and age = #{age}
        </if>
        <if test="gender != null and gender != '' ">
            and gender = #{gender}
        </if>
    </select>

9.2 where

where和if一般结合使用：

1. 若where标签中有条件成立，会自动生成where关键字
2. 会自动将where标签中内容前多余的and去掉
3. 若where标签中没有任何一个条件成立，则where没有任何功能

    <select id="getEmpByCondition" resultType="Emp">
        select * from t_emp
        <where>
            <if test="empName != null and empName != '' ">
                emp_name = #{empName}
            </if>
            <if test="age != null and age != '' ">
                and age = #{age}
            </if>
            <if test="gender != null and gender != '' ">
                and gender = #{gender}
            </if>
        </where>
    </select>

注意：where标签不能去掉条件最后多余的and

9.3 trim

trim用于去掉或添加标签中的内容

常用属性：

prefix：在trim标签中的内容的前面添加某些内容

prefixOverrides：在trim标签中的内容的前面去掉某些内容

suffix：在trim标签中的内容的后面添加某些内容

suffixOverrides：在trim标签中的内容的后面去掉某些内容

    <!--   List<Emp> getEmpByCondition(Emp emp);   -->
    <select id="getEmpByCondition" resultType="Emp">
        select * from t_emp
        <trim prefix="where" suffixOverrides="and">
            <if test="empName != null and empName != '' ">
                emp_name = #{empName} and
            </if>
            <if test="age != null and age != '' ">
                age = #{age} and
            </if>
            <if test="gender != null and gender != '' ">
                gender = #{gender}
            </if>
        </trim>
    </select>

如果trim标签中没一个条件成立,则trim没有任何功能

9.4 choose 、 when 、otherwise

choose、when、 otherwise相当于if…else if…else

when标签至少要有一个相当于else if

otherwise 可以省略，相当于 else

 	<!--List<Emp> getEmpByChoose(Emp emp);-->
    <select id="getEmpByChoose" resultType="Emp">
        select * from t_emp
        <where>
            <choose>
                <when test="empName != null and empName != '' ">
                    emp_name = #{empName}
                </when>
                <when test="age != null and age != ''">
                    age = #{age}
                </when>
                <when test="gender != null and gender != '' ">
                    gender = #{gender}
                </when>
            </choose>
        </where>
    </select>

9.5 foreach

• collection: 设置要循环的数组或集合
• item：用一个字符串表示数组或集合中的每一个数据
• separator: 设置每次循环的数据之间的分隔符
• open： 循环的所有内容以什么开始
• close： 循环的所有内容以什么结束

批量添加

    <!--void insertMoreEmp(@Param("empList") List<Emp> empList);-->
    <insert id="insertMoreEmp">
        insert into t_emp values
        <foreach collection="empList" item="emp" separator=",">
            (null,#{emp.empName},#{emp.age},#{emp.gender},null)
        </foreach>
    </insert>

批量删除

第一种 in

	<!--void deleteMoreEmp(@Param("empIds") Integer[] empIds);-->
    <delete id="deleteMoreEmp">
        delete from t_emp where emp_id in
        <foreach collection="empIds" item="empId" separator="," open="(" close=")">
            #{empId}
        </foreach>
    </delete>

第二种 or

    <!--void deleteMoreEmp(@Param("empIds") Integer[] empIds);-->
    <delete id="deleteMoreEmp">
        delete from t_emp where
        <foreach collection="empIds" item="empId" separator="or" >
            emp_id = #{empId}
        </foreach>
    </delete>

9.6 SQL片段

sql片段，可以记录一段公共sql片段，在使用的地方通过include标签进行引入

    <sql id="empColumns">
        emp_id,emp_name,age,gender,dept_id
    </sql>

    <select id="getEmpByCondition" resultType="Emp">
        select <include refid="empColumns"/> from t_emp
        <trim prefix="where" suffixOverrides="and" >
            <if test="empName != null and empName != '' ">
                emp_name = #{empName} and
            </if>
            <if test="age != null and age != '' ">
                age = #{age} and
            </if>
            <if test="gender != null and gender != '' ">
                gender = #{gender}
            </if>
        </trim>
    </select>

10 MyBatis的缓存

10.1 MyBatis的一级缓存

一级缓存是SqlSession级别的，通过同一个SqlSession查询的数据会被缓存，下次查询相同的数据，就会从缓存中直接获取，不会从数据库重新访问

使一级缓存失效的四种情况：

1. 不同的SqlSession对应不同的一级缓存
2. 同一个SqlSession但是查询条件不同
3. 同一个SqlSession两次查询期间执行了任何一次增删改操作
4. 同一个SqlSession两次查询期间手动清空了缓存(sqlSession.clearCache();)

10.2 二级缓存

二级缓存是SqlSessionFactory级别，通过同一个SqlSessionFactory创建的SqlSession查询的结果会被 缓存；此后若再次执行相同的查询语句，结果就会从缓存中获取

二级缓存开启的条件：

1. 在核心配置文件中，设置全局配置属性cacheEnabled=“true”，默认为true，不需要设置
2. 在映射文件中设置标签
3. 二级缓存必须在SqlSession关闭或提交之后有效
4. 查询的数据所转换的实体类类型必须实现序列化的接口 implements Serializable

使二级缓存失效的情况：

两次查询之间执行了任意的增删改，会使一级和二级缓存同时失效

10.3 二级缓存的相关配置

在mapper配置文件中添加的cache标签可以设置一些属性：

• ①eviction属性：缓存回收策略，默认的是 LRU。
  • LRU（Least Recently Used） – 最近最少使用的：移除最长时间不被使用的对象。
  • FIFO（First in First out） – 先进先出：按对象进入缓存的顺序来移除它们。
  • SOFT – 软引用：移除基于垃圾回收器状态和软引用规则的对象。
  • WEAK – 弱引用：更积极地移除基于垃圾收集器状态和弱引用规则的对象。
• ②flushInterval属性：刷新间隔，单位毫秒
  • 默认情况是不设置，也就是没有刷新间隔，缓存仅仅调用语句时刷新
• ③size属性：引用数目，正整数
  • 代表缓存最多可以存储多少个对象，太大容易导致内存溢出
• ④readOnly属性：只读， true/false
  • true：只读缓存；会给所有调用者返回缓存对象的相同实例。因此这些对象不能被修改。这提供了 很重要的性能优势。
  • false：读写缓存；会返回缓存对象的拷贝（通过序列化）。这会慢一些，但是安全，因此默认是false。

10.4 MyBatis缓存查询的顺序

先查询二级缓存，因为二级缓存中可能会有其他程序已经查出来的数据，可以拿来直接使用。

如果二级缓存没有命中，再查询一级缓存

如果一级缓存也没有命中，则查询数据库

SqlSession关闭之后，一级缓存中的数据会写入二级缓存

10.5 整合第三方缓存EHCache

10.5.1 添加依赖

        <!-- Mybatis EHCache整合包 -->
        <dependency>
            <groupId>org.mybatis.caches</groupId>
            <artifactId>mybatis-ehcache</artifactId>
            <version>1.2.1</version>
        </dependency>

        <!-- slf4j日志门面的一个具体实现 -->
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
            <version>1.2.3</version>
        </dependency>

10.5.2 各种 jar 包功能

jar包名称	作用
mybatis-ehcache	Mybatis和EHCache的整合包
ehcache	EHCache核心包
slf4j-api	SLF4J日志门面包
logback-classic	支持SLF4J门面接口的一个具体实现

10.5.3 创建EHCache的配置文件ehcache.xml

<?xml version="1.0" encoding="utf-8" ?>
<ehcache xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="../config/ehcache.xsd">
    <!-- 磁盘保存路径 -->
    <diskStore path="D:\cxaou\ehcache"/>
    <defaultCache maxElementsInMemory="1000" maxElementsOnDisk="10000000" eternal="false" overflowToDisk="true"
                  timeToIdleSeconds="120" timeToLiveSeconds="120" diskExpiryThreadIntervalSeconds="120"
                  memoryStoreEvictionPolicy="LRU"></defaultCache>
</ehcache>

10.5.4 设置二级缓存的类型

<cache type="org.mybatis.caches.ehcache.EhcacheCache"/>

10.5.5 加入logback日志

存在SLF4J时，作为简易日志的log4j将失效，此时我们需要借助SLF4J的具体实现logback来打印日志。 创建logback的配置文件logback.xml

<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="true"> <!-- 指定日志输出的位置 -->
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <!-- 日志输出的格式 -->
            <!-- 按照顺序分别是： 时间、日志级别、线程名称、打印日志的类、日志主体内容、换行 -->
            <pattern>[%d{HH:mm:ss.SSS}] [%-5level] [%thread] [%logger] [%msg]%n</pattern>
        </encoder>
    </appender>
    <!-- 设置全局日志级别。日志级别按顺序分别是： DEBUG、INFO、WARN、ERROR --> <!-- 指定任何一个日志级别都只打印当前级别和后面级别的日志。 -->
    <root level="DEBUG">
        <!-- 指定打印日志的appender，这里通过“STDOUT”引用了前面配置的appender -->
        <appender-ref ref="STDOUT"/>
    </root>
    <!-- 根据特殊需求指定局部日志级别 -->
    <logger name="com.cxaou.mybatis.mapper" level="DEBUG"/>
</configuration>

10.5.6 EHCache配置文件说明

属性名	是否必须	作用
maxElementsInMemory	是	在内存中缓存的element的最大数目
maxElementsOnDisk	是	在磁盘上缓存的element的最大数目，若是0表示无穷大
eternal	是	设定缓存的elements是否永远不过期。 如果为true，则缓存的数据始终有效， 如果为false那么还要根据timeToIdleSeconds、timeToLiveSeconds判断
overflowToDisk	是	设定当内存缓存溢出的时候是否将过期的element缓存到磁盘上
timeToIdleSeconds	否	当缓存在EhCache中的数据前后两次访问的时间超过timeToIdleSeconds的属性取值时， 这些数据便会删除，默认值是0,也就是可闲置时间无穷大
timeToLiveSeconds	否	缓存element的有效生命期，默认是0.,也就是element存活时间无穷大
diskSpoolBufferSizeMB	否	DiskStore(磁盘缓存)的缓存区大小。默认是30MB。每个Cache都应该有自己的一个缓冲区
diskPersistent	否	在VM重启的时候是否启用磁盘保存EhCache中的数据，默认是false。
diskExpiryThreadIntervalSeconds	否	磁盘缓存的清理线程运行间隔，默认是120秒。每个120s， 相应的线程会进行一次EhCache中数据的清理工作
memoryStoreEvictionPolicy	否	当内存缓存达到最大，有新的element加入的时候， 移除缓存中element的策略。 默认是LRU （最近最少使用），可选的有LFU （最不常使用）和FIFO （先进先出）

11. MyBatis的逆向工程

正向工程：先创建Java实体类，由框架负责根据实体类生成数据库表。 Hibernate是支持正向工程的。

逆向工程：先创建数据库表，由框架负责根据数据库表，反向生成如下资源：

• Java实体类
• Mapper接口
• Mapper映射文件

11.1 创建逆向工程的步骤

① 添加依赖和插件

 <!-- 依赖MyBatis核心包 -->
    <dependencies>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.7</version>
        </dependency>
        <!-- junit测试 -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>
        <!-- log4j日志 -->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.16</version>
        </dependency>
    </dependencies>
    <!-- 控制Maven在构建过程中相关配置 -->
    <build>
        <!-- 构建过程中用到的插件 -->
        <plugins>
            <!-- 具体插件，逆向工程的操作是以构建过程中插件形式出现的 -->
            <plugin>
                <groupId>org.mybatis.generator</groupId>
                <artifactId>mybatis-generator-maven-plugin</artifactId>
                <version>1.3.0</version>
                <!-- 插件的依赖 -->
                <dependencies>
                    <!-- 逆向工程的核心依赖 -->
                    <dependency>
                        <groupId>org.mybatis.generator</groupId>
                        <artifactId>mybatis-generator-core</artifactId>
                        <version>1.3.2</version>
                    </dependency>
                    <!-- MySQL驱动 -->
                    <dependency>
                        <groupId>mysql</groupId>
                        <artifactId>mysql-connector-java</artifactId>
                        <version>8.0.16</version>
                    </dependency>
                </dependencies>
            </plugin>
        </plugins>
    </build>

② 创建MyBatis的核心配置文件

③ 创建逆向工程的配置文件

文件名必须是：generatorConfig.xml

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE generatorConfiguration PUBLIC
        "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
        "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
<generatorConfiguration>
    <!--
        targetRuntime: 执行生成的逆向工程的版本
        MyBatis3Simple: 生成基本的CRUD（清新简洁版）
        MyBatis3: 生成带条件的CRUD（奢华尊享版）
     -->
    <context id="DB2Tables" targetRuntime="MyBatis3">
        <!-- 数据库的连接信息 -->
        <jdbcConnection driverClass="com.mysql.cj.jdbc.Driver"
                        connectionURL="jdbc:mysql://localhost:3306/ssm?serverTimezone=UTC" userId="root"
                        password="000000">
        </jdbcConnection>
        <!-- javaBean的生成策略-->
        <javaModelGenerator targetPackage="com.cxaou.mybatis.pojo" targetProject=".\src\main\java">
            <property name="enableSubPackages" value="true"/>
            <property name="trimStrings" value="true"/>
        </javaModelGenerator>
        <!-- SQL映射文件的生成策略 -->
        <sqlMapGenerator targetPackage="com.cxaou.mybatis.mapper" targetProject=".\src\main\resources">
            <property name="enableSubPackages" value="true"/>
        </sqlMapGenerator>
        <!-- Mapper接口的生成策略 -->
        <javaClientGenerator type="XMLMAPPER" targetPackage="com.cxaou.mybatis.mapper"
                             targetProject=".\src\main\java">
            <property name="enableSubPackages" value="true"/>
        </javaClientGenerator>
        <!-- 逆向分析的表 -->
        <!-- tableName设置为*号，可以对应所有表，此时不写domainObjectName -->
        <!-- domainObjectName属性指定生成出来的实体类的类名 -->
        <table tableName="t_emp" domainObjectName="Emp"/>
        <table tableName="t_dept" domainObjectName="Dept"/>
    </context>
</generatorConfiguration>

④ 执行MBG插件的generate目标

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-8KtaOjvP-1662989524576)(F:\笔记\java\java框架\ssm\ssm_imgs\执行逆向工程插件.png)]

11.2 QBC查询

 public void testMBG(){
        SqlSession sqlSession = SqlSessionUtil.getSqlSession(true);
        EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
        //根据Id查询数据
        /*
        Emp emp = mapper.selectByPrimaryKey(1);
        System.out.println("emp = " + emp);
        */
        //查询所有数据
        /*
        List<Emp> empList = mapper.selectByExample(null);
        empList.forEach(System.out::println);
         */
        /*
        // 根据条件查询
        EmpExample empExample = new EmpExample();
        //创建条件对象
        empExample.createCriteria().andEmpNameEqualTo("张三").andAgeGreaterThanOrEqualTo(17);
        List<Emp> empList = mapper.selectByExample(empExample);
        empList.forEach(System.out::println);
         */

        Emp emp = new Emp(1,"小黑",null,"女");
        // 测试普通的修改方法,如果值填null,他会把数据库中的数值修改成null,而updateByPrimaryKeySelective(emp); 不会
//        int i = mapper.updateByPrimaryKey(emp);
        // 测试选择性修改
        mapper.updateByPrimaryKeySelective(emp);
    }

12. 分页插件

12.1 分页插件使用步骤

① 添加依赖

		 <!-- 分页插件 -->
        <dependency>
            <groupId>com.github.pagehelper</groupId>
            <artifactId>pagehelper</artifactId>
            <version>5.2.0</version>
        </dependency>

② 配置分页插件

在MyBatis的核心配置文件中配置插件

 	<plugins>
        <!--设置分页插件-->
        <plugin interceptor="com.github.pagehelper.PageInterceptor"/>
    </plugins>

12.2 分页插件的使用

	@Test
    public void testPage(){
        SqlSession sqlSession = SqlSessionUtil.getSqlSession(true);
        EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
        //查询功能之前开启分页功能
        Page<Object> page = PageHelper.startPage(1, 4);
        List<Emp> empList = mapper.selectByExample(null);
        //在查询功能之后可以获取分页相关的所有数据
        PageInfo<Emp> pageInfo = new PageInfo<>(empList,5);
        empList.forEach(System.out::println);
        System.out.println("**************************************");
        System.out.println(page);
        System.out.println("**************************************");
        System.out.println(pageInfo);

    }

• 在查询功能之前使用PageHelper.startPage(int pageNum, int pageSize)开启分页功能
  • pageNum：当前页的页码
  • pageSize：每页显示的条数
• 在查询获取list集合之后，使用PageInfo pageInfo = new PageInfo<>(List list, intnavigatePages)获取分页相关数据
  • list：分页之后的数据
  • navigatePages：导航分页的页码数
• 分页相关数据

PageInfo{pageNum=1, pageSize=4, size=4, startRow=1, endRow=4, total=108, pages=27,
list=Page{count=true, pageNum=1, pageSize=4, startRow=0, endRow=4, total=108, pages=27, reasonable=false, pageSizeZero=false}
[
Emp{empId=1, empName='小黑', age=20, gender='女', deptId=1},
Emp{empId=2, empName='李四', age=19, gender='男', deptId=2},
Emp{empId=3, empName='王五', age=16, gender='男', deptId=3},
Emp{empId=4, empName='赵六', age=22, gender='男', deptId=1}
],
prePage=0, nextPage=2, isFirstPage=true, isLastPage=false, hasPreviousPage=false, hasNextPage=true, navigatePages=5, navigateFirstPage=1, navigateLastPage=5, navigatepageNums=[1, 2, 3, 4, 5]}

pageNum：当前页的页码

pageSize：每页显示的条数

size：当前页显示的真实条数

total：总记录数

pages：总页数

prePage：上一页的页码

nextPage：下一页的页码

isFirstPage/isLastPage：是否为第一页/最后一页

hasPreviousPage/hasNextPage：是否存在上一页/下一页

navigatePages：导航分页的页码数

navigatepageNums：导航分页的页码，[1,2,3,4,5]
tln(““);
System.out.println(page);
System.out.println(””);
System.out.println(pageInfo);

}

- 在查询功能之前使用PageHelper.startPage(int pageNum, int pageSize)开启分页功能
  - pageNum：当前页的页码
  - pageSize：每页显示的条数
- 在查询获取list集合之后，使用PageInfo<T> pageInfo = new PageInfo<>(List<T> list, intnavigatePages)获取分页相关数据
  - list：分页之后的数据
  - navigatePages：导航分页的页码数
- 分页相关数据

PageInfo{pageNum=1, pageSize=4, size=4, startRow=1, endRow=4, total=108, pages=27,
list=Page{count=true, pageNum=1, pageSize=4, startRow=0, endRow=4, total=108, pages=27, reasonable=false, pageSizeZero=false}
[
Emp{empId=1, empName=‘小黑’, age=20, gender=‘女’, deptId=1},
Emp{empId=2, empName=‘李四’, age=19, gender=‘男’, deptId=2},
Emp{empId=3, empName=‘王五’, age=16, gender=‘男’, deptId=3},
Emp{empId=4, empName=‘赵六’, age=22, gender=‘男’, deptId=1}
],
prePage=0, nextPage=2, isFirstPage=true, isLastPage=false, hasPreviousPage=false, hasNextPage=true, navigatePages=5, navigateFirstPage=1, navigateLastPage=5, navigatepageNums=[1, 2, 3, 4, 5]}

pageNum：当前页的页码

pageSize：每页显示的条数

size：当前页显示的真实条数

total：总记录数

pages：总页数

prePage：上一页的页码

nextPage：下一页的页码

isFirstPage/isLastPage：是否为第一页/最后一页

hasPreviousPage/hasNextPage：是否存在上一页/下一页

navigatePages：导航分页的页码数

navigatepageNums：导航分页的页码，[1,2,3,4,5]