MyBatis & MyBatis-Plus详解

一、Mybatis入门

1.1 Mybatis历史

iBatis一词来源于“Internet”和“Abatis”的组合，是一个基于Java的持久层框架。iBatis提供的持久层框架包括SQL Maps和Data Access Objects(Dao)。

1.2 Mybatis特性

1）Mybatis是支持定制化SQL、存储过程以及高级映射的持久层框架

2）Mybatis避免了几乎所有的JDBC代码和手动设置参数以及获取结果集

3）Mybatis可以使用简单的XML或注解用于配置和原始映射，将接口和Java的POJO(Plain Old Java Objects，普通的Java对象)映射成数据库中的记录

4）Mybatis是一个半自动的ORM(Object Relation Mapping)框架

1.3 创建MyBatis的核心配置文件

• 习惯上命名为MyBatis-config.xml，这个文件名仅仅是建议，并非强制要求，将来整合Spirng之后，这个配置文件可以省略。
• 核心配置文件主要用于配置连接数据库的环境、Mybatis的全局配置信息
• 核心配置文件存放的位置是src/main/resource目录下

  
DOCTYPE configuration  
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"  
"http://mybatis.org/dtd/mybatis-3-config.dtd">  
<configuration> 



	
	<properties resource="jdbc.properties"/>

    <settings>
        
        <setting name="mapUnderscoreToCamelCase" value="true"/>
        
        <setting name="lazyLoadingEnabled" value="true"/>
    settings>
    
	
	<typeAliases>
        
		
        
        
        <package name="com.atguigu.mybatis.pojo"/>
	typeAliases>

	
	<environments default="development">
		
		<environment id="development">
			
			<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>  
		  
		<mapper resource="mappers/UserMapper.xml"/> 
        
        <package name="com.atguigu.mybatis.mapper"/>
	mappers>  
configuration>

1.3.1 引入properties文件

jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/MyBatis
jdbc.username=root
jdbc.password=123456

1.4 创建mapper接口

MyBatis中的接口相当于以前的Dao，但区别再与，MyBatis中我们只需要提供接口，无需提供实现类，MyBatis就可以自动为我们去调用对应的SQL语句操作数据，返回结果。

public interface UserMapper {
    /**
    * Mybatis面向接口编程的两个一致：
	*  - 映射文件的namespace和mapper接口的全类名保持一致。
	*  - 映射文件中的SQL语句的id和mapper接口中的方法名保持一致。
	*/	
    int insertUser();
}

1.5 创建Mybatis的映射文件

相关概念：ORM（Object Relationship Mapping）对象映射关系。

• 对象：Java的实体类对象

• 关系：关系型数据库

• 映射：二者之间的对应关系

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

  1、映射文件的命名规则：

  表名+Mapper.xml,例：表为User表，映射的实体类为User.java，所对应的映射文件为UserMapper.xml

  因此，一张表对应一个Mapper映射文件（对这个表的操作都写在这个映射文件中），对应一个实体类

  2、映射文件的作用及存放位置

  • 作用：用于编写SQL，访问以及操作表中的数据。
  • 位置：src/main/resources/mapper目录下

  注：MaBatis可以面向接口操作数据，要保证两个一致。

  • 映射文件的namespace和mapper接口的全类名保持一致。
  • 映射文件中的SQL语句的id和mapper接口中的方法名保持一致。

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

	  
	<insert id="insertUser">  
		insert into t_user values(null,'张三','123',23,'女')  
	insert>

	  
	<select id="selectUserById" resultType="com.lmj.mybatis.pojo.User">
		select * from t_user where id = 1
	select>
mapper>

总结：通过核心配置文件，配置好与数据库的连接关系，以及映射文件的位置，MyBatis是面向接口编程，接口相当于之前的Dao，只是没有了实现类，我们配置好MyBatis的信息后，调用接口。

• MyBatis先是从核心配置文件中找到连接数据库信息，以及找到映射文件的位置。
• 然后再通过mapper接口的全类名，在映射文件里找到的对应的namespace。
• 再通过调用的方法名，找到映射文件里的SQL唯一id，MaBatis执行SQL操作数据库。
• 返回结果，吧查到的表记录通过resultType或resultMap来确定映射关系，再通过反射自动映射表字段和实体类的属性名实现赋值，复杂的映射关系可以通过restultMap来自定义数据库字段与属性的关系。

打印日志，输出SQL执行情况

1、加入依赖

<dependency>
	<groupId>log4jgroupId>
	<artifactId>log4jartifactId>
	<version>1.2.17version>
dependency>

2、添加log4j.xml文件

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

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>

二、MyBatis获取参数值的两种方式

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

• #{}的本质是：占位符赋值，${}的本质是：字符串拼接

• #{}使用占位符赋值的方式拼接SQL，此时字符串类型或日期类型的字段进行赋值时，可以自动添加单引号；

  ${}使用字符串拼接的方式拼接SQL，此时字符串类型或日期类型的字段进行赋值时，需要手动加单引号。

2.1 单个字面量类型的参数

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

<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="getUserByUsername" resultType="User">
	select * from t_user where username = #{aaa}
select>

2.2 多个字面量类型的参数(不常用)

• 若mapper接口中的方法参数为多个时，此时MyBatis会自动将这些参数放在一个map集合中
  1. 以arg0,arg1…为键，以参数为值；
  2. 以param1,param2…为键，以参数为值。

<select id="checkLogin" resultType="User">  
	select * from t_user where username = #{arg0} and password = #{arg1}  
select>

<select id="checkLogin" resultType="User">
	select * from t_user where username = '${param1}' and password = '${param2}'
select>

混合用也可

<select id="checkLogin" resultType="User">  
	select * from t_user where username = #{arg0} and password = #{param2}  
select>

• 所以只需要通过#{}和#{}访问map集合的键就可以获取相对应的值，${}需要加上单引号
• 使用arg或param都行，要注意的是，arg是从arg0开始的，param是从param1开始的

2.3 map集合类型的参数

• 若mapper接口中的参数为多个时，此时可以手动创建map集合，把参数封装到map中，也可以通过#{}和$来访问map的key来获取参数值，但${}需要手动添加单引号

Map<String,Object> params = new HashMap<>();
params.put("username","admin");
params.put("password",123456);
User user = mapper.checkLogin(params);

<select id="checkLoginByMap" resultType="User">
	select * from t_user where username = #{username} and password = #{password}
select>

2.4 实体类型的参数

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

User user = new User(null,"Tom","123456",12,"男","[email protected]");
mapper.insertUser(user);

<insert id="insertUser">
	insert into t_user values(null,#{username},#{password},#{age},#{sex},#{email})
insert>

2.5 使用@Param标识参数

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

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

• 通过KaTeX parse error: Expected 'EOF', got '#' at position 4: {}和#̲{}访问map集合中的键就可以…{}需要手动添加单引号

User checkLoginByParam(@Param(value = "username")String username, @Param("password")String password);

User user = mapper.checkLoginByParam("admin","123456");

    <select id="checkLoginByParam" resultType="User">
        select * from t_user where username = #{username} and password = #{password}
    select>

2.6 总结

• 建议分词两种情况进行处理

1. 实体类类型的参数，及6.4所示
2. 使用@Param标识参数，及6.5所示

三、MyBatis的各种查询功能

• 如果查询出的数据只有一条，可以通过

1. 实体类对象接收
2. List集合接收
3. Map集合接收，结果{password=123456, sex=男, id=1, age=23, username=admin}

• 如果查询出的数据有多条，一定不能用实体类对象接收，会抛出TooManyRestultsException,可以通过
  1. 实体类泛型的List集合接收
  2. Map类型的List集合接收
  3. 在mapper接口方法上添加@MapKey注解
• MaBatis中设置了默认的类型别名
  1. java.lang.Integer---->int,integer
  2. int---->_int,_integer
  3. Map---->map
  4. Stirng---->string

3.1 查询一个实体类对象

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

<select id="getUserById" resultType="User">
	select * from t_user where id = #{id}
select>

3.2 查询一个List集合

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

<select id="getUserList" resultType="User">
	select * from t_user
select>

3.3 查询单个数据

/**  
 * 查询用户的总记录数  
 * @return  
 * 在MyBatis中，对于Java中常用的类型都设置了类型别名  
 * 例如：java.lang.Integer-->int|integer  
 * 例如：int-->_int|_integer  
 * 例如：Map-->map,List-->list  
 */  
int getCount();

<select id="getCount" resultType="_integer">
	select count(id) from t_user
select>

3.4 一条数据为map集合

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

<select id="getUserToMap" resultType="map">
	select * from t_user where id = #{id}
select>

3.5 查询多条数据为map集合

• 方法一

/**  
 * 查询所有用户信息为map集合  
 * @return  
 * 将表中的数据以map集合的方式查询，一条数据对应一个map；若有多条数据，就会产生多个map集合，此时可以将这些map放在一个list集合中获取  
 */  
List<Map<String, Object>> getAllUserToMap();

  
<select id="getAllUserToMap" resultType="map">  
	select * from t_user  
select>

• 方法二：在mapper接口的方法上添加@MapKey注解，此时就可以将每条数据转换的map结合作为值，以某个字段的值作为键，放在同一个map集合中。

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

<select id="getAllUserToMap" resultType="map">
	select * from t_user
select>

四、特殊SQL的执行

4.1 模糊查询（用#{}）

/**
 * 根据用户名进行模糊查询
 * @param username 
 * @return java.util.List
 * @date 2022/2/26 21:56
 */
List<User> getUserByLike(@Param("username") String username);

<select id="getUserByLike" resultType="User">
	  
	  
	select * from t_user where username like "%"#{mohu}"%"
select>

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

  下面的SQL是错误的，当在单引号里用#{}时，？存在于单引号里面，？属于字符串一部分，不会被解析为占位符，会被当做字符串中的一部分解析，所以此时sql语句中并没有占位符，而却要为占位符赋值，所以就会报错。

<select id="getUserByLike" resultType="User">
	select * from t_user where username like '%#{}%'
select>

4.2 批量删除(必须用${})

• 只能使用${},如果使用#{}，则解析后的SQL语句为delete from t_user where id in ('1,2,3'),#{}会自动加单引号，相当于（‘1,2,3’）这样是将1,2,3看做是一个整体，只有id为1,2,3的数据才会被删除。
• 正确的语句应该是delete from t_user where in (1,2,3)或者delete from t_user where id in ('1','2','3')

/**
 * 根据id批量删除
 * @param ids 
 * @return int
 * @date 2022/2/26 22:06
 */
int deleteMore(@Param("ids") String ids);

<delete id="deleteMore">
	delete from t_user where id in (${ids})
delete>

//测试类
@Test
public void deleteMore() {
	SqlSession sqlSession = SqlSessionUtils.getSqlSession();
	SQLMapper mapper = sqlSession.getMapper(SQLMapper.class);
	int result = mapper.deleteMore("1,2,3,8");
	System.out.println(result);
}

4.3 动态设置表名(必须用${})

• 只能使用${}，因为表名不能用单引号，用#{},会自动加上单引号，所以会报错。SQL中字符串类型数据，日期类型数据，字段名可以加单引号，表名不能加单引号。

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

<select id="getUserByTable" resultType="User">
	select * from ${tableName}
select>

4.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对象的某个属性中

注：一对多还是多对一，都要把表关系设置在多的一方，增删改的返回值固定，就是受影响的条数。

/**
 * 添加用户信息
 * @param user 
 * @date 2022/2/27 15:04
 */
void insertUser(User user);

<insert id="insertUser" useGeneratedKeys="true" keyProperty="id">
	insert into t_user values (null,#{username},#{password},#{age},#{sex},#{email})
insert>

//测试类
@Test
public void insertUser() {
	SqlSession sqlSession = SqlSessionUtils.getSqlSession();
	SQLMapper mapper = sqlSession.getMapper(SQLMapper.class);
	User user = new User(null, "ton", "123", 23, "男", "[email protected]");
	mapper.insertUser(user);
	System.out.println(user);
	//输出：user{id=10, username='ton', password='123', age=23, sex='男', email='[email protected]'}，自增主键存放到了user的id属性中
}

五、自定义映射

5.1 字段名与属性名不一致

• 字段名与属性名一致，就可以自动创建映射关系，把查出来的值对相对应的属性赋值。

• 字段名与属性名不一致时，如字段名为emp_name ,属性名为empName，下划线并不能对应驼峰命名，此时mybatis默认不能自动映射，但不会报错，只是不一致的不会赋值，empName会被赋值'null'。

解决方式

1. 为字段起别名，保持和属性名的一致：对与属性名不一致的字段名起别名，来保证和实体类中的属性名保持一致 。

   
   	<select id="getAllEmp" resultType="Emp">
   		select eid,emp_name as empName,age,sex,email from t_emp
   	select>
   

2. 设置全局配置，将_自动映射为驼峰可以在MyBatis的核心配置文件中的setting标签中，设置一个全局配置信息mapUnderscoreToCamelCase，可以在查询表中数据时，自动将_类型的字段名转换为驼峰。此时，emp_name会自动转换为empName。mapUnderscoreToCamelCase默认为false，不开启该功能。

   <settings>
       <setting name="mapUnderscoreToCamelCase" value="true"/>
   settings>
   

3. 通过resultMap来设置自定义映射关系。一旦设置了resultMap，即使属性名与字段名一致也应写上对应关系，不可以省略，要全部写上,要保证property是resultmap type中的属性，column是查询出来字段名。

属性：

• id：表示自定义映射的唯一标识，不能重复

  type：设置映射关系中的实体类类型

• 子标签：

  • id：设置主键的映射关系
  • result：设置普通字段的映射关系
  • 子标签属性：
    • property：设置映射关系中实体类中的属性名 ，必须是type属性所设置的实体类类型中的属性名
    • column：设置映射关系中表中的字段名，必须是SQL语句查询出的字段名，设置了别名，得写别名

<resultMap id="empResultMap" 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>
resultMap>



<select id="getAllEmp" resultMap="empResultMap">
	select * from t_emp
select>

5.2 多对一映射

//对一对应对象

解决方式

5.2.1 级联属性赋值

<resultMap id="empAndDeptResultMapOne" 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>
	<result property="dept.did" column="did">result>
	<result property="dept.deptName" column="dept_name">result>
resultMap>

<select id="getEmpAndDept" resultMap="empAndDeptResultMapOne">
	select * from t_emp left join t_dept on t_emp.eid = t_dept.did where t_emp.eid = #{eid}
select>

5.2.2 association处理多对一映射

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

<resultMap id="empAndDeptResultMapTwo" 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" javaType="Dept">
		<id property="did" column="did">id>
		<result property="deptName" column="dept_name">result>
	association>
resultMap>

<select id="getEmpAndDept" resultMap="empAndDeptResultMapTwo">
	select * from t_emp left join t_dept on t_emp.eid = t_dept.did where t_emp.eid = #{eid}
select>

5.2.3 分布查询处理多对一映射

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

5.2.3.1 查询员工信息

//EmpMapper里的方法
/**
 * 通过分步查询，员工及所对应的部门信息
 * 分步查询第一步：查询员工信息
 * @param  
 * @return com.atguigu.mybatis.pojo.Emp
 */
Emp getEmpAndDeptByStepOne(@Param("eid") Integer eid);

<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">association>
resultMap>

<select id="getEmpAndDeptByStepOne" resultMap="empAndDeptByStepResultMap">
	select * from t_emp where eid = #{eid}
select>

5.2.3.2 查询每个员工对应的部门信息

//DeptMapper里的方法
/**
 * 通过分步查询，员工及所对应的部门信息
 * 分步查询第二步：通过did查询员工对应的部门信息
 * @param
 * @return com.atguigu.mybatis.pojo.Emp
 */
Dept getEmpAndDeptByStepTwo(@Param("did") Integer did);

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

延迟加载

<settings>
    
    <setting name="lazyLoadingEnabled" value="true"/>
settings> 

分布查询的好处：

1. 可以实现功能的独立，把一条SQL拆分成两条形成两个功能，当你想调用哪个就可以单独调用它。
2. 可以实现延迟加载，只有当访问需要执行的数据，对应需要执行的SQL才会去执行。

• fetchType：当开启了全局的延迟加载之后，该属性默认为lazy，此时所有的分布查询都是延迟加载。
• 当你想要单独设置某个分布查询为立即加载时，可通过设置fetchType="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="eager">association>
resultMap>

<select id="getEmpAndDeptByStepOne" resultMap="empAndDeptByStepResultMap">
	select * from t_emp where eid = #{eid}
select>

5.3 一对多映射

// 对多对应集合
public class Dept {
    private Integer did;
    private String deptName;
    private List<Emp> emps;
	//...构造器、get、set方法等
}

5.3.1 collection

通过SQL把所有字段都查询出来，然后通过自定义映射关系resultMap来对属性进行赋值

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

<resultMap id="DeptAndEmpResultMap" type="Dept">
	<id property="did" column="did"></id>
	<result property="deptName" column="dept_name"></result>
	<collection property="emps" ofType="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>
	</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>

5.3.2 分布查询

5.3.2.1 查出部门信息

/**
 * 通过分步查询，查询部门及对应的所有员工信息
 * 分步查询第一步：查询部门信息
 * @param did 
 * @return com.atguigu.mybatis.pojo.Dept
 * @date 2022/2/27 22:04
 */
Dept getDeptAndEmpByStepOne(@Param("did") Integer did);

<resultMap id="DeptAndEmpByStepOneResultMap" type="Dept">
	<id property="did" column="did">id>
	<result property="deptName" column="dept_name">result>
	<collection property="emps"
				select="com.atguigu.mybatis.mapper.EmpMapper.getDeptAndEmpByStepTwo"
				column="did">collection>
resultMap>

<select id="getDeptAndEmpByStepOne" resultMap="DeptAndEmpByStepOneResultMap">
	select * from t_dept where did = #{did}
select>

5.3.2.2 查出每个部门的员工

/**
 * 通过分步查询，查询部门及对应的所有员工信息
 * 分步查询第二步：根据部门id查询部门中的所有员工
 * @param did
 * @return java.util.List
 * @date 2022/2/27 22:10
 */
List<Emp> getDeptAndEmpByStepTwo(@Param("did") Integer did);

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

六、动态SQL

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

6.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 = ?，此时不报错

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

6.2 where(常用，与if语句结合使用)

• 当where标签中有内容时，会自动生成where关键字，并且将内容前多余的and或or去掉
• 当where标签中没有内容时，此时where标签没有任何效果，即不会在SQL中拼接where
• 注意：where标签不能将内容后面多余的and或or去掉，所以if条件拼接应该把and或or放在前面拼接

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

6.3 trim

• 若trim标签中有内容时：

  • prefix|suffix：将trim标签中前面或后面添加指定内容
  • suffixOverrides|prefixOverrides：将trim标签中内容前面或后面去掉指定内容

• 若trim标签中没有内容时，trim标签也没有任何效果，即不会加上where关键字

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

6.4 choose、when、otherwise

• choose、when、otherwise相当于if...else if..else
• when至少要有一个，otherwise至多只有一个（when只有一个条件会执行，有一个执行下面就不执行了，otherwise实在when都不满足的时候执行）

<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="sex != null and sex != ''">
				sex = #{sex}
			when>
			<when test="email != null and email != ''">
				email = #{email}
			when>
			<otherwise>
				did = 1
			otherwise>
		choose>
	where>
select>

6.5 foreach

• collection：设置需要循环的数组或集合
• item：表示数组或集合中的每一个数据
• separator：循环体之间的分隔符
• open：foreach标签所循环的所有内容的开始符
• close：foreach标签所循环的所有内容的结束符

6.5.1 批量删除

public void deleteMoreByArray() {
	SqlSession sqlSession = SqlSessionUtils.getSqlSession();
	DynamicSQLMapper mapper = sqlSession.getMapper(DynamicSQLMapper.class);
	int result = mapper.deleteMoreByArray(new Integer[]{6, 7, 8, 9});
	System.out.println(result);
}

• delete from t_emp where eid in ( ? , ? , ? )

<delete id="deleteMoreByArray">
	delete from t_emp where eid in
	<foreach collection="eids" item="eid" separator="," open="(" close=")">
		#{eid}
	foreach>
delete>

• delete from t_emp where eid = ? or eid = ? or eid = ?

<delete id="deleteMoreByArray">
	delete from t_emp where eid in
	<foreach collection="eids" item="eid" separator="or">
		eid = #{eid}
	foreach>
delete>

6.5.2 批量添加

@Test
public void insertMoreByList() {
	SqlSession sqlSession = SqlSessionUtils.getSqlSession();
	DynamicSQLMapper mapper = sqlSession.getMapper(DynamicSQLMapper.class);
	Emp emp1 = new Emp(null,"a",1,"男","[email protected]",null);
	Emp emp2 = new Emp(null,"b",1,"男","[email protected]",null);
	Emp emp3 = new Emp(null,"c",1,"男","[email protected]",null);
	List<Emp> emps = Arrays.asList(emp1, emp2, emp3);
	int result = mapper.insertMoreByList(emps);
	System.out.println(result);
}

<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.6 SQL标签

通过SQL标签，把常用的SQL片段记录下来，当我们需要引用的时候

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

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

七、MyBatis的缓存

7.1 MyBatis的一级缓存

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

使一级缓存失效的四种方式：

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

7.2 MyBatis的二级缓存

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

使二级缓存失效的情况：两次查询直接执行了任意的增删改操作，会使一级和二级缓存同时失效。

二级缓存开启的条件：

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

7.2.1 二级缓存的相关设置

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

7.3 MyBatis的查询顺序

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

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

7.4.1 添加依赖

<dependency>
	<groupId>org.mybatis.cachesgroupId>
	<artifactId>mybatis-ehcacheartifactId>
	<version>1.2.1version>
dependency>

<dependency>
	<groupId>ch.qos.logbackgroupId>
	<artifactId>logback-classicartifactId>
	<version>1.2.3version>
dependency>

7.4.1.1 各个jar包的功能

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

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

名字必须叫ehcache.xml

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

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

7.4.3 设置二级缓存的类型

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

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

7.4.4 加入logback日志

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

<configuration debug="true">
    
    <appender name="STDOUT"
              class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            
            
            <pattern>[%d{HH:mm:ss.SSS}] [%-5level] [%thread] [%logger] [%msg]%npattern>
        encoder>
    appender>
    
    
    <root level="DEBUG">
        
        <appender-ref ref="STDOUT" />
    root>
    
    <logger name="com.atguigu.crowd.mapper" level="DEBUG"/>
configuration>

八、分页插件

8.1 添加依赖

<dependency>
	<groupId>com.github.pagehelpergroupId>
	<artifactId>pagehelperartifactId>
	<version>5.2.0version>
dependency>

8.2 配置分页插件

在MyBatis的核心配置文件（mybatis-config.xml）中配置插件

8.3 开启分页功能

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

@Test
public void testPageHelper() throws IOException {
	InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
	SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
	SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
	SqlSession sqlSession = sqlSessionFactory.openSession(true);
	EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
	//访问第一页，每页四条数据
	PageHelper.startPage(1,4);
	List<Emp> emps = mapper.selectByExample(null);
	emps.forEach(System.out::println);
}

8.4 获取分页相关的数据（重点）

分页插件的意义就是可以方便的获取关于分页的所有数据。

8.4.1 直接获取简易信息Page

@Test
public void testPageHelper() throws IOException {
	InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
	SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
	SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
	SqlSession sqlSession = sqlSessionFactory.openSession(true);
	EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
	//访问第一页，每页四条数据
	Page<Object> page = PageHelper.startPage(1, 4);
	List<Emp> emps = mapper.selectByExample(null);
	//在查询到List集合后，打印分页数据
	System.out.println(page);
}

分页相关数据：

Page{count=true, pageNum=1, pageSize=4, startRow=0, endRow=4, total=8, pages=2, reasonable=false, pageSizeZero=false}
[Emp{eid=1, empName='admin', age=22, sex='男', email='456@qq.com', did=3}, Emp{eid=2, empName='admin2', age=22, sex='男', email='456@qq.com', did=3}, Emp{eid=3, empName='王五', age=12, sex='女', email='123@qq.com', did=3}, Emp{eid=4, empName='赵六', age=32, sex='男', email='123@qq.com', did=1}]

8.4.2 获取PageInfo

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

@Test
public void testPageHelper() throws IOException {
	InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
	SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
	SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
	SqlSession sqlSession = sqlSessionFactory.openSession(true);
	EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
	PageHelper.startPage(1, 4);
	List<Emp> emps = mapper.selectByExample(null);
	PageInfo<Emp> page = new PageInfo<>(emps,5);
	System.out.println(page);
}

分页相关数据：

• 其中list相当于8.4.1中获取的Page数据

PageInfo{pageNum=1, pageSize=4, size=4, startRow=1, endRow=4, total=8, pages=2, 
         
list=Page{count=true, pageNum=1, pageSize=4, startRow=0, endRow=4, total=8, pages=2, reasonable=false, pageSizeZero=false}
         
[Emp{eid=1, empName='admin', age=22, sex='男', email='456@qq.com', did=3}, Emp{eid=2, empName='admin2', age=22, sex='男', email='456@qq.com', did=3}, Emp{eid=3, empName='王五', age=12, sex='女', email='123@qq.com', did=3}, Emp{eid=4, empName='赵六', age=32, sex='男', email='123@qq.com', did=1}], 

prePage=0, nextPage=2, isFirstPage=true, isLastPage=false, hasPreviousPage=false, hasNextPage=true, navigatePages=5, navigateFirstPage=1, navigateLastPage=2, navigatepageNums=[1, 2]}

相关数据：

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

九、MyBatis的逆向工程

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

9.1 创建逆向工程的步骤

9.1.1 添加依赖和插件

<dependencies>
	
	<dependency>
		<groupId>org.mybatisgroupId>
		<artifactId>mybatisartifactId>
		<version>3.5.9version>
	dependency>
	
	<dependency>
		<groupId>junitgroupId>
		<artifactId>junitartifactId>
		<version>4.13.2version>
		<scope>testscope>
	dependency>
	
	<dependency>
		<groupId>mysqlgroupId>
		<artifactId>mysql-connector-javaartifactId>
		<version>8.0.27version>
	dependency>
	
	<dependency>
		<groupId>log4jgroupId>
		<artifactId>log4jartifactId>
		<version>1.2.17version>
	dependency>
dependencies>

<build>
	
	<plugins>
		
		<plugin>
			<groupId>org.mybatis.generatorgroupId>
			<artifactId>mybatis-generator-maven-pluginartifactId>
			<version>1.3.0version>
			
			<dependencies>
				
				<dependency>
					<groupId>org.mybatis.generatorgroupId>
					<artifactId>mybatis-generator-coreartifactId>
					<version>1.3.2version>
				dependency>
				
				<dependency>
					<groupId>com.mchangegroupId>
					<artifactId>c3p0artifactId>
					<version>0.9.2version>
				dependency>
				
				<dependency>
					<groupId>mysqlgroupId>
					<artifactId>mysql-connector-javaartifactId>
					<version>8.0.27version>
				dependency>
			dependencies>
		plugin>
	plugins>
build>

9.1.2 创建MyBatis的核心配置文件

DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <properties resource="jdbc.properties"/>
    <typeAliases>
        <package name=""/>
    typeAliases>
    <environments default="development">
        <environment id="development">
            <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=""/>
    mappers>
configuration>

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

• 文件名必须是：generatorConfig.xml

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="MyBatis3Simple">
        
        <jdbcConnection driverClass="com.mysql.cj.jdbc.Driver"
                        connectionURL="jdbc:mysql://localhost:3306/mybatis"
                        userId="root"
                        password="123456">
        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>

9.1.4 执行MBG插件的generate功能

• 如果出现报错：Exception getting JDBC Driver，可能是pom.xml中，数据库驱动配置错误
  • mybatis-generator-maven-plugin插件中的驱动
  • 两者的驱动版本应该相同

9.2 QBC

9.2.1 查询

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

@Test public void testMBG() throws IOException {
	InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
	SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
	SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
	SqlSession sqlSession = sqlSessionFactory.openSession(true);
	EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
	EmpExample example = new EmpExample();
	//名字为张三，且年龄大于等于20
	example.createCriteria().andEmpNameEqualTo("张三").andAgeGreaterThanOrEqualTo(20);
	//或者did不为空
	example.or().andDidIsNotNull();
	List<Emp> emps = mapper.selectByExample(example);
	emps.forEach(System.out::println);
}

9.2.2 增改

• updateByPrimaryKey：通过主键进行数据修改，如果某一个值为null，也会将对应的字段改为null
  • mapper.updateByPrimaryKey(new Emp(1,"admin",22,null,"[email protected]",3));
• updateByPrimaryKeySelective()：通过主键进行选择性数据修改，如果某个值为null，则不修改这个字段
  • mapper.updateByPrimaryKeySelective(new Emp(2,"admin2",22,null,"[email protected]",3));
    用bigint因为mybatis生成ID用雪花算法，生成id比较长

十、Mybatis-Plus

10.1 简介

MyBatis-Plus （简称 MP）是一个 MyBatis 的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。

愿景

我们的愿景是成为 MyBatis 最好的搭档，就像 魂斗罗 中的 1P、2P，基友搭配，效率翻倍。

10.2 特性

• 无侵入：只做增强不做改变，引入它不会对现有工程产生影响，如丝般顺滑
• 损耗小：启动即会自动注入基本 CURD，性能基本无损耗，直接面向对象操作
• 强大的 CRUD 操作：内置通用 Mapper、通用 Service，仅仅通过少量配置即可实现单表大部分 CRUD 操作，更有强大的条件构造器，满足各类使用需求
• 支持 Lambda 形式调用：通过 Lambda 表达式，方便的编写各类查询条件，无需再担心字段写错
• 支持主键自动生成：支持多达 4 种主键策略（内含分布式唯一 ID 生成器 - Sequence），可自由配置，完美解决主键问题
• 支持 ActiveRecord 模式：支持 ActiveRecord 形式调用，实体类只需继承 Model 类即可进行强大的 CRUD 操作
• 支持自定义全局通用操作：支持全局通用方法注入（ Write once, use anywhere ）
• 内置代码生成器：采用代码或者 Maven 插件可快速生成 Mapper 、 Model 、 Service 、 Controller 层代码，支持模板引擎，更有超多自定义配置等您来使用
• 内置分页插件：基于 MyBatis 物理分页，开发者无需关心具体操作，配置好插件之后，写分页等同于普通 List 查询
• 分页插件支持多种数据库：支持 MySQL、MariaDB、Oracle、DB2、H2、HSQL、SQLite、Postgre、SQLServer 等多种数据库
• 内置性能分析插件：可输出 SQL 语句以及其执行时间，建议开发测试时启用该功能，能快速揪出慢查询
• 内置全局拦截插件：提供全表 delete 、 update 操作智能分析阻断，也可自定义拦截规则，预防误操作

10.3 框架结构

个人理解：

使用Mybatis-plus后，sql语句动态生成，当前操作的表由实体类决定，所以首先扫描实体，通过反射机制，将实体类中的属性进行抽取，分析实体类和表的关系，实体类中的属性与表中的字段的关系，再根据调用的方法，动态的生成sql注入到Mybatis容器中

10.4 入门案例

引入依赖

	<dependencies>
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starterartifactId>
        dependency>

        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-testartifactId>
            <scope>testscope>
        dependency>

        
        <dependency>
            <groupId>com.baomidougroupId>
            <artifactId>mybatis-plus-boot-starterartifactId>
            <version>3.4.0version>
        dependency>

        
        <dependency>
            <groupId>org.projectlombokgroupId>
            <artifactId>lombokartifactId>
            <optional>trueoptional>
        dependency>

        
        <dependency>
            <groupId>mysqlgroupId>
            <artifactId>mysql-connector-javaartifactId>
            <scope>runtimescope>
        dependency>
    dependencies>

yml

spring:
  # 配置数据源信息
  datasource:
    # 配置数据源类型
    type: com.zaxxer.hikari.HikariDataSource
    # 配置连接数据库的连接信息
    driverClassName: com.mysql.cj.jdbc.Driver
    # mysql驱动5.7版本不需要设置时区 8版本需要设置时区，不然会报错
    url: jdbc:mysql://localhost:3306/db01?serverTimezone=GMT%2B8&characterEncoding=utf-8&useSSL=false
    username: root
    password: 467775

注意：

• 驱动类driver-class-name

  • spring boot 2.0（内置jdbc5驱动），驱动类使用：driver-class-name: com.mysql.jdbc.Driver
  • spring boot 2.1及以上（内置jdbc8驱动），驱动类使用：driver-class-name: com.mysql.cj.jdbc.Driver，否则运行测试用例的时候会有 WARN 信息。

• 连接地址url

  • MySQL5.7版本的url：jdbc:mysql://localhost:3306/mybatis_plus?characterEncoding=utf-8&useSSL=false
  • MySQL8.0版本的url：jdbc:mysql://localhost:3306/mybatis_plus?serverTimezone=GMT%2B8&characterEncoding=utf-8&useSSL=false
  • 否则运行测试用例报告如下错误：java.sql.SQLException: The server time zone value ‘Öйú±ê׼ʱ¼ä’ is unrecognized or represents more

启动类

@SpringBootApplication
@MapperScan("com.juice.mybatisplus.mapper")
public class MybatisPlusApplication {
    public static void main(String[] args) {
        SpringApplication.run(MybatisPlusApplication.class, args);
    }
}

在Springboot启动类中添加MapperScan注解，扫描指定包下mapper接口

实体类

package com.juice.mybatisplus.pojo;

import lombok.Data;

/**
 * @author juice
 * @version V1.00
 * @date : 2023/04/22 17:56
 * @since V1.00
 **/
@Data
public class User {

    private Long id;

    private String name;

    private Integer age;

    private String email;
}

• 注：@Data是lombok的注解，需要引入lombok依赖，@Data注解可以生成该类的无参构造、Getter、Setter方法、equals方法、hashcode方法、toString方法。

• lombok中还有其他注解：

@NoArgsConstructor // 无参构造
@AllArgsConstructor // 有参构造
@Getter // get方法
@Setter // set方法
@EqualsAndHashCode // equals方法、hashcode方法
@ToString // toString方法

Mapper接口继承通用接口BaseMapper

package com.juice.mybatisplus.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.juice.mybatisplus.pojo.User;
// UserMapper继承通用接口，通用接口中的方法也会被继承过来
public interface UserMapper extends BaseMapper<User> {
}

通用接口

package com.baomidou.mybatisplus.core.mapper;

import com.baomidou.mybatisplus.core.conditions.Wrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.core.toolkit.Constants;
import org.apache.ibatis.annotations.Param;

import java.io.Serializable;
import java.util.Collection;
import java.util.List;
import java.util.Map;

/**
 * Mapper 继承该接口后，无需编写 mapper.xml 文件，即可获得CRUD功能
 * 
这个 Mapper 支持 id 泛型
 *
 * @author hubin
 * @since 2016-01-23
 */
public interface BaseMapper<T> extends Mapper<T> {

    /**
     * 插入一条记录
     *
     * @param entity 实体对象
     */
    int insert(T entity);

    /**
     * 根据 ID 删除
     *
     * @param id 主键ID
     */
    int deleteById(Serializable id);

    /**
     * 根据 columnMap 条件，删除记录
     *
     * @param columnMap 表字段 map 对象
     */
    int deleteByMap(@Param(Constants.COLUMN_MAP) Map<String, Object> columnMap);

    /**
     * 根据 entity 条件，删除记录
     *
     * @param wrapper 实体对象封装操作类（可以为 null）
     */
    int delete(@Param(Constants.WRAPPER) Wrapper<T> wrapper);

    /**
     * 删除（根据ID 批量删除）
     *
     * @param idList 主键ID列表(不能为 null 以及 empty)
     */
    int deleteBatchIds(@Param(Constants.COLLECTION) Collection<? extends Serializable> idList);

    /**
     * 根据 ID 修改
     *
     * @param entity 实体对象
     */
    int updateById(@Param(Constants.ENTITY) T entity);

    /**
     * 根据 whereEntity 条件，更新记录
     *
     * @param entity        实体对象 (set 条件值,可以为 null)
     * @param updateWrapper 实体对象封装操作类（可以为 null,里面的 entity 用于生成 where 语句）
     */
    int update(@Param(Constants.ENTITY) T entity, @Param(Constants.WRAPPER) Wrapper<T> updateWrapper);

    /**
     * 根据 ID 查询
     *
     * @param id 主键ID
     */
    T selectById(Serializable id);

    /**
     * 查询（根据ID 批量查询）
     *
     * @param idList 主键ID列表(不能为 null 以及 empty)
     */
    List<T> selectBatchIds(@Param(Constants.COLLECTION) Collection<? extends Serializable> idList);

    /**
     * 查询（根据 columnMap 条件）
     *
     * @param columnMap 表字段 map 对象
     */
    List<T> selectByMap(@Param(Constants.COLUMN_MAP) Map<String, Object> columnMap);

    /**
     * 根据 entity 条件，查询一条记录
     *
     * @param queryWrapper 实体对象封装操作类（可以为 null）
     */
    T selectOne(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);

    /**
     * 根据 Wrapper 条件，查询总记录数
     *
     * @param queryWrapper 实体对象封装操作类（可以为 null）
     */
    Integer selectCount(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);

    /**
     * 根据 entity 条件，查询全部记录
     *
     * @param queryWrapper 实体对象封装操作类（可以为 null）
     */
    List<T> selectList(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);

    /**
     * 根据 Wrapper 条件，查询全部记录
     *
     * @param queryWrapper 实体对象封装操作类（可以为 null）
     */
    List<Map<String, Object>> selectMaps(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);

    /**
     * 根据 Wrapper 条件，查询全部记录
     * 
注意： 只返回第一个字段的值
     *
     * @param queryWrapper 实体对象封装操作类（可以为 null）
     */
    List<Object> selectObjs(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);

    /**
     * 根据 entity 条件，查询全部记录（并翻页）
     *
     * @param page         分页查询条件（可以为 RowBounds.DEFAULT）
     * @param queryWrapper 实体对象封装操作类（可以为 null）
     */
    <E extends IPage<T>> E selectPage(E page, @Param(Constants.WRAPPER) Wrapper<T> queryWrapper);

    /**
     * 根据 Wrapper 条件，查询全部记录（并翻页）
     *
     * @param page         分页查询条件
     * @param queryWrapper 实体对象封装操作类
     */
    <E extends IPage<Map<String, Object>>> E selectMapsPage(E page, @Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
}

测试类

@Test
    void testSelect(){
        // 根据条件查询器查询多条数据，没有条件是可以传null，即查全部 SELECT id,name,age,email FROM user
        List<User> users = userMapper.selectList(null);
        users.forEach(System.out::println);

        // 根据id查询 SELECT id,name,age,email FROM user WHERE id=?
        User user = userMapper.selectById(1L);
        System.out.println(user);

        // SELECT id,name,age,email FROM user WHERE id IN ( ? , ? )
        List<User> list = userMapper.selectBatchIds(Arrays.asList(1L, 2L));
        list.forEach(System.out::println);

        // 根据条件查询 SELECT id,name,age,email FROM user WHERE name = ? AND age = ?
        Map<String, Object> map = new HashMap<>(2);
        map.put("name","Billie");
        map.put("age",21);

        List<User> byMap = userMapper.selectByMap(map);
        byMap.forEach(System.out::println);

    }

    @Test
    void testAdd(){
        User juice = User.builder().name("juice").age(18).email("xxx").build();
        // 插入一个对象 INSERT INTO user ( id, name, age, email ) VALUES ( ?, ?, ?, ? )
        int insert = userMapper.insert(juice);
        System.out.println("插入的条数," + insert + "插入返回的id" + juice.getId() );

        // output: 插入的条数1,插入返回的id1649727353075281921
    }

    @Test
    void testDel(){
        // 根据主键id删除 DELETE FROM user WHERE id=?
        int i = userMapper.deleteById(1L);
        // 根据主键id批量删除 DELETE FROM user WHERE id IN ( ? , ? )
        int i1 = userMapper.deleteBatchIds(Arrays.asList(2L, 3L));
        // 根据map集合中设置的条件删除 DELETE FROM user WHERE name = ? AND id = ?
        Map<String, Object> map = new HashMap<>(2);
        map.put("id",4L);
        map.put("name","juice");
        int i2 = userMapper.deleteByMap(map);
    }

    @Test
    void testUpdate(){
        // 根据id去设置值，如果没有值不会设置，UPDATE user SET name=?, age=? WHERE id=?
        User juice = User.builder().name("juice").age(20).build();
        int i = userMapper.updateById(juice);
    }

注：使用Autowired，会报红，但是编译运行时没有异常，因为mapper接口在被扫描的时候，是将接口动态生成的的代理类注入到IOC容器中（ioc容器不会存放接口），所以ide在编译的时候会认为，mapper接口不能被自动装配，所以报红。

解决方法：**在mapper接口上加上@Repository，将他标记为类或接口标记成持久层组件，**报红就会消失。

日志功能

application.yml中加入

mybatis-plus:
  configuration:
    logImpl: org.apache.ibatis.logging.stdout.StdOutImpl

使用IService功能

package com.juice.mybatisplus.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.juice.mybatisplus.pojo.User;

public interface UserService extends IService<User> {
}

package com.juice.mybatisplus.service.impl;

import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.juice.mybatisplus.mapper.UserMapper;
import com.juice.mybatisplus.pojo.User;
import com.juice.mybatisplus.service.UserService;

/**
 * @author juice
 * @version V1.00
 * @date : 2023/04/22 20:47
 * @since V1.00
 **/
// UserService继承了IService，所以IService接口中的方法都会被继承到UserService中，当UserServiceImpl实现UserService接口，也需要全部重写其中的方法，所以需要继承IService的实现类ServiceImpl即可。
@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
}

说明:

• 通用 Service CRUD 封装IService接口，进一步封装 CRUD 采用 get 查询单行 remove 删除 list 查询集合 page 分页 前缀命名方式区分 Mapper 层避免混淆，
• 泛型 T 为任意实体对象
• 建议如果存在自定义通用 Service 方法的可能，请创建自己的 IBaseService 继承 Mybatis-Plus 提供的基类
• 对象 Wrapper 为 条件构造器

测试类

package com.juice.mybatisplus;

import com.juice.mybatisplus.pojo.User;
import com.juice.mybatisplus.service.UserService;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

import java.util.ArrayList;
import java.util.LinkedList;
import java.util.List;

@SpringBootTest
public class IServiceTest {

    @Autowired
    private UserService userService;

    @Test
    void testCount(){
        // SELECT COUNT( 1 ) FROM user
        int count = userService.count();
        System.out.println("条数" + count);
    }

    @Test
    void testSave(){
        List<User> list = new ArrayList<>(10);
        for (int i = 0; i < 10; i++) {
            User juice = User.builder().name("juice" + i).age(i).email("xxx" + i).build();
            list.add(juice);
        }
        // 批量添加也是通过循环插入，INSERT INTO user ( id, name, age, email ) VALUES ( ?, ?, ?, ? )
        boolean b = userService.saveBatch(list);

        // 根据判断id是否有值，没有id就是add，有id就是update
        List<User> list2 = new ArrayList<>(2);
        User add = User.builder().age(2).name("xxx").email("xxx").build();
        User update = User.builder().id(4L).name("update").build();
        list2.add(add);
        list2.add(update);
        boolean b1 = userService.saveOrUpdateBatch(list2);

    }
}

==> Preparing: INSERT INTO user ( id, name, age, email ) VALUES ( ?, ?, ?, ? )
> Parameters: 1649763169780727810(Long), xxx(String), 2(Integer), xxx(String)
> Preparing: SELECT id,name,age,email FROM user WHERE id=?
> Parameters: 4(Long)
< Columns: id, name, age, email
< Row: 4, Sandy, 21, [email protected]
< Total: 1

==> Preparing: UPDATE user SET name=? WHERE id=?
==> Parameters: update(String), 4(Long)

saveOrUpdateBatch，根据判断id是否有值，没有id就是add，有id就是update

本篇博客，根据尚硅谷杨博超老师的MyBatis的教程学习所记，地址如下：尚硅谷-Mybatisspm_id_from=333.1007.top_right_bar_window_history.content.click如有不正确的地方，欢迎同学们指正，喜欢的话，欢迎点赞收藏评论哦~