Mybatis知识点记录

缺乏、安全感 2024-03-31 14:22 74阅读 0赞

#### Mybatis知识点记录 ####

*   *  Mybatis
     *   *  1. 简介
         *   *  1.1 历史
             *  1.2 特性
         *  2. 官方下载
         *  3. 与其他持久层框架对比
         *  4. 快速开始
         *   *  4.1 开发环境
             *  4.2 Maven
             *  4.3 核心配置文件
             *  4.4 Mapper接口
             *  4.5 映射文件
             *  4.6 测试功能
             *  4.7 log4j
         *  5. 核心配置文件
         *  6. IDEA核心配置文件模板
         *  7. 获取参数
         *  8. 查询功能详解
         *  9. 特殊SQL
         *  10. ResultMap
         *   *  10.1 字段名和属性名不一致的情况
             *   *  10.1.1 \*\*方式一：\*\* 使用别名
                 *  10.1.2 \*\*方式二：\*\* 在核心配置文件中添加settings配置将下滑线映射为驼峰
                 *  10.1.3 \*\*方式三：\*\* 自定义映射
             *  10.2 多对一关系
             *   *  10.2.1 级联方式
                 *  10.2.2 association标签
                 *  10.2.3 分步骤查询方式
             *  10.3 一对多关系
             *   *  10.3.1 collection
                 *  10.3.2 分步骤查询
         *  11. 动态SQL
         *   *  11.1 if标签
             *  11.2 where标签
             *  11.3 trim标签
             *  11.4 choose、when、otherwise标签
             *  11.5 foreach标签
             *   *  11.5.1 批量添加
                 *  11.5.2 批量删除
             *  11.6 SQL片段
         *  12. Mybatis的缓存
         *   *  12.1 Mybatis的一级缓存
             *  12.2 Mybatis的二级缓存
             *   *  12.2.1 Mybatis的二级缓存开启的四个条件
                 *  12.2.2 mybatis的二级缓存失效
                 *  12.2.3 Mybatis的二级缓存的相关配置!\[在这里插入图片描述\](https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/ab81c4e4dc2d4bdaa36e9b95778acfed.png)
             *  12.3 Mybatis缓存查询的顺序
             *  12.4 整合第三方缓存EHCache
         *  13. Mybatis的逆向工程
         *  14. 分页插件
         *   *  14.1 分页插件的使用步骤

--------------------

### Mybatis ###

#### 1. 简介 ####

##### 1.1 历史 #####

##### 1.2 特性 #####

*  **定制化SQL**：即可以自己手写SQL语句。
 *  **支持存储过程**
 *  **支持高级映射**：即POJO和数据库字段的映射方式可以自定义。
 *  **封装了JDBC代码，和结果集的处理过程**：不用手写JDBC代码和结果集处理的过程。

--------------------

#### 2. 官方下载 ####

--------------------

#### 3. 与其他持久层框架对比 ####

--------------------

#### 4. 快速开始 ####

##### 4.1 开发环境 #####

>  *  **IDE**：IDEA: 2022.2.4。
>  *  **构建工具**：maven 3.8.5
>  *  **MySQL版本**：MySQL8
>  *  **MyBatis 版本**：MyBatis 3.5.7

##### 4.2 Maven #####

pom.xml

<dependencies>
            
            <dependency>
                <groupId>org.mybatis</groupId>
                <artifactId>mybatis</artifactId>
                <version>3.5.7</version>
            </dependency>
    
            
            <dependency>
                <groupId>junit</groupId>
                <artifactId>junit</artifactId>
                <version>4.12</version>
                <scope>test</scope>
            </dependency>
    
            
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <version>8.0.16</version>
            </dependency>
        </dependencies>

##### 4.3 核心配置文件 #####

> **建议命名**：mybatis-config.xml  
> **放置路径**：src/main/resources

> **核心配置文件作用**：
> 
>  *  配置链接数据库的环境
>  *  配置MyBatis

mybatis-config.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>
        
        <environments default="development">
            <environment id="development">
    
                
                <transactionManager type="JDBC"></transactionManager>
    
                
                <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="root"/>
                </dataSource>
            </environment>
        </environments>
    
        
        <mappers>
            <mapper resource="mappers/UserMapper.xml"></mapper>
        </mappers>
    </configuration>

##### 4.4 Mapper接口 #####

相当于DAO，但是不用创建实现类，MyBatis会创建代理类，并执行映射文件当中的SQL。

> **起名规则**：POJO的名+Mapper  
> **放置路径**：src/main/java/com/atguigu/mybatis/mapper/UserMapper.java

package com.atguigu.mybatis.mapper;
    
    public interface UserMapper {
        
        /**
         * 添加用户信息
         */
        int insertUser();
    }

##### 4.5 映射文件 #####

Mapper 接口当中的一个抽象方法 对应 映射文件当中的一个SQL语句。

> **起名规则**：POJO的名+Mapper.xml  
> **放置路径**：src/main/resources/com/atguigu/mybatis/mapper/UserMapper.xml

这里我们写一条固定的插入SQL，参数如何传递请请看后方比较详细的笔记。

UserMapper.xml

##### 4.6 测试功能 #####

下方代码：从开始到创建 SqlSessionFactory 只用创建一次即可，因此可以单独封装即可。  
openSession() 获得 SqlSession 默认是不自动提交事务，因此需要自己手动提交。

> **放置路径**：src/test/java/com/atguigu/mybatis/test/MybatisTest.java

MybatisTest.java

package com.atguigu.mybatis;
    
    import org.apache.ibatis.io.Resources;
    import org.apache.ibatis.session.SqlSession;
    import org.apache.ibatis.session.SqlSessionFactory;
    import org.apache.ibatis.session.SqlSessionFactoryBuilder;
    import org.junit.Test;
    import com.atguigu.mybatis.mapper.UserMapper;
    
    import java.io.IOException;
    import java.io.InputStream;
    
    public class MyBatisTest {
        
        @Test
        public void testInsert() throws IOException {
        
            // 获取核心配置文件的输入流
            InputStream resourceAsStream = Resources.getResourceAsStream("mybatis-config.xml");
    
            // 获取SqlSessionFactoryBuilder 对象 -> 工厂构建器
            SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
    
            // 创建 SqlSession 工厂 -> 创建会话
            SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(resourceAsStream);
    
            // 获取 会话 对象 -> MyBatis 提供的操作数据库的对象
            SqlSession sqlSession = sqlSessionFactory.openSession();
    
            // 获得Mapper接口的代理类 -> 操纵Mapper类执行数据库操作
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
    
            // 执行SQL操作
            Integer rows = userMapper.insertUser();
            System.out.println("rows = " + rows);
    
            // 提交事务 -> 事务是默认开启的
            sqlSession.commit();
    
            // 关闭资源
            sqlSession.close();
        }
    }

##### 4.7 log4j #####

> 日志级别：FATAL（致命）> ERROR（错误）>WARN（警告）INFO（信息）> DEBUG（调试）  
> 从左到右打印的内容越来越详细.

pom.xml

<dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.17</version>
    </dependency>

> 放置路径：src/main/resources/log4j.xml

网址爆红不用管他  
log4j.xml

<?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="%-5d %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>

--------------------

#### 5. 核心配置文件 ####

--------------------

#### 6. IDEA核心配置文件模板 ####

**（1）核心配置文件mybatis-config.xml**

> **文件位置**：src/main/resources/mybatis-config.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"></properties>
        
        <settings>
            
            <setting name="mapUnderscoreToCamelCase" value="true"/>
            
            <setting name="lazyLoadingEnabled" value="true"/>
            
            <setting name="aggressiveLazyLoading" value="false"/>
        </settings>
        
        
        <typeAliases>
            
            <package name=""/>
        </typeAliases>
    
        
        <environments default="development">
            <environment id="development">
                <transactionManager type="JDBC"></transactionManager>
                <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>
        </environments>
    
        
        <mappers>
            
            <package name=""/>
        </mappers>
    </configuration>

**（2）配置数据库的jdbc.properties**

> **文件位置**：src/main/resources/jdbc.properties

jdbc.driver=com.mysql.cj.jdbc.Driver
    jdbc.url=jdbc:mysql://127.0.0.1:3306/ssm?serverTimezone=UTC
    jdbc.username=root
    jdbc.password=root

--------------------

#### 7. 获取参数 ####

> **Mybatis映射文件 Sql语句获取参数到SQL语句的情况：**
> 
>  *  1.单个字面量类型（基本数据类型）
>  *  2.多个字面量类型（基本数据类型）
>  *  3.Map
>  *  4.单个POJO（最常用）
>  *  5.@Param （最常用的方式）
>  *  6.List<泛型>

**（1）UserMapper接口类**

> **文件位置**：src/main/java/com/atguigu/mybatis/mapper/UserMapper.java

package com.atguigu.mybatis.mapper;
    
    import com.atguigu.mybatis.pojo.User;
    import org.apache.ibatis.annotations.Param;
    
    import java.util.Map;
    
    /**
     * Mybatis获取参数值的两种方式：#{}和${}
     * #{}的本质是占位符赋值；（较为多的使用）
     * ${}的本质是字符串拼接；
     * 1、若mapper接口方法的参数为单个的字面量类型，此时可以通过#{}或${}以任意内容获取参数值，但是一定要注意${}的单引号问题。
     * 2、若mapper接口方法的参数是多个的字面临类型，此时Mybatis会将参数放入map集合中，以两种方式存储数据：
     *  （1）以arg0、arg1....为键，以参数为值；
     *  （2）以param1、param2....为键，以参数为值；
     *  因此，我们只需要通过#{}和${}访问map集合的键，就可以拿到参数值。
     * 3、若mapper接口方法的参数为一个map集合类型的参数，此时我们只需要通过#{}和${}访问map集合的键，就可以拿到相对应参数值。
     * 4、若mapper接口方法的参数为实体类类型的参数，此时我们只需要通过#{}和${}访问实体类中属性名，就可以拿到相对应的参数值。
     * 5、可以在mapper接口方法的参数上设置@Param注解，此时mybatis会将这些参数放在map中，以两种方式来进行存储：
     *  （1）以@Param注解的value属性值为键，以参数为值；
     *  （2）以param1、param2....为键，以参数为值；
     */
    public interface UserMapper {
        
        /**
         * 根据用户名查询用户信息
         * @param username
         * @return
         */
        User getUserByUsername(String username);
    
        /**
         * 验证登录
         * @param username
         * @param password
         * @return
         */
        User checkLogin(String username,String password);
    
        /**
         * {username: "xxxx"}
         * {password: "xxxx"}
         * @param map
         * @return
         */
        User cheLoginByMap(Map<String,Object> map);
    
        /**
         * 添加用户信息的功能
         * @param user
         */
        void insertUser(User user);
    
        /**
         * 验证登录功能（使用@Param注解方式）
         * @param username
         * @param password
         * @return
         */
        User checkLoginByParam(@Param("username") String username, @Param("password") String password);
    }

**（2）UserMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/UserMapper.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">
    
    
    <mapper namespace="com.atguigu.mybatis.mapper.UserMapper">
        
        
        
        <select id="getUserByUsername" resultType="User">
            select * from  t_user where username=#{username}
        </select>
        
        <select id="getUserByUsername" resultType="User">
            select * from t_user where username = '${username}'
        </select>
    
        
        
        <select id="checkLogin" resultType="User">
            select * from t_user where username=#{param1} and password=#{param2}
        </select>
    
        
        
        <select id="cheLoginByMap" resultType="User">
            select * from t_user where username=#{username} and password=#{password}
        </select>
        
        
        
        <insert id="insertUser">
            insert into t_user values(null,#{username},#{password},#{age},#{gender},#{email})
        </insert>
        
        
        
        <select id="checkLoginByParam" resultType="User">
            select * from t_user where username=#{username} and password=#{password}
        </select>
    </mapper>

--------------------

#### 8. 查询功能详解 ####

> **查询功能**：
> 
>  *  1.  返回结果是一个实体类
>  *  1.  返回结果是一个List集合
>  *  1.  返回结果是一个单行单列的数据
>  *  1.  返回结果是一个Map集合
>  *  1.  返回结果是一个map的list集合

**（1）SelectMapper.java接口类**

> **文件位置**：src/main/java/com/atguigu/mybatis/mapper/SelectMapper.java

package com.atguigu.mybatis.mapper;
    
    import com.atguigu.mybatis.pojo.User;
    import org.apache.ibatis.annotations.MapKey;
    import org.apache.ibatis.annotations.Param;
    
    import java.util.List;
    import java.util.Map;
    
    public interface SelectMapper {
        
        /**
         * 1、若SQL语句查询的结果为多条时，一定不能以实体类类型为返回值，否则会抛出异常（TooManyResultException）；
         * 2、若SQL语句查询的结果为一条时，此时可以使用实体类类型或List集合类型来作为方法的返回值；
         */
    
        /**
         * 根据id来查询用户信息
         * @param id
         * @return
         */
        User getUserById(@Param("id") Integer id);
    
        /**
         * 获取所有的用户信息
         * @return
         */
        List<User> getAllUser();
    
        /**
         * 查询用户的总数量
         * @return
         */
        Integer getCount();
    
        /**
         * 根据用户id查询用户信息为一个map集合
         * @param id
         * @return
         */
        Map<String,Object> getUserByIdToMap(@Param("id") Integer id);
    
        /**
         * 获取所有用户信息到一个map集合
         * 若查询的数据有多条时，并且要将每条数据转换为map集合，此时有两种解决方案：
         *  1、将mapper接口方法的返回值设置为泛型是map的List集合；
         * 		List<Map<String,Object>> getAllUserToMap();
         *  2、将每条数据转换的map集合放到一个大的map集合中，但是必须通过@MapKey注解，将查询的某个字段的值作为这个大的map的键
         *  	(id作为键，小map作为值）
         *  	{
         *      	2={password=123456, gender=男, id=2, age=23, email=12345@qq.com, username=admin},
         *      	3={password=123, gender=男, id=3, age=23, email=12345@qq.com, username=root},
         *      	5={password=123456, gender=男, id=5, age=23, email=12345@qq.com, username=admin}
         *  	}
         * @return
         */
        //List<Map<String,Object>> getAllUserToMap();
        @MapKey("id")
        Map<String,Object> getAllUserToMap();
    }

**（2）SelectMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/SelectMapper.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">
    
    
    <mapper namespace="com.atguigu.mybatis.mapper.SelectMapper">
        
        <select id="getUserById" resultType="User">
            select * from t_user where id=#{id}
        </select>
    
        
        <select id="getAllUser" resultType="User">
            select * from t_user
        </select>
    
        
        
        <select id="getCount" resultType="Integer">
            select count(*) from t_user
        </select>
    
        
        <select id="getUserByIdToMap" resultType="map">
            select * from t_user where id=#{id}
        </select>
        
        
        <select id="getAllUserToMap" resultType="map">
            select * from t_user
        </select>
    </mapper>

--------------------

#### 9. 特殊SQL ####

> **特殊的SQL语句：**
> 
>  *  1.  模糊查询
>  *  1.  批量删除
>  *  1.  动态设置表名
>  *  1.  添加信息并获取自增的主键

**(1)SpecialSQLMapper.java接口类**

> **文件位置**：src/main/java/com/atguigu/mybatis/mapper/SpecialSQLMapper.java

package com.atguigu.mybatis.mapper;
    
    import com.atguigu.mybatis.pojo.User;
    import org.apache.ibatis.annotations.Param;
    
    import java.util.List;
    
    public interface SpecialSQLMapper {
        
        /**
         * 通过用户名模糊查询用户信息
         * @param mohu
         * @return
         */
        List<User> getUserByLike(@Param("mohu") String mohu);
    
        /**
         * 批量删除
         * @param ids
         */
        void deleteMoreUser(@Param("ids") String ids);
    
        /**
         * 动态设置表名
         * @param tableName
         * @return
         */
        List<User> getUserList(@Param("tableName") String tableName);
    
        /**
         * 添加用户信息并获取自增的主键
         * @param user
         * @return
         */
        Integer insertUser(User user);
    }

**（2）SpecialSQLMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/SpecialSQLMapper.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">
    
    
    <mapper namespace="com.atguigu.mybatis.mapper.SpecialSQLMapper">
        
        
        <select id="getUserByLike" resultType="User">
            select * from t_user where username like '%${mohu}%'
        </select>
        
        <select id="getUserByLike" resultType="user">
            SELECT * FROM t_user WHERE username like CONCAT('%', #{mohu}, '%');
        </select>
        
        <select id="getUserByLike" resultType="user">
            SELECT * FROM t_user WHERE username like "%"#{mohu}"%"
        </select>
    
        
        <delete id="deleteMoreUser">
            delete from t_user where id in (${ids})
        </delete>
    
        
        <select id="getUserList" resultType="User">
            select * from ${tableName}
        </select>
    
        
        
        <insert id="insertUser" useGeneratedKeys="true" keyProperty="id">
            insert into t_user values (null,#{username},#{password},#{age},#{gender},#{email})
        </insert>
    </mapper>

--------------------

#### 10. ResultMap ####

##### 10.1 字段名和属性名不一致的情况 #####

> **属性名和数据库字段名不一致的查询的三种方式：**
> 
>  *  为查询的字段设置别名，和属性名保持一致；
>  *  当字段符合MySQL的要求使用\_，而属性符合java的要求使用驼峰。此时可以在mybatis的核心配置文件中设置一个全局配置，可以自动的将下划线映射为驼峰；
>  *  使用resultMap自定义映射处理；

###### 10.1.1 **方式一：** 使用别名 ######

> 通过SQL语句起别名的方式解决数据库的字段和实体类的属性名称不一致的问题。

**EmpMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/EmpMapper.xml

<select id="getEmpByEmpId" resultType="Emp">
            select emp_id empId,emp_name empName,age,gender from t_emp where emp_id=#{empId}
        </select>

###### 10.1.2 **方式二：** 在核心配置文件中添加settings配置将下滑线映射为驼峰 ######

> 在核心配置文件配置typeAliases标签以后，就可以直接在映射文件中自动映射。

**（1）Mybatis核心配置文件mybatis-config.xml**

> **文件位置**：src/main/resources/mybatis-config.xml

<typeAliases>
            
            <package name="com.atguigu.mybatis.pojo"/>
        </typeAliases>

**（2）EmpMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/EmpMapper.xml

<select id="getEmpByEmpId" resultType="Emp">
            select * from t_emp where emp_id = #{empId}
        </select>

###### 10.1.3 **方式三：** 自定义映射 ######

> 使用 ResltMap , 注意 resultMap 和 resultType 是二选一的。

<resultMap id="empResultMap" type="Emp">
            
            <id column="emp_id" property="empId"></id>
            <result column="emp_name" property="empName"></result>
            <result column="age" property="age"></result>
            <result column="gender" property="gender"></result>
        </resultMap>
        <select id="getEmpByEmpId" resultMap="empResultMap">
            select * from t_emp where emp_id = #{empId}
        </select>

##### 10.2 多对一关系 #####

> **POJO**：多个emp对应一个Dept，多个成员对应一个部门。

**Emp实体类**

public class Emp {
        
        private Integer empId;
        private String empName;
        private Integer age;
        private String gender;
        //多对一关系，对应的是一个对象
        private Dept dept;
    }

> **处理多对一的映射关系：**
> 
>  *  级联方式
>  *  association标签：专门用来处理多对一的映射关系（处理实体类类型的属性）
>  *  分步骤查询方式

###### 10.2.1 级联方式 ######

**EmpMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/EmpMapper.xml

<resultMap id="empAndDeptResultMapOne" type="Emp">
            <id column="emp_id" property="empId"></id>
            <result column="emp_name" property="empName"></result>
            <result column="age" property="age"></result>
            <result column="gender" property="gender"></result>
            <result column="dept_id" property="dept.deptId"></result>
            <result column="dept_name" property="dept.deptName"></result>
        </resultMap>
      	
        <select id="getEmpAndDeptByEmpId" resultMap="empAndDeptResultMapOne">
            select t_emp.*,t_dept.* from t_emp left join t_dept on t_emp.dept_id = t_dept.dept_id where t_emp.emp_id = #{empId}
        </select>

###### 10.2.2 association标签 ######

**EmpMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/EmpMapper.xml

<resultMap id="empAndDeptResultMapTwo" type="Emp">
            <id column="emp_id" property="empId"></id>
            <result column="emp_name" property="empName"></result>
            <result column="age" property="age"></result>
            <result column="gender" property="gender"></result>
            
            <association property="dept" javaType="Dept">
                <id column="dept_id" property="deptId"></id>
                <result column="dept_name" property="deptName"></result>
            </association>
        </resultMap>
        
        
        <select id="getEmpAndDeptByEmpId" resultMap="empAndDeptResultMapTwo">
            select t_emp.*,t_dept.* from t_emp left join t_dept on t_emp.dept_id = t_dept.dept_id where t_emp.emp_id = #{empId}
        </select>

###### 10.2.3 分步骤查询方式 ######

> 分布查询需要两个接口方法，然后再各自的映射文件中填写SQL语句，两条语句使用association标签中的select和column连接在一起。

**（1）EmpMapper.java接口类**

> **文件位置**：src/main/java/com/atguigu/mybatis/mapper/EmpMapper.java

/**
         * 通过分步骤查询获取员工及员工部门信息的第一步
         * @param empId
         * @return
         */
        Emp getEmpAndDeptByStep(@Param("empId") Integer empId);

**（2）DeptMapper.java接口类**

> **文件位置**：src/main/java/com/atguigu/mybatis/mapper/DeptMapper.java

/**
         * 通过分步骤查询获取员工及员工部门信息的第二步
         * @return
         */
        Dept getEmpAndDeptByStepTwo(@Param("deptId") Integer deptId);

**（3）EmpMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/EmpMapper.xml

<resultMap id="empAndDeptByStepResultMap" type="Emp">
            <id column="emp_id" property="empId"></id>
            <result column="emp_name" property="empName"></result>
            <result column="age" property="age"></result>
            <result column="gender" property="gender"></result>
            
            <association property="dept" fetchType="eager" select="com.atguigu.mybatis.mapper.DeptMapper.getEmpAndDeptByStepTwo" column="dept_id"></association>
        </resultMap>
        
        
        <select id="getEmpAndDeptByStep" resultMap="empAndDeptByStepResultMap">
            select * from t_emp where emp_id = #{empId}
        </select>

**（3）DeptMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/DeptMapper.xml

<select id="getEmpAndDeptByStepTwo" resultType="Dept">
            select * from t_dept where dept_id = #{deptId}
        </select>

##### 10.3 一对多关系 #####

> **POJO**：一个 Dept 对应多个 Emp。一个部门对应多个成员。

**Dept 实体类**

public class Dept {
        
        private Integer deptId;
        private String deptName;
        //一对多，对应的是一个集合
        private List<Emp> emps;
    }

> **处理一对多的映射关系：**
> 
>  *  collection
>  *  分步骤查询

###### 10.3.1 collection ######

**（1）DeptMapper.java接口类**

> **文件位置**：src/main/java/com/atguigu/mybatis/mapper/DeptMapper.java

/**
         * 查询部门以及部门中的员工信息
         * @param deptId
         * @return
         */
        Dept getDeptAndEmpByDeptId(@Param("deptId") Integer deptId);

**（2）DeptMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/DeptMapper.xml

<resultMap id="deptAndEmpResultMap" type="Dept">
            <id column="dept_id" property="deptId"></id>
            <result column="dept_name" property="deptName"></result>
            
            <collection property="emps" ofType="Emp">
                <id column="emp_id" property="empId"></id>
                <result column="emp_name" property="empName"></result>
                <result column="age" property="age"></result>
                <result column="gender" property="gender"></result>
            </collection>
        </resultMap>
        
        
        <select id="getDeptAndEmpByDeptId" resultMap="deptAndEmpResultMap">
            select t_dept.*,t_emp.* from t_dept left join t_emp on t_dept.dept_id = t_emp.dept_id where t_dept.dept_id = #{deptId}
        </select>

###### 10.3.2 分步骤查询 ######

**（1）DeptMapper.java接口类**

> **文件位置**：src/main/java/com/atguigu/mybatis/mapper/DeptMapper.java

/**
         * 分步骤查询-查询部门以及部门中的员工信息-第一步
         * @param deptId
         * @return
         */
        Dept getDeptAndEmpByStepOne(@Param("deptId") Integer deptId);

**（2）EmpMapper.java接口类**

> **文件位置**：src/main/java/com/atguigu/mybatis/mapper/EmpMapper.java

/**
         * 分步骤查询-查询部门以及部门中的员工信息-第二步
         * @param deptId
         * @return
         */
        List<Emp> getDeptAndEmpByStepTwo(@Param("deptId") Integer deptId);

**（3）DeptMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/DeptMapper.xml

<resultMap id="deptAndEmpByStepResultMapOne" type="Dept">
            <id column="dept_id" property="deptId"></id>
            <result column="dept_name" property="deptName"></result>
            <collection property="emps" fetchType="eager" select="com.atguigu.mybatis.mapper.EmpMapper.getDeptAndEmpByStepTwo" column="dept_id"></collection>
        </resultMap>
        
        <select id="getDeptAndEmpByStepOne" resultMap="deptAndEmpByStepResultMapOne">
            select * from t_dept where dept_id = #{deptId}
        </select>

**（4）EmpMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/EmpMapper.xml

<select id="getDeptAndEmpByStepTwo" resultType="Emp">
            select * from t_emp where dept_id = #{deptId}
        </select>

--------------------

#### 11. 动态SQL ####

##### 11.1 if标签 #####

**（1）DynamicSQLMapper.java接口类**

> **文件位置**：src/main/java/com/atguigu/mybatis/mapper/DynamicSQLMapper.java

/**
         * 根据条件查询员工信息
         * @param emp
         * @return
         */
        List<Emp> getEmpByCondition(Emp emp);

**（2）DynamicSQLMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/DynamicSQLMapper.xml

<select id="getEmpByCondition" resultType="Emp">
            select * from t_emp where 1=1
                <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>
        </select>

##### 11.2 where标签 #####

> 使用where标签与if标签结合的方式

**DynamicSQLMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/DynamicSQLMapper.xml

<select id="getEmpByConditionTwo" 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>

##### 11.3 trim标签 #####

> 当and写到后面的时候，where标签将不能够自动去掉and关键字；  
> 这时候，我们可以使用trim标签实现去掉多的，加上少的。

**DynamicSQLMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/DynamicSQLMapper.xml

<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>

##### 11.4 choose、when、otherwise标签 #####

> 判断单一条件，只选择一个进行判断，如果有一个when满足了条件，则不进行后面的判断了。

**DynamicSQLMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/DynamicSQLMapper.xml

<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>

##### 11.5 foreach标签 #####

###### 11.5.1 批量添加 ######

**DynamicSQLMapper.java**

> **文件位置**：src/main/java/com/atguigu/mybatis/mapper/DynamicSQLMapper.java

/**
         * 批量添加员工信息
         * @param emps
         */
        void insertMoreEmp(@Param("emps") List<Emp> emps);

**DynamicSQLMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/DynamicSQLMapper.xml

<insert id="insertMoreEmp">
            insert into t_emp values
                <foreach collection="emps" item="emp" separator=",">
                    (null,#{emp.empName},#{emp.age},#{emp.gender},null)
                </foreach>
        </insert>

###### 11.5.2 批量删除 ######

**DynamicSQLMapper.java**

> **文件位置**：src/main/java/com/atguigu/mybatis/mapper/DynamicSQLMapper.java

/**
         * 批量删除员工信息
         * @param empIds
         */
        void deleteMoreEmp(@Param("empIds") Integer[] empIds);

**DynamicSQLMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/DynamicSQLMapper.xml

<delete id="deleteMoreEmpOne">
            delete from t_emp where emp_id in (
                <foreach collection="empIds" item="empId" separator=",">
                    #{empId}
                </foreach>
            )
        </delete>
        
        <delete id="deleteMoreEmpTwo">
            delete from t_emp where emp_id in
                <foreach collection="empIds" item="empId" separator="," open="(" close=")">
                    #{empId}
                </foreach>
        </delete>
        
        <delete id="deleteMoreEmp">
            delete from t_emp where
                <foreach collection="empIds" item="empId" separator="or">
                    emp_id = #{empId}
                </foreach>
        </delete>

##### 11.6 SQL片段 #####

> 声明一段sql语句片段，然后在其他地方的sql语句中引用使用。

**DynamicSQLMapper.xml**

> **文件位置**：src/main/resources/com/atguigu/mybatis/mapper/DynamicSQLMapper.xml

<sql id="empColumns">
            emp_id,emp_name,age,gender,dept_id
        </sql>
    
        <select id="getEmpByCondition" resultType="Emp">
            select <include refid="empColumns"></include> 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>

--------------------

#### 12. Mybatis的缓存 ####

##### 12.1 Mybatis的一级缓存 #####

/**
         * mybatis的一级缓存：
         * mybatis的一级缓存是SqlSession级别的，即通过同一个SqlSession来查询同一条数据会被缓存
         * 再次使用同一条SqlSession查询同一条数据，会从缓存获取。
         * mybatis的一级缓存是默认自动开启的。
         */

![mybatis的一级缓存][mybatis]

>  *  **以下四种情况会导致一级缓存失效**：
>     
>     1.  不同SqlSession对应不同的一级缓存。（即不同SqlSession，即使是相同查询条件也无用）。
>     2.  同一个SqlSession但是查询条件不同。
>     3.  同一个SqlSession 两次查询期间执行了任何一次针对此表增删改操作。
>     4.  同一个SqlSession两次查询期间手动清空了缓存。

##### 12.2 Mybatis的二级缓存 #####

/**
         * mybatis的二级缓存：
         * mybatis的二级缓存是SqlSessionFactory级别的，即通过同一个SqlSessionFactory所获取的SqlSessionFactory对象，
         * 查询的数据会被缓存，在通过同一个SqlSessionFactory所获取的SqlSession查询相同一个数据会从缓存中获取。
         * @throws IOException
         */

###### 12.2.1 Mybatis的二级缓存开启的四个条件 ######

**1.核心配置文件中设置**

> 核心配置文件中默认cacheEnabled的属性值是true，所以即使不设置也是可以的。

**2.映射文件中设置`<cache/>`标签**

**3.二级缓存必须是在 SQLSession 关闭或提交之后有效。（即SQLSession关闭或提交后，一级缓存当中的数据才会保存到一级缓存中）**

@Test
        public void testCache() throws IOException {
        
            InputStream resourceAsStream = Resources.getResourceAsStream("mybatis-config.xml");
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
            SqlSession sqlSession = sqlSessionFactory.openSession(true);
            CacheMapper mapper = sqlSession.getMapper(CacheMapper.class);
            Emp empById = mapper.getEmpById(1);
            System.out.println(empById);
            //关闭sqlSession
            sqlSession.close();
    
            SqlSession sqlSession1 = sqlSessionFactory.openSession(true);
            CacheMapper mapper1 = sqlSession1.getMapper(CacheMapper.class);
            Emp empById1 = mapper1.getEmpById(1);
            System.out.println(empById1);
            //关闭sqlSession1
            sqlSession1.close();
        }

**4. 实体类必须实现 Serializable 接口。**

public class Emp implements Serializable {
        
        private Integer empId;
        private String empName;
        private Integer age;
        private String gender;

![在这里插入图片描述][6388eeb6c20543fbb055577981f53ecc.png]

###### 12.2.2 mybatis的二级缓存失效 ######

> 任意一次增删该就会清空mybatis的二级缓存（唯一 一种情况）

###### 12.2.3 Mybatis的二级缓存的相关配置![在这里插入图片描述][01341d87cee44bac82d00fd4a72e308d.png] ######

##### 12.3 Mybatis缓存查询的顺序 #####

> 1.  先查询二级缓存，因为二级缓存当中可能会有其他线程已经查询出来的数据。
> 2.  二级缓存没有命中，则再查询一级缓存。
> 3.  一级缓存也没有命中，则执行查询数据库。
> 4.  SQLSession关闭之后，一级缓存当中的数据会写入到二级缓存。

##### 12.4 整合第三方缓存EHCache #####

**1.添加依赖**

<dependency>
                <groupId>org.mybatis.caches</groupId>
                <artifactId>mybatis-ehcache</artifactId>
                <version>1.2.1</version>
            </dependency>
            
            <dependency>
                <groupId>ch.qos.logback</groupId>
                <artifactId>logback-classic</artifactId>
                <version>1.2.3</version>
            </dependency>

**2.各种jar包功能**  
![在这里插入图片描述][fe2a0bf9db4b4623b8ce24fed31047fc.png]

**3.创建EHCache的配置文件ehcache.xml**

> **文件命名**：ehcache.xml 强制要求  
> **文件路径**：src/main/resources/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:\atguigu\ehcache"/>
        <defaultCache
                maxElementsInMemory="1000"
                maxElementsOnDisk="10000000"
                eternal="false"
                overflowToDisk="true"
                timeToIdleSeconds="120"
                timeToLiveSeconds="120"
                diskExpiryThreadIntervalSeconds="120"
                memoryStoreEvictionPolicy="LRU">
        </defaultCache>
    </ehcache>

**4.设置二级缓存的类型**

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

**5.加入logback日志**

> **文件命名**：logback.xml 强制要求  
> **文件路径**：src/main/resources/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>
        
        
        <root level="DEBUG">
            
            <appender-ref ref="STDOUT" />
        </root>
        
        <logger name="com.atguigu.mybatis.mapper" level="DEBUG"/>
    </configuration>

**6.EHCache配置文件说明**

--------------------

#### 13. Mybatis的逆向工程 ####

>  *  **正向工程**：先创建Java实体类，由框架负责根据实体类生成数据库表。 Hibernate是支持正向工 程的。
>  *  **逆向工程**：先创建数据库表，由框架负责根据数据库表，反向生成如下资源：
>     
>      *  Java实体类
>      *  Mapper接口
>      *  Mapper映射文件

**1.添加插件和依赖**

> 在pom.xml中添加插件和依赖

**pom.xml**

<?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
    
        <groupId>com.atguigu.mybatis</groupId>
        <artifactId>mybatis_mbg</artifactId>
        <version>1.0-SNAPSHOT</version>
        <packaging>jar</packaging>
    
        
        <dependencies>
            <dependency>
                <groupId>org.mybatis</groupId>
                <artifactId>mybatis</artifactId>
                <version>3.5.7</version>
            </dependency>
            
            <dependency>
                <groupId>junit</groupId>
                <artifactId>junit</artifactId>
                <version>4.12</version>
                <scope>test</scope>
            </dependency>
            
            <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>
        
        <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>
                        
                        <dependency>
                            <groupId>mysql</groupId>
                            <artifactId>mysql-connector-java</artifactId>
                            <version>8.0.16</version>
                        </dependency>
                    </dependencies>
                </plugin>
            </plugins>
        </build>
        <properties>
            <maven.compiler.source>19</maven.compiler.source>
            <maven.compiler.target>19</maven.compiler.target>
            <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        </properties>
    </project>

**2.创建MyBatis的核心配置文件**  
**mybatis-config.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"></properties>
    
        <settings>
            
            <setting name="mapUnderscoreToCamelCase" value="true"/>
            
            <setting name="lazyLoadingEnabled" value="true"/>
            
            <setting name="aggressiveLazyLoading" value="false"/>
        </settings>
    
        
        <typeAliases>
            
            <package name="com.atguigu.mybatis.pojo"/>
        </typeAliases>
    
        
        <environments default="development">
            <environment id="development">
                <transactionManager type="JDBC"></transactionManager>
                <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>
        </environments>
    
        
        <mappers>
            
            <package name="com.atguigu.mybatis.mapper"/>
        </mappers>
    </configuration>

**3.创建逆向工程的配置文件**

> **文件命名**：generatorConfig.xml 强制性命名  
> **文件路径**：src/main/resources/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>
        
        <context id="DB2Tables" targetRuntime="MyBatis3">
            
            <jdbcConnection driverClass="com.mysql.cj.jdbc.Driver"
                            connectionURL="jdbc:mysql://localhost:3306/ssm?serverTimezone=UTC"
                            userId="root"
                            password="root">
            </jdbcConnection>
            
            <javaModelGenerator targetPackage="com.atguigu.mybatis.pojo"
                                targetProject=".\src\main\java">
                <property name="enableSubPackages" value="true" />
                <property name="trimStrings" value="true" />
            </javaModelGenerator>
            
            <sqlMapGenerator targetPackage="com.atguigu.mybatis.mapper"
                             targetProject=".\src\main\resources">
                <property name="enableSubPackages" value="true" />
            </sqlMapGenerator>
            
            <javaClientGenerator type="XMLMAPPER"
                                 targetPackage="com.atguigu.mybatis.mapper"
                                 targetProject=".\src\main\java">
                <property name="enableSubPackages" value="true" />
            </javaClientGenerator>
            
            
            
            <table tableName="t_emp" domainObjectName="Emp"/>
            <table tableName="t_dept" domainObjectName="Dept"/>
        </context>
    </generatorConfiguration>

**4.执行MBG插件的generate目标**

![在这里插入图片描述][6c30692fa21f43b78ac5917c8b637889.png]

--------------------

#### 14. 分页插件 ####

##### 14.1 分页插件的使用步骤 #####

**1.添加依赖**  
**pom.xml**

<dependency>
                <groupId>com.github.pagehelper</groupId>
                <artifactId>pagehelper</artifactId>
                <version>5.2.0</version>
            </dependency>

**2.核心配置文件（mybatis-config.xml）中配置分页插件**

> **文件位置**：src/main/resources/mybatis-config.xml

**3.效果**  
![在这里插入图片描述][b98964dfa8994101885424f36c181f20.png]

[mybatis]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/95cf8975bed540a2a7d0931a6b39cf18.png
[6388eeb6c20543fbb055577981f53ecc.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/74c74d8a8c224116b7151877afe1d40f.png
[01341d87cee44bac82d00fd4a72e308d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/ab81c4e4dc2d4bdaa36e9b95778acfed.png
[fe2a0bf9db4b4623b8ce24fed31047fc.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/a491857e01444726b67be1490bedc312.png
[6c30692fa21f43b78ac5917c8b637889.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/162ef996a73d43359bcd695cbc3718ff.png
[b98964dfa8994101885424f36c181f20.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/31/639b431c01a04e8ca003efb0d0c399ec.png