MyBatis入门

一、Mybatis简介

1、MyBatis历史

• MyBatis最初是Apache的一个开源项目iBatis, 2010年6月这个项目由Apache Software Foundation迁移到了Google Code。随着开发团队转投Google Code旗下，iBatis3.x正式更名为MyBatis。代码于2013年11月迁移到Github
• iBatis一词来源于“internet”和“abatis”的组合，是一个基于Java的持久层框架。iBatis提供的持久层框架包括SQL Maps和Data Access Objects（DAO）

2、MyBatis特性

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

3、MyBatis下载

• MyBatis下载地址
  

4、和其它持久化层技术对比

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

二、搭建MyBatis

1、开发环境

• IDE：idea 2019.2
• 构建工具：maven 3.5.4
• MySQL版本：MySQL 5.7
• MyBatis版本：MyBatis 3.5.7

2、创建maven工程

• 打包方式：jar
• 引入依赖

<packaging>jar</packaging>

<dependencies>
    <!--lombok-->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.18.10</version>
        <scope>provided</scope>
    </dependency>
    <!--mybatis核心-->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.4.5</version>
    </dependency>
    <!--mysql驱动-->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.6</version>
        <scope>runtime</scope>
    </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.12</version>
    </dependency>
</dependencies>

3、创建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"
        "https://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <!--
        MyBatis核心配置文件中，标签的顺序：
        properties?,settings?,typeAliases?,typeHandlers?,
        objectFactory?,objectWrapperFactory?,reflectorFactory?,
        plugins?,environments?,databaseIdProvider?,mappers?
    -->

    <!--引用外部的properties属性文件-->
    <properties resource="jdbcConfig.properties"/>

    <!--给实体类起别名-->
    <typeAliases>
        <!--
            typeAlias：设置某个类型的别名
            属性：
                type：设置需要设置别名的类型
                alias：设置某个类型的别名
                设置alias 别名固定
                不设置alias 别名就是类名且不区分大小写
            <typeAlias type="com.edu.pojo.User" alias="User"/>
        -->
        <!--
            以包为单位，将包下所有的类型设置默认的类型别名
            即类名且不区分大小写
            例如：USER User user UsEr
        -->
        <package name="com.edu.pojo"/>
    </typeAliases>

    <!--
        environments：配置多个连接数据库的环境
        属性：
            default：设置默认使用的环境的id
    -->
    <environments default="mybatis_mysql">
        <!--
            environment：配置某个具体的环境
            属性：
                id：表示连接数据库的环境的唯一标识，不能重复
        -->
        <environment id="mybatis_mysql">
            <!--
                transactionManager：设置事务管理方式
                属性：
                    type="JDBC|MANAGED"
                    JDBC：表示当前环境中，执行SQL时，使用的是JDBC中原生的事务管理方式，事物的提交或回滚需要手动处理
                    MANAGED：表示被管理，例如Spring
            -->
            <transactionManager type="JDBC"/>
            <!--
                dataSource：配置数据源
                属性：
                    type：设置数据源的类型
                    type="POOLED|UNPOOLED|JNDI"
                    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>
    </environments>

    <!--关联接口对应的那个映射文件-->
    <mappers>
        <!--
            <mapper resource="com/edu/mapper/UserMapper.xml"/>
        -->
        <!--
            以包为单位引入映射文件
            要求：
            1.mapper接口所在的包要和映射文件所在的包一致
            2.mapper接口要和映射文件的名字一致
        -->
        <package name="com.edu.mapper"/>
    </mappers>
</configuration>

4、创建mapper接口

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

public interface UserMapper {  
	/**  
	* 添加用户信息  
	*/  
	int insertUser();  
}

5、创建MyBatis的映射文件

• 相关概念：ORM（Object Relationship Mapping）对象关系映射。
• 对象：Java的实体类对象
  • 关系：关系型数据库
  • 映射：二者之间的对应关系

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

• 映射文件的命名规则
• 表所对应的实体类的类名+Mapper.xml
  • 例如：表t_user，映射的实体类为User，所对应的映射文件为UserMapper.xml
  • 因此一个映射文件对应一个实体类，对应一张表的操作
  • MyBatis映射文件用于编写SQL，访问以及操作表中的数据
  • MyBatis映射文件存放的位置是src/main/resources/mappers目录下
• MyBatis中可以面向接口操作数据，要保证两个一致
• mapper接口的全类名和映射文件的命名空间（namespace）保持一致
  • mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--
    MyBatis面向接口编程的两个一致
    1.映射文件的namespace要和mapper接口的全类名保持一致
    2.映射文件中SQL语句的id要和mapper接口中的方法名保持一致
    表==实体类==mapper接口==映射文件
-->
<mapper namespace="com.edu.mapper.ParameterMapper">
    <!--int insertUser();-->
    <insert id="insertUser">
        insert into t_user(username,password,age,sex,email)
        values('jack','123456',23,'男','123456@qq.com')
    </insert>
</mapper>

6、通过junit测试功能

• SqlSession：代表Java程序和数据库之间的会话。（HttpSession是Java程序和浏览器之间的会话）
• SqlSessionFactory：是“生产”SqlSession的“工厂”
• 工厂模式：如果创建某一个对象，使用的过程基本固定，那么我们就可以把创建这个对象的相关代码封装到一个“工厂类”中，以后都使用这个工厂类来“生产”我们需要的对象

public class UserMapperTest {
    @Test
    public void testInsert() throws IOException {
        //加载MyBatis核心配置文件
        InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
        //构建工厂
        SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);
        //打开SqlSession
        /*
            SqlSession默认不自动提交事务
            若需要自动提交事务
            factory.openSession(true)
        */
        SqlSession sqlSession = factory.openSession();

        //获取接口的代理对象
        //获取mapper接口对象
        //通过JDK动态代理，在运行期生成 UserMapper 接口的代理对象
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        //测试功能
        int i = mapper.insertUser();
        //增删改，需要我们手动提交事务
        sqlSession.commit();

        //释放资源
        sqlSession.close();
    }
}

• 此时需要手动提交事务，如果要自动提交事务，则在获取sqlSession对象时，使用SqlSession sqlSession = sqlSessionFactory.openSession(true);，传入一个Boolean类型的参数，值为true，这样就可以自动提交

7、加入log4j日志功能

1. 加入依赖

   <!--log4j日志-->
   <dependency>
       <groupId>log4j</groupId>
       <artifactId>log4j</artifactId>
       <version>1.2.12</version>
   </dependency>
   

2. 加入log4j的配置文件

   • log4j的配置文件名为log4j.xml，存放的位置是src/main/resources目录下
   • 日志的级别：FATAL(致命)>ERROR(错误)>WARN(警告)>INFO(信息)>DEBUG(调试) 从左到右打印的内容越来越详细

   以下二选一即可 log4j.xml或者log4j.properties

   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="%-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>
   

   log4j.properties

   # Set root category priority to INFO and its only appender to CONSOLE.
   #log4j.rootCategory=INFO, CONSOLE            debug   info   warn error fatal
   log4j.rootCategory=debug, CONSOLE, LOGFILE
   
   # Set the enterprise logger category to FATAL and its only appender to CONSOLE.
   log4j.logger.org.apache.axis.enterprise=FATAL, CONSOLE
   
   # CONSOLE is set to be a ConsoleAppender using a PatternLayout.
   log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
   log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
   log4j.appender.CONSOLE.layout.ConversionPattern=%d{ISO8601} %-6r [%15.15t] %-5p %30.30c %x - %m\n
   
   # LOGFILE is set to be a File appender using a PatternLayout.
   log4j.appender.LOGFILE=org.apache.log4j.FileAppender
   log4j.appender.LOGFILE.File=d:axis.log
   log4j.appender.LOGFILE.Append=true
   log4j.appender.LOGFILE.layout=org.apache.log4j.PatternLayout
   log4j.appender.LOGFILE.layout.ConversionPattern=%d{ISO8601} %-6r [%15.15t] %-5p %30.30c %x - %m\n
   

三、核心配置文件详解

核心配置文件中的标签必须按照固定的顺序(有的标签可以不写，但顺序一定不能乱)：
properties、settings、typeAliases、typeHandlers、objectFactory、objectWrapperFactory、reflectorFactory、plugins、environments、databaseIdProvider、mappers

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "https://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>

    <!--引用外部的properties属性文件-->
    <properties resource="jdbcConfig.properties"/>

    <!--设置MyBatis的全局配置-->
    <settings>
        <!--将下划线_自动映射为驼峰 emp_name:empName-->
        <setting name="mapUnderscoreToCamelCase" value="true"/>
        <!--开启延迟加载-->
        <setting name="lazyLoadingEnabled" value="true"/>
    </settings>

    <!--给实体类起别名-->
    <typeAliases>
        <package name="com.edu.pojo"/>
    </typeAliases>
    
    <plugins>
        <!--设置分页插件-->
        <plugin interceptor="com.github.pagehelper.PageInterceptor"></plugin>
    </plugins>

    <!--配置多个连接数据库的环境-->
    <environments default="mybatis_mysql">
        <!--配置某个具体的环境-->
        <environment id="mybatis_mysql">
            <!--设置事务管理方式-->
            <transactionManager type="JDBC"/>
            <!--配置数据源-->
            <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.edu.mapper"/>
    </mappers>

</configuration>

1、默认的类型别名

java.lang.Integer -> int|integer
int -> _int|_integer
Map -> map,List -> list

四、MyBatis的增删改查

1. 添加

   <!--int insertUser();-->
   <insert id="insertUser">
       insert into t_user(username,password,age,sex,email)
       values('jack','123456',23,'男','123456@qq.com')
   </insert>
   

2. 删除

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

3. 修改

   <!--void updateUser();-->
   <update id="updateUser">
       update t_user set username='张三' where id=3
   </update>
   

4. 查询一个实体类对象

   <!--User getUserById();-->
   <!--
       查询功能标签必须设置 resultType或resultMap
       resultType：设置默认的映射关系
       resultMap：设置自定义的映射关系
   -->
   <select id="getUserById" resultType="User">
       select * from t_user where id=3
   </select>
   

5. 查询集合

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

• 注意：

  1. 查询的标签select必须设置属性resultType或resultMap，用于设置实体类和数据库表的映射关系
     • resultType：自动映射，用于属性名和表中字段名一致的情况
     • resultMap：自定义映射，用于一对多或多对一或字段名和属性名不一致的情况
  2. 当查询的数据为多条时，不能使用实体类作为返回值，只能使用集合，否则会抛出异常TooManyResultsException；但是若查询的数据只有一条，可以使用实体类或集合作为返回值

五、MyBatis获取参数值的两种方式（重点）

• MyBatis获取参数值的两种方式：${}和#{}
• ${}的本质就是字符串拼接，#{}的本质就是占位符赋值
• ${}使用字符串拼接的方式拼接sql，若为字符串类型或日期类型的字段进行赋值时，需要手动加单引号；但是#{}使用占位符赋值的方式拼接sql，此时为字符串类型或日期类型的字段进行赋值时，可以自动添加单引号

1、单个字面量类型的参数

• 若mapper接口中的方法参数为单个的字面量类型，此时可以使用${}和#{}以任意的名称（最好见名识意）获取参数的值，注意${}需要手动加单引号

/**
* 根据用户名查询用户信息
*/
User getUserByUsername(String username);

<!--User getUserByUsername(String username);-->
<select id="getUserByUsername" resultType="User">
    select * from t_user where username = #{username}
</select>

<!--User getUserByUsername(String username);-->
<select id="getUserByUsername" resultType="User">
    select * from t_user where username = '${username}'
</select>

2、多个字面量类型的参数

• 若mapper接口中的方法参数为多个时，此时MyBatis会自动将这些参数放在一个map集合中

  1. 以arg0,arg1…为键，以参数为值；
  2. 以param1,param2…为键，以参数为值；

• 因此只需要通过${}和#{}访问map集合的键就可以获取相对应的值，注意${}需要手动加单引号。

• 使用arg或者param都行，要注意的是，arg是从arg0开始的，param是从param1开始的

/**
* 验证登录
*/
User checkLogin(String username, String password);

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

3、map集合类型的参数

• 若mapper接口中的方法需要的参数为多个时，此时可以手动创建map集合，将这些数据放在map中只需要通过${}和#{}访问map集合的键就可以获取相对应的值，注意${}需要手动加单引号

/**
* 验证登录（参数为map）
*/
User checkLoginByMap(Map<String, Object> map);

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

@Test
public void testCheckLoginByMap() {
    SqlSession sqlSession = SqlSessionUtils.getSqlSession();
    ParameterMapper mapper = sqlSession.getMapper(ParameterMapper.class);

    Map<String, Object> map = new HashMap<>();
    map.put("username", "jack");
    map.put("password", "123456");
    User user = mapper.checkLoginByMap(map);
    System.out.println(user);
}

4、实体类类型的参数

• 若mapper接口中的方法参数为实体类对象时此时可以使用${}和#{}，通过访问实体类对象中的属性名获取属性值，注意${}需要手动加单引号

/**
* 添加用户信息
*/
int insertUser(User user);

<!--int insertUser(User user);-->
<insert id="insertUser">
    insert into t_user values(null,#{username},#{password},#{age},#{sex},#{email})
</insert>

@Test
public void testinsertUser() {
    SqlSession sqlSession = SqlSessionUtils.getSqlSession();
    ParameterMapper mapper = sqlSession.getMapper(ParameterMapper.class);

    User user = new User();
    user.setUsername("smith");
    user.setPassword("123456");
    user.setAge(25);
    user.setSex("女");
    user.setEmail("654897@qq.com");
    int i = mapper.insertUser(user);
    System.out.println(i);
}

5、使用@Param标识参数

• 可以通过@Param注解标识mapper接口中的方法参数，此时，会将这些参数放在map集合中

  1. 以@Param注解的value属性值为键，以参数为值；
  2. 以param1,param2…为键，以参数为值；

• 只需要通过${}和#{}访问map集合的键就可以获取相对应的值，注意${}需要手动加单引号

/**
 * 验证登录（使用@Param）
 */
User checkLoginByParam(@Param("username") String username, @Param("password") String password);

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

@Test
public void testCheckLoginByParam() {
    SqlSession sqlSession = SqlSessionUtils.getSqlSession();
    ParameterMapper mapper = sqlSession.getMapper(ParameterMapper.class);
    User user = mapper.checkLoginByParam("jack", "123456");
    System.out.println(user);
}

6、总结

MyBatis获取参数值的两种方式：${}和#{}
    ${}：本质是字符串拼接
    #{}：本质是占位符赋值
    
MyBatis获取参数值的各种情况：
    1.mapper接口方法的参数为单个的字面量类型
    	可以通过${}和#{}以任意的名称获取参数值，但是需要注意${}的单引号问题
    2.mapper接口方法的参数为多个时
        此时MyBatis会将这些参数放在一个map集合中，以两种方式进行存储
        a>以arg0，arg1...为键，以参数为为值
        b>以param1，param2...为键，以参数为为值
        因此只需要通过#{}和${}以键的方式访问值即可，但是需要注意${}的单引号问题
    3.若mapper接口方法的参数有多个时，可以手动将这些参数放在一个map中存储
    	只需要通过#{}和${}以键的方式访问值即可，但是需要注意${}的单引号问题
    4.mapper接口方法的参数是一个实体类类型的参数
    	只需要通过#{}和${}以属性的方式访问属性值即可，但是需要注意${}的单引号问题
    5.使用@Param注解命名参数
        此时MyBatis会将这些参数放在一个map集合中，以两种方式进行存储
        a>以@Param注解的值为键，以参数为为值
        b>以param1，param2...为键，以参数为为值
        因此只需要通过#{}和${}以键的方式访问值即可，但是需要注意${}的单引号问题

六、MyBatis的各种查询功能

1. 如果查询出的数据只有一条，可以通过
   1. 实体类对象接收
   2. List集合接收
   3. Map集合接收，结果{password=123456, sex=男, id=1, age=23, username=admin}
2. 如果查询出的数据有多条，一定不能用实体类对象接收，会抛异常TooManyResultsException，可以通过
   1. 实体类类型的LIst集合接收
   2. Map类型的LIst集合接收
   3. 在mapper接口的方法上添加@MapKey注解

1、查询一个实体类对象

/**
 * 根据用户id查询用户信息
 */
User getUserById(@Param("id") int id);

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

2、查询一个List集合

/**
 * 查询所有用户信息
 */
List<User> getAllUser();

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

3、查询单个数据

/**
 * 查询用户信息的总记录数
 */
Integer getCount();

<!--Integer getCount();-->
<select id="getCount" resultType="java.lang.Integer">
    select count(*) from t_user
</select>

4、查询一条数据为map集合

/**  
 * 根据用户id查询用户信息为map集合  
 */  
Map<String, Object> getUserByIdToMap(@Param("id") Integer id);

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

5、查询多条数据为map集合

方法一

/**
 * 查询所有用户信息为map集合
 */
List<Map<String, Object>> getAllUserToMap();

<!--List<Map<String, Object>> getAllUserToMap();-->
<select id="getAllUserToMap" resultType="Map">
    select * from t_user
</select>
    
<!--
结果：
	[
    {password=123456, sex=男, id=4, age=23, email=123456@qq.com, username=tom}, 
    {password=123456, sex=女, id=7, age=25, email=654897@qq.com, username=smith}, 
    {password=123456, sex=男, id=9, age=23, email=654897@qq.com, username=jack}, 
    ]
-->    

方法二

/**
 * 查询所有用户信息为map集合
 * 将表中的数据以map集合的方式查询，一条数据对应一个map；若有多条数据，就会产生多个map集合，并且最终要以一个map的方式返回数据，此时需要通过@MapKey注解设置map集合的键，值是每条数据所对应的map集合
 */
@MapKey("id")
Map<String, Object> getAllUserToMap();

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

<!--
结果：
	{
    4={password=123456, sex=男, id=4, age=23, email=123456@qq.com, username=tom},
    7={password=123456, sex=女, id=7, age=25, email=654897@qq.com, username=smith},
    9={password=123456, sex=男, id=9, age=23, email=654897@qq.com, username=jack},
    }
-->

七、特殊SQL的执行

1、模糊查询

/**
 * 根据用户名模糊查询用户信息
 */
List<User> getUserByLike(@Param("username") String username);

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

• 其中select * from t_user where username like "%"#{mohu}"%"是最常用的

2、批量删除

• 只能使用${}，如果使用#{}，则解析后的sql语句为delete from t_user where id in ('1,2,3')，这样是将1,2,3看做是一个整体，只有id为1,2,3的数据会被删除。正确的语句应该是delete from t_user where id in (1,2,3)，或者delete from t_user where id in ('1','2','3')

/**
* 批量删除
*/
int deleteMore(@Param("ids") String ids);

<!--int deleteMore(@Param("ids") String ids);-->
<delete id="deleteMore">
    delete from t_user where id in(${ids})
</delete>

@Test
public void testDeleteMore() {
    SqlSession sqlSession = SqlSessionUtils.getSqlSession();
    SQLMapper mapper = sqlSession.getMapper(SQLMapper.class);
    mapper.deleteMore("7,8,9");
}

3、动态设置表名

• 只能使用${}，因为表名不能加单引号

/**
 * 查询指定表中的数据
 */
List<User> getUserByTableName(@Param("tableName") String tableName);

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

4、添加功能获取自增的主键

• 使用场景

• t_clazz(clazz_id,clazz_name)

  • t_student(student_id,student_name,clazz_id)
  1. 添加班级信息
  2. 获取新添加的班级的id
  3. 为班级分配学生，即将某学的班级id修改为新添加的班级的id

• 在mapper.xml中设置两个属性

• useGeneratedKeys：设置使用自增的主键

  • keyProperty：因为增删改有统一的返回值是受影响的行数，因此只能将获取的自增的主键放在传输的参数user对象的某个属性中

/**
 * 添加用户信息
 */
void insertUser(User user);

<!--
    void insertUser(User user);
    useGeneratedKeys：设置当前标签中的SQL使用了自增的主键
    keyProperty：将自增的主键的值赋值给传输到映射文件中参数的某个属性
-->
<insert id="insertUser" useGeneratedKeys="true" keyProperty="id">
    insert into t_user values (null,#{username},#{password},#{age},#{sex},#{email})
</insert>

@Test
public void testinsertUser() {
    SqlSession sqlSession = SqlSessionUtils.getSqlSession();
    SQLMapper mapper = sqlSession.getMapper(SQLMapper.class);

    User user = new User();
    user.setUsername("king");
    user.setPassword("123456");
    user.setAge(23);
    user.setSex("男");
    user.setEmail("654897@qq.com");
    mapper.insertUser(user);
    System.out.println(user);
}

八、自定义映射resultMap

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

resultMap：设置自定义映射关系
属性：
    id：唯一标识，不能重复
    type：设置映射关系中的实体类类型
子标签：
    id：设置主键的映射关系
    result：设置普通字段的映射关系
    属性：
    property：设置映射关系中的属性名，必须是type属性所设置的实体类类型中的属性名
    column：设置映射关系中的字段名，必须是SQL语句查询出的字段名

• 若字段名和实体类中的属性名不一致，则可以通过resultMap设置自定义映射，即使字段名和属性名一致的属性也要映射，也就是全部属性都要列出来

<resultMap id="empResultMap" type="Emp">
    <id property="eid" column="eid"/>
    <result property="empName" column="emp_name"/>
    <result property="age" column="age"/>
    <result property="sex" column="sex"/>
    <result property="email" column="email"/>
</resultMap>

<!--List<Emp> getAllEmp();-->
<select id="getAllEmp" resultMap="empResultMap">
    select * from t_emp
</select>

• 若字段名和实体类中的属性名不一致，但是字段名符合数据库的规则（使用_），实体类中的属性名符合Java的规则（使用驼峰）。此时也可通过以下两种方式处理字段名和实体类中的属性的映射关系

  1. 可以通过为字段起别名的方式，保证和实体类中的属性名保持一致

     <!--List<Emp> getAllEmp();-->
     <select id="getAllEmp" resultType="Emp">
     	select eid,emp_name empName,age,sex,email from t_emp
     </select>
     

  2. 可以在MyBatis的核心配置文件中的setting标签中，设置一个全局配置信息mapUnderscoreToCamelCase，可以在查询表中数据时，自动将_类型的字段名转换为驼峰，例如：字段名user_name，设置了mapUnderscoreToCamelCase，此时字段名就会转换为userName。核心配置文件详解

     <!--设置MyBatis的全局配置-->
     <settings>
         <!--将下划线_自动映射为驼峰 emp_name:empName-->
         <setting name="mapUnderscoreToCamelCase" value="true"/>
     </settings>
     

2、多对一映射处理

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

@Data
public class Emp implements Serializable {
    private Integer eid;
    private String empName;
    private Integer age;
    private String sex;
    private String email;
    private Dept dept;
}

级联方式处理映射关系

<!--处理多对一映射关系方式一：级联属性赋值-->
<resultMap id="empAndDeptResultMapOne" type="Emp">
    <id property="eid" column="eid"/>
    <result property="empName" column="emp_name"/>
    <result property="age" column="age"/>
    <result property="sex" column="sex"/>
    <result property="email" column="email"/>
    <result property="dept.did" column="did"/>
    <result property="dept.deptName" column="dept_name"/>
</resultMap>

<!--Emp getEmpAndDept(@Param("eid") Integer eid);-->
<select id="getEmpAndDept" resultMap="empAndDeptResultMapOne">
    select * from t_emp left join t_dept on t_emp.did=t_dept.did where t_emp.eid=#{eid}
</select>

使用association处理映射关系

• association：处理多对一的映射关系
• property：需要处理多对的映射关系的属性名
• javaType：该属性的类型

<!--处理多对一映射关系方式二：association-->
<resultMap id="empAndDeptResultMapTwo" type="Emp">
    <id property="eid" column="eid"/>
    <result property="empName" column="emp_name"/>
    <result property="age" column="age"/>
    <result property="sex" column="sex"/>
    <result property="email" column="email"/>
    <!--
        association：处理多对一的映射关系
        属性：
            property：需要处理多对一的映射关系的属性名
            javaType：该属性的类型
    -->
    <association property="dept" javaType="Dept">
        <id property="did" column="did"/>
        <result property="deptName" column="dept_name"/>
    </association>
</resultMap>

<!--Emp getEmpAndDept(@Param("eid") Integer eid);-->
<select id="getEmpAndDept" resultMap="empAndDeptResultMapTwo">
    select * from t_emp left join t_dept on t_emp.did=t_dept.did where t_emp.eid=#{eid}
</select>

分步查询

1. 查询员工信息

• select：设置分布查询的sql的唯一标识（namespace.SQLId或mapper接口的全类名.方法名）
• column：设置分步查询的条件

/**
 * 通过分步查询员工以及员工所对应的部门信息
 * 分步查询第一步：查询员工信息
 */
Emp getEmpAndDeptByStepOne(@Param("eid") Integer eid);

<resultMap id="empAndDeptByStepResultMap" type="Emp">
    <id property="eid" column="eid"/>
    <result property="empName" column="emp_name"/>
    <result property="age" column="age"/>
    <result property="sex" column="sex"/>
    <result property="email" column="email"/>
    <!--
        select：设置分步查询的SQL的唯一标识（namespace.SQLId或者mapper接口的全类名.方法名）
        column：设置分步查询的条件
        fetchType：当开启全局的延迟加载之后，可通过此属性手动控制延迟加载的效果
        fetchType="lazy|eager" lazy延迟加载 eager立即加载
    -->
    <association property="dept"
                 select="com.edu.mapper.DeptMapper.getEmpAndDeptByStepTwo"
                 column="did"
                 fetchType="lazy"/>
</resultMap>

<!--Emp getEmpAndDeptByStepOne(@Param("eid") Integer eid);-->
<select id="getEmpAndDeptByStepOne" resultMap="empAndDeptByStepResultMap">
    select * from t_emp where eid=#{eid}
</select>

2. 查询部门信息

/**
 * 通过分步查询员工以及员工所对应的部门信息
 * 分步查询第二步：通过did查询员工所对应的部门
 */
Dept getEmpAndDeptByStepTwo(@Param("did") Integer did);

<!--此处的resultMap仅是处理字段和属性的映射关系-->
<resultMap id="EmpAndDeptByStepTwoResultMap" type="Dept">
    <id property="did" column="did"></id>
    <result property="deptName" column="dept_name"></result>
</resultMap>

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

3、一对多映射处理

@Data
public class Dept {
    private Integer did;
    private String deptName;
    private List<Emp> emps;
}

collection

• collection：用来处理一对多的映射关系
• ofType：表示该属性对饮的集合中存储的数据的类型

/**
 * 获取部门以及部门中所有的员工信息
 */
Dept getDeptAndEmp(@Param("did") Integer did);

<resultMap id="deptAndEmpResultMap" type="Dept">
    <id property="did" column="did"/>
    <result property="deptName" column="dept_name"/>
    <!--
   		collection：处理一对多的映射关系
   		ofType：表示该属性所对应的集合中存储数据的类型
    -->
    <collection property="emps" ofType="Emp">
        <id property="eid" column="eid"/>
        <result property="empName" column="emp_name"/>
        <result property="age" column="age"/>
        <result property="sex" column="sex"/>
        <result property="email" column="email"/>
    </collection>
</resultMap>

<!--Dept getDeptAndEmp(@Param("did") Integer did);-->
<select id="getDeptAndEmp" resultMap="deptAndEmpResultMap">
    select * from t_dept left join t_emp on t_dept.did = t_emp.did where t_dept.did = #{did}
</select>

分步查询

1. 查询部门信息

/**
 * 通过分步查询查询部门以及部门中所有的员工信息
 * 分步查询第一步：查询部门信息
 */
Dept getDeptAndEmpByStepOne(@Param("did") Integer did);

<resultMap id="deptAndEmpByStepResultMap" type="Dept">
    <id property="did" column="did"/>
    <result property="deptName" column="dept_name"/>
    <collection property="emps"
                select="com.edu.mapper.EmpMapper.getDeptAndEmpByStepTwo"
                column="did"
                fetchType="lazy"/>
</resultMap>

<!--Dept getDeptAndEmpByStepOne(@Param("did") Integer did);-->
<select id="getDeptAndEmpByStepOne" resultMap="deptAndEmpByStepResultMap">
    select * from t_dept where did = #{did}
</select>

2. 根据部门id查询部门中的所有员工

/**
 * 通过分步查询查询部门以及部门中所有的员工信息
 * 分步查询第二步：根据did查询员工信息
 */
List<Emp> getDeptAndEmpByStepTwo(@Param("did") Integer did);

<!--List<Emp> getDeptAndEmpByStepTwo(@Param("did") Integer did);-->
<select id="getDeptAndEmpByStepTwo" resultType="Emp">
    select * from t_emp where did = #{did}
</select>

延迟加载

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

<settings>
	<!--开启延迟加载-->
	<setting name="lazyLoadingEnabled" value="true"/>
</settings>

@Test
public void getEmpAndDeptByStepOne() {
	SqlSession sqlSession = SqlSessionUtils.getSqlSession();
	EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
	Emp emp = mapper.getEmpAndDeptByStepOne(1);
	System.out.println(emp.getEmpName());
}

@Test
public void getEmpAndDeptByStepOne() {
	SqlSession sqlSession = SqlSessionUtils.getSqlSession();
	EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
	Emp emp = mapper.getEmpAndDeptByStepOne(1);
	System.out.println(emp.getEmpName());
	System.out.println("----------------");
	System.out.println(emp.getDept());
}

• 开启后，需要用到查询dept的时候才会调用相应的SQL语句[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Q97Mua4J-1668602505989)(Resources/延迟加载测试3.png)]
• fetchType：当开启了全局的延迟加载之后，可以通过该属性手动控制延迟加载的效果，fetchType=“lazy(延迟加载)|eager(立即加载)”

<resultMap id="empAndDeptByStepResultMap" type="Emp">
	<id property="eid" column="eid"></id>
	<result property="empName" column="emp_name"></result>
	<result property="age" column="age"></result>
	<result property="sex" column="sex"></result>
	<result property="email" column="email"></result>
	<association property="dept"
				 select="com.atguigu.mybatis.mapper.DeptMapper.getEmpAndDeptByStepTwo"
				 column="did"
				 fetchType="lazy"></association>
</resultMap>

九、动态SQL

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

1、if

• if标签可通过test属性（即传递过来的数据）的表达式进行判断，若表达式的结果为true，则标签中的内容会执行；反之标签中的内容不会执行
• 在where后面添加一个恒成立条件1=1
• 这个恒成立条件并不会影响查询的结果
  • 这个1=1可以用来拼接and语句，例如：当empName为null时
  • 如果不加上恒成立条件，则SQL语句为select * from t_emp where and age = ? and sex = ? and email = ?，此时where会与and连用，SQL语句会报错
    • 如果加上一个恒成立条件，则SQL语句为select * from t_emp where 1= 1 and age = ? and sex = ? and email = ?，此时不报错

<!--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="sex != null and sex !=''">
        and sex = #{sex}
    </if>
    <if test="email != null and email !=''">
        and email = #{email}
    </if>
</select>

2、where

• where和if一般结合使用：
• 若where标签中的if条件都不满足，则where标签没有任何功能，即不会添加where关键字
  • 若where标签中的if条件满足，则where标签会自动添加where关键字，并将条件最前方多余的and/or去掉

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

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

<!--这种用法是错误的，只能去掉条件前面的and/or，条件后面的不行-->
<if test="empName != null and empName !=''">
	emp_name = #{empName} and
</if>
<if test="age != null and age !=''">
	age = #{age}
</if>

3、trim

• trim用于去掉或添加标签中的内容
• 常用属性
• prefix：在trim标签中的内容的前面添加某些内容
  • suffix：在trim标签中的内容的后面添加某些内容
  • prefixOverrides：在trim标签中的内容的前面去掉某些内容
  • suffixOverrides：在trim标签中的内容的后面去掉某些内容
• 若trim中的标签都不满足条件，则trim标签没有任何效果，也就是只剩下select * from t_emp

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

@Test
public void testGetEmpByCondition() {
    SqlSession sqlSession = SqlSessionUtils.getSqlSession();
    DynamicSQLMapper mapper = sqlSession.getMapper(DynamicSQLMapper.class);
    Emp emp = new Emp();
    emp.setEmpName("张三");
    emp.setAge(23);
    emp.setSex("男");
    emp.setEmail("123456@qq.com");
    List<Emp> list = mapper.getEmpByCondition(emp);
    System.out.println(list);
}

4、choose、when、otherwise

• choose、when、otherwise相当于if...else if..else
• when至少要有一个，otherwise至多只有一个

<!--List<Emp> getEmpByChoose(Emp emp);-->
<select id="getEmpByChoose" resultType="Emp">
    select <include refid="empColumns"/> 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="sex != null and sex !=''">
                sex = #{sex}
            </when>
            <when test="email != null and email !=''">
                email = #{email}
            </when>
            <otherwise>
                did = 1
            </otherwise>
        </choose>
    </where>
</select>

@Test
public void testGetEmpByChoose() {
    SqlSession sqlSession = SqlSessionUtils.getSqlSession();
    DynamicSQLMapper mapper = sqlSession.getMapper(DynamicSQLMapper.class);
    Emp emp = new Emp();
    /*
    emp.setEmpName("张三");
    emp.setAge(23);
    emp.setSex("男");
    emp.setEmail("123456@qq.com");
    */
    List<Emp> list = mapper.getEmpByChoose(emp);
    System.out.println(list);
}

• 相当于if a else if b else if c else d，只会执行其中一个

5、foreach

• 属性：
• collection：设置要循环的数组或集合
  • item：表示集合或数组中的每一个数据
  • separator：设置循环体之间的分隔符，分隔符前后默认有一个空格，如,
  • open：设置foreach标签中的内容的开始符
  • close：设置foreach标签中的内容的结束符
• 批量删除

<!--int deleteMoreByArray(@Param("eids") Integer[] eids);-->
<delete id="deleteMoreByArray">
    <!--
    delete from t_emp where eid in
    <foreach collection="eids" item="eid" separator="," open="(" close=")">
    	#{eid}
    </foreach>
    -->
    delete from t_emp where
    <foreach collection="eids" item="eid" separator="or">
        eid = #{eid}
    </foreach>
</delete>

• 批量添加

<!--int insertMoreByList(List<Emp> emps);-->
<insert id="insertMoreByList">
    insert into t_emp values
    <foreach collection="emps" item="emp" separator=",">
        (null,#{emp.empName},#{emp.age},#{emp.sex},#{emp.email},null)
    </foreach>
</insert>

6、SQL片段

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

<sql id="empColumns">
    eid,emp_name,age,sex,email
</sql>

• 引用sql片段：<include>标签

<select id="getEmpByChoose" resultType="Emp">
    select <include refid="empColumns"/> from t_emp
</select>

7、总结

动态SQL：
1.if：根据标签中的test属性所对应的表达式决定标签中的内容是否需要拼接到SQL中
2.where：当where标签中有内容时，会自动生成where关键字，并且将内容前多余的and或or去掉
        当where标签中没有内容时，此时where标签没有任何效果
    注意：where标签不能将其中内容后面多余的and或者or去掉
3.trim：
    prefix|suffix：将trim标签中内容前面或后面添加指定内容
    prefixOverrides|suffixOverrides：将trim标签中内容前面或后面去掉指定内容
4.choose，when，otherwise相当于if...else if...else
    when至少要有一个 otherwise最多只能有一个
5.foreach：
    collection：设置需要循环的数组或集合
    item：表示数组或集合中的每一个数据
    separator：循环体之间的分隔符
    open：foreach标签所循环的所有内容的开始符
    close：foreach标签所循环的所有内容的结束符
6.sql标签
    设置SQL片段：<sql id="empColumns">eid,emp_name,age,sex,email</sql>
    引用SQL片段：<include refid="empColumns"/>

十、MyBatis的缓存

1、MyBatis的一级缓存

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

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

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

2、MyBatis的二级缓存

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

• 二级缓存开启的条件

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

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

3、二级缓存的相关配置

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

4、MyBatis缓存查询的顺序

• 先查询二级缓存，因为二级缓存中可能会有其他程序已经查出来的数据，可以拿来直接使用
• 如果二级缓存没有命中，再查询一级缓存
• 如果一级缓存也没有命中，则查询数据库
• SqlSession关闭之后，一级缓存中的数据会写入二级缓存

5、整合第三方缓存EHCache（了解）

a>添加依赖

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

b>各个jar包的功能

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

c>创建EHCache的配置文件ehcache.xml

• 名字必须叫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>

d>设置二级缓存的类型

• 在xxxMapper.xml文件中设置二级缓存类型

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

e>加入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.atguigu.crowd.mapper" level="DEBUG"/>
</configuration>

f>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（先进先出

十一、MyBatis的逆向工程

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

1、创建逆向工程的步骤

a>添加依赖和插件

<dependencies>
    <!--mybatis核心-->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.4.5</version>
    </dependency>
    <!--mysql驱动-->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.6</version>
        <scope>runtime</scope>
    </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.12</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>5.1.6</version>
                    <scope>runtime</scope>
                </dependency>
            </dependencies>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <configuration>
                <source>8</source>
                <target>8</target>
            </configuration>
        </plugin>
    </plugins>
</build>

b>创建MyBatis的核心配置文件

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "https://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>

    <!--引用外部的properties属性文件-->
    <properties resource="jdbcConfig.properties"/>

    <!--设置MyBatis的全局配置-->
    <settings>
        <!--将下划线_自动映射为驼峰 emp_name:empName-->
        <setting name="mapUnderscoreToCamelCase" value="true"/>
        <!--开启延迟加载-->
        <setting name="lazyLoadingEnabled" value="true"/>
    </settings>

    <!--给实体类起别名-->
    <typeAliases>
        <package name="com.edu.pojo"/>
    </typeAliases>
    
    <plugins>
        <!--设置分页插件-->
        <plugin interceptor="com.github.pagehelper.PageInterceptor"></plugin>
    </plugins>

    <!--配置多个连接数据库的环境-->
    <environments default="mybatis_mysql">
        <!--配置某个具体的环境-->
        <environment id="mybatis_mysql">
            <!--设置事务管理方式-->
            <transactionManager type="JDBC"/>
            <!--配置数据源-->
            <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.edu.mapper"/>
    </mappers>

</configuration>

c>创建逆向工程的配置文件

• 文件名必须是：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.jdbc.Driver"
                        connectionURL="jdbc:mysql://localhost:3306/mybatis_exercise"
                        userId="root"
                        password="123456">
        </jdbcConnection>
        <!-- javaBean的生成策略-->
        <javaModelGenerator targetPackage="com.edu.pojo" targetProject=".\src\main\java">
            <property name="enableSubPackages" value="true" />
            <property name="trimStrings" value="true" />
        </javaModelGenerator>
        <!-- SQL映射文件的生成策略 -->
        <sqlMapGenerator targetPackage="com.edu.mapper"
                         targetProject=".\src\main\resources">
            <property name="enableSubPackages" value="true" />
        </sqlMapGenerator>
        <!-- Mapper接口的生成策略 -->
        <javaClientGenerator type="XMLMAPPER"
                             targetPackage="com.edu.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>

d>执行MBG插件的generate目标

2、QBC

查询

• selectByExample：按条件查询，需要传入一个example对象或者null；如果传入一个null，则表示没有条件，也就是查询所有数据
• example.createCriteria().xxx：创建条件对象，通过andXXX方法为SQL添加查询添加，每个条件之间是and关系
• example.or().xxx：将之前添加的条件通过or拼接其他条件

@Test
public void testMBG() throws Exception {
    InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
    SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);
    SqlSession sqlSession = factory.openSession(true);
    EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
    
    //查询所有数据
    List<Emp> list = mapper.selectByExample(null);
    list.forEach(emp -> System.out.println(emp));
    
    //根据条件查询
    EmpExample empExample = new EmpExample();
    empExample.createCriteria().andEmpNameEqualTo("张三").andAgeGreaterThanOrEqualTo(20);
    empExample.or().andDidIsNotNull();
    List<Emp> list = mapper.selectByExample(empExample);
    list.forEach(emp -> System.out.println(emp));
}

增改

• updateByPrimaryKey：通过主键进行数据修改，如果某一个值为null，也会将对应的字段改为null
• updateByPrimaryKeySelective()：通过主键进行选择性数据修改，如果某个值为null，则不修改这个字段

@Test
public void testMBG() throws Exception {
    InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
    SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);
    SqlSession sqlSession = factory.openSession(true);
    EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
    
    //属性值为null时 会将该字段修改为null
    mapper.updateByPrimaryKey(new Emp(1,"张三",22,null,"654564@qq.com",3));
    
    //属性值为null时 该字段将不会修改
    mapper.updateByPrimaryKeySelective(new Emp(1,"张三",22,null,"654564@qq.com",3));
}

十二、分页插件

1、分页插件使用步骤

a>添加依赖

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

b>配置分页插件

• 在MyBatis的核心配置文件（mybatis-config.xml）中配置插件
• 添加到typeAliases标签和environments标签之间

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

2、分页插件的使用

limit index,pageSize
index：当前页的起始索引
pageSize：每页显示的条数
pageNum：当前页的页码
index=(pageNum-1)*pageSize

使用MyBatis的分页插件实现分页功能
    1.需要在查询功能之前开启分页
    	PageHelper.startPage(int pageNum, int pageSize);
    2.在查询功能之后获取分页相关信息
        PageInfo<Emp> page = new PageInfo<>(list, 5);
        list：表示分页数据
        5：表示当前导航分页的数量

a>开启分页功能

• 在查询功能之前使用PageHelper.startPage(int pageNum, int pageSize)开启分页功能
• pageNum：当前页的页码
  • pageSize：每页显示的条数

@Test
public void testMBG() throws Exception {
    InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
    SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);
    SqlSession sqlSession = factory.openSession(true);
    EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);

    PageHelper.startPage(2, 4);

    List<Emp> list = mapper.selectByExample(null);
    list.forEach(emp -> System.out.println(emp));
}

/*
结果：
    Emp{eid=5, empName='田七', age=41, sex='男', email='123456@qq.com', did=2}
    Emp{eid=9, empName='a1', age=21, sex='男', email='123456@qq.com', did=null}
    Emp{eid=10, empName='a2', age=22, sex='女', email='123456@qq.com', did=null}
    Emp{eid=11, empName='a3', age=23, sex='男', email='123456@qq.com', did=null}
*/

b>分页相关数据

PageInfo<Emp> page = new PageInfo<>(list, 5);
list：表示分页数据
5：表示当前导航分页的数量

方法一：直接输出

@Test
public void testMBG() throws Exception {
    InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
    SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);
    SqlSession sqlSession = factory.openSession(true);
    EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);

    Page<Object> page = PageHelper.startPage(2, 4);

    List<Emp> list = mapper.selectByExample(null);

    System.out.println(page);
}

• 分页相关数据：

  Page{count=true, pageNum=2, pageSize=4, startRow=4, endRow=8, total=9, pages=3, reasonable=false, pageSizeZero=false}
  [
  Emp{eid=5, empName=‘田七’, age=41, sex=‘男’, email=‘123456@qq.com’, did=2},
  Emp{eid=9, empName=‘a1’, age=21, sex=‘男’, email=‘123456@qq.com’, did=null},
  Emp{eid=10, empName=‘a2’, age=22, sex=‘女’, email=‘123456@qq.com’, did=null},
  Emp{eid=11, empName=‘a3’, age=23, sex=‘男’, email=‘123456@qq.com’, did=null}
  ]

方法二使用PageInfo

• 在查询获取list集合之后，使用PageInfo<T> pageInfo = new PageInfo<>(List<T> list, intnavigatePages)获取分页相关数据
• list：分页之后的数据
  • navigatePages：导航分页的页码数

@Test
public void testMBG() throws Exception {
    InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
    SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);
    SqlSession sqlSession = factory.openSession(true);
    EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);

    PageHelper.startPage(2, 4);

    List<Emp> list = mapper.selectByExample(null);

    PageInfo<Emp> page = new PageInfo<>(list, 5);

    System.out.println(page);
}

• 分页相关数据：

  PageInfo{pageNum=2, pageSize=4, size=4, startRow=5, endRow=8, total=9, pages=3, list=Page{count=true, pageNum=2, pageSize=4, startRow=4, endRow=8, total=9, pages=3, reasonable=false, pageSizeZero=false}
  [
  Emp{eid=5, empName=‘田七’, age=41, sex=‘男’, email=‘123456@qq.com’, did=2},
  Emp{eid=9, empName=‘a1’, age=21, sex=‘男’, email=‘123456@qq.com’, did=null},
  Emp{eid=10, empName=‘a2’, age=22, sex=‘女’, email=‘123456@qq.com’, did=null},
  Emp{eid=11, empName=‘a3’, age=23, sex=‘男’, email=‘123456@qq.com’, did=null}
  ],
  prePage=1, nextPage=3, isFirstPage=false, isLastPage=false, hasPreviousPage=true, hasNextPage=true, navigatePages=5, navigateFirstPage=1, navigateLastPage=3, navigatepageNums=[1, 2, 3]}

• 其中list中的数据等同于方法一中直接输出的page数据

常用数据：

• pageNum：当前页的页码
• pageSize：每页显示的条数
• size：当前页显示的真实条数
• total：总记录数
• pages：总页数
• prePage：上一页的页码
• nextPage：下一页的页码
• isFirstPage/isLastPage：是否为第一页/最后一页
• hasPreviousPage/hasNextPage：是否存在上一页/下一页
• navigatePages：导航分页的页码数
• navigatepageNums：导航分页的页码，[1,2,3,4,5]