MyBatis-Plus：快速入门

1. 概念

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

* **无侵入**：只做增强不做改变，引入它不会对现有工程产生影响，如丝般顺滑
* **强大的 CRUD 操作**：内置通用 Mapper、通用 Service，提供了大量的通用的CRUD方法，因此可以省去大量手写sql的语句的工作。
* **条件构造器**：提供了强大的条件构造器，可以构造各种复杂的查询条件，以应对各种复杂查询。
* **内置分页插件**：配置好插件之后，写分页等同于普通 List 查询，无需关注分页逻辑。

2. 与springboot集成 

导入依赖

<dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-boot-starter</artifactId><version>3.5.3.2</version>
</dependency>

 3. 创建实体类

@Data
@TableName("user")
public class User {@TableId(value = "id", type = IdType.AUTO)private Long id;@TableField("name")private String name;@TableField("age")private Integer age;@TableField("email")private String email;
}

 * @TableName`：表名注解，用于标识实体类所对应的表
  
  * `value`：用于声明表名
* `@TableId`：主键注解，用于标识主键字段
  
  * `value`：用于声明主键的字段名
  * `type`：用于声明主键的生成策略，常用的策略有`AUTO`、`ASSIGN_UUID`、`INPUT`等等
* `@TableField`：普通字段注解，用于标识属性所对应的表字段
  
  * `value`：用于声明普通字段的字段名

4. 通用Mapper 

 1. 创建Mapper接口，并继承由Mybatis-plus提供的BaseMapper<T>接口

@Mapper
public interface UserMapper extends BaseMapper<User> {IPage<User> selectUserPage(IPage<User> page);
}

若Mapper接口过多，可不用逐一配置`@Mapper`注解，而使用`@MapperScan`注解指定包扫描路径进行统一管理，例如

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

2. 测试Mapper

@SpringBootTest
class UserMapperTest {@Autowiredprivate UserMapper userMapper;@Testpublic void testSelectUser() {List<User> users = userMapper.selectList(null);users.forEach(System.out::println);Long count = userMapper.selectCount(null);System.out.println("count=" + count);}
}

5. 通用Service

 通用Service进一步封装了通用Mapper的CRUD方法，并提供了例如`saveOrUpdate`、`saveBatch`等高级方法。

1.定义service接口 

//定义业务接口，需要继承IService类
public interface UserService extends IService<User> {
}

2.创建service实体类

//服务层
@Service
//mybatis-plus：业务实现类需继承ServiceImpl类，并将Mapper接口类和pojo类传入
//底层是将Mapper类进一步封装而来使得业务层直接调用
//并且实现业务接口类，即使得控制层调用业务方法也形成规范
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {}

测试

@SpringBootTest
class UserServiceImplTest {@Autowiredprivate UserServiceImpl userService;@Testpublic void testUserService() {Optional<User> optById = userService.getOptById(1);System.out.println(optById);}
}

6. 条件构造器

@SpringBootTest
public class WrapperTest {@AutowiredUserService userService;@Autowiredprivate ServiceImpl service;//QueryWrapper条件构造器，通过该构造器构造查询的过滤条件@Testpublic void testQueryWrapper() {//wrapper会将过滤条件添加到sql语句中//1.查询name=Tom的数据QueryWrapper<User> queryWrapper1 = new QueryWrapper<>();queryWrapper1.eq("name", "Tom");//2.模糊匹配QueryWrapper<User> queryWrapper2 = new QueryWrapper<>();queryWrapper2.like("email", ".com");//3.根据年龄降序排序并将结果打印QueryWrapper<User> queryWrapper3 = new QueryWrapper<>();queryWrapper3.orderByDesc("age");//4.查询年龄大于等于20小于等于30QueryWrapper<User> queryWrapper4 = new QueryWrapper<>();queryWrapper4.ge("age", 20).le("age", 30);//5.查询年龄小于20或者大于30的用户数据QueryWrapper<User> queryWrapper5 = new QueryWrapper<>();queryWrapper5.le("age", 20).or().ge("age", 30);//6.查询以.com结尾 and (age < 20 or age > 30)//and里面传递参数为要过滤的条件QueryWrapper<User> queryWrapper = new QueryWrapper<>();queryWrapper.like("email", ".com").and(QueryWrapper -> QueryWrapper.le("age", 20).or().ge("age", 30));List list = service.list(queryWrapper);list.forEach(System.out::println);}//UpdateWrapper更新删除的条件构造器@Testpublic void testUpdateWrapper() {UpdateWrapper<User> updateWrapper = new UpdateWrapper<>();updateWrapper.eq("name", "Tom").set("name", "ESon");boolean update = service.update(updateWrapper);System.out.println("update=" + update);}//LambdaQueryWrapper构造器，里面通过方法引用传递参数//优点：减少手敲字段带来不必要的错误，提高开发效率@Testpublic void testLambdaQueryWrapper() {LambdaQueryWrapper<User> lambdaQueryWrapper = new LambdaQueryWrapper<>();lambdaQueryWrapper.eq(User :: getName, "ESon");List<User> list = userService.list(lambdaQueryWrapper);list.forEach(System.out :: println);}//LambdaUpdateWrapper构造器@Testpublic void testLambdaUpdateWrapper() {LambdaUpdateWrapper<User> lambdaUpdateWrapper = new LambdaUpdateWrapper<>();lambdaUpdateWrapper.eq(User :: getName, "ESon").set(User :: getName, "Tom");boolean update = userService.update(lambdaUpdateWrapper);System.out.println("update=" + update);}
}

7. 分页插件

 1.配置分页插件

@Configuration
public class MPConfiguration {@Beanpublic MybatisPlusInterceptor mybatisPlusInterceptor() {MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));return interceptor;}
}

核心

| 属性名  | 类型 | 默认值    | 描述                   |
| ------- | ---- | --------- | ---------------------- |
| records | List | emptyList | 查询数据列表           |
| total   | Long | 0         | 查询列表总记录数       |
| size    | Long | 10        | 每页显示条数，默认`10` |
| current | Long | 1         | 当前页                 |

分页对象既作为分页查询的参数，也作为分页查询的返回结果，当作为查询参数时，通常只需提供`current`和`size`属性，如下

```java
IPage<T> page = new Page<>(current, size);
```

注：`IPage`为分页接口，`Page`为`IPage`接口的一个实现类。

 自定义分页查询

在Mapper接口中定义分页查询方法

@Mapper
public interface UserMapper extends BaseMapper<User> {IPage<User> selectUserPage(IPage<User> page);
}

 创建`resources/mapper/UserMapper.xml`文件，内容如下

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.itgyl.mapper.UserMapper"><select id="selectUserPage" resultType="com.itgyl.entity.User">select *from user</select>
</mapper>

**注意**：Mybatis-Plus中`Mapper.xml`文件路径默认为：`classpath*:/mapper/**/*.xml`，可在`application.yml`中配置以下参数进行修改 

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

2.测试 

@SpringBootTest
public class PageTest {@Autowiredprivate UserMapper userMapper;@Autowiredprivate UserService userService;@Testpublic void testPageService() {//创建分页对象，将按照传递的参数进行分页，此时展示第二页的两条数据（current：展示第几页 size：每页多少条数据）Page<User> userPage = new Page<>(2, 2);//调用通用service层方法进行分页查询，最终将分页结果返回Page<User> result = userService.page(userPage);result.getRecords().forEach(System.out::println);}@Testpublic void testPageMapper() {Page<User> userPage = new Page<>(2, 2);Page<User> result = userMapper.selectPage(userPage, null);result.getRecords().forEach(System.out::println);}//自定义分页查询，可用于处理复杂业务@Testpublic void testSelectPage() {Page<User> userPage = new Page<>(2,2);IPage<User> result = userMapper.selectUserPage(userPage);result.getRecords().forEach(System.out::println);}
}