MyBatis-Plus 简介与入门案例

官方是这样介绍Mybatis-Plus的，MyBatis-Plus 是一个 MyBatis 的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。我觉得它们之间的关系有点类似于Spring与 Spring Boot之间的关系。Spring Boot是为了简化Spring开发。MyBatis-Plus对MyBatis做了增强功能以简化MyBatis的开发。

MyBatis-Plus支持多种数据库，包括mysql 、mariadb 、oracle 、db2 、h2 、hsql 、 sqlite 、 postgresql 、sqlserver以及 达梦数据库、虚谷数据库、人大金仓数据库。

MyBatis-Plus 特性

MyBatis-Plus官方很好的介绍了MyBatis-Plus的特性与功能，如下为官方介绍的MyBatis-Plus的特性：

• 无侵入：只做增强不做改变，引入它不会对现有工程产生影响，如丝般顺滑
• 损耗小：启动即会自动注入基本 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 操作智能分析阻断，也可自定义拦截规则，预防误操作

就像使用Spring Boot类似，我们可以以最少的配置使用Spring，Mybatis-Plus也可以使用最少的配置来使用Mybatis，并且很容易和Spring和Spring Boot集成在一起使用。本专栏博客所有案例都使用Spring Boot+MyBatis-Plus作为测试案例。 

依赖的引入

就像Spring Boot 的SpringBoot的starter的jar包一样，MyBatis-Plus也提供了starter包，我们只需要引入MyBatis-Plus包即可：

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

因为我们采用Spring Boot框架并且要连接数据库，所以我们还需要引入Spring Boot和数据库连接相关包，这里我们使用阿里巴巴的druid连接池。

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
</dependency>
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid</artifactId>
    <version>1.0.29</version>
</dependency>

数据库与表的创建

CREATE TABLE `sys_user` (
  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
  `username` varchar(100) DEFAULT NULL,
  `password` varchar(100) DEFAULT NULL COMMENT '登录密码',
  `nickname` varchar(30) DEFAULT '' COMMENT '昵称',
  `mobile` varchar(30) DEFAULT NULL COMMENT '手机号',
  `avatar` varchar(255) DEFAULT NULL COMMENT '头像地址',
  `remark` varchar(100) DEFAULT NULL COMMENT '用户备注',
  `status` int(1) unsigned DEFAULT NULL COMMENT '用户状态',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '注册时间',
  `update_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8 ROW_FORMAT=DYNAMIC;

配置与启动类编写

spring:
   application:
      name: mybatisplus-starter
   datasource:
      type: com.alibaba.druid.pool.DruidDataSource
      url: jdbc:mysql://localhost:3306/mybatisplus?allowMultiQueries=true      username: root
      password: 123456

@SpringBootApplication
@MapperScan(basePackages={"cn.org.microservice.mybatisplus.starter.mapper"})
public class MyBatisPlusApplication {
    public static void main(String[] args) {
	SpringApplication.run(MyBatisPlusApplication.class, args);
    }
}

Mapper与测试类

如下为MyBatis的一个Mapper类，与直接使用MyBatis不同的是，它继承了一个BaseMapper<T>,BaseMapper<T>,为MyBatis-Plus为我们提供的基础Mapper。如果不使用Mybatis-Plus，我们进行简单的单表的增删改查也需要在mapper.xml写对应的sql语句，显得过于复杂，而BaseMapper<T>则让我们不用写SQL语句就能实现简单的单表查询以及分页。

public interface SysUserMapper extends BaseMapper<SysUser> {
}

 如下测试类中，我们没有写任何的SQL语句，但是我们通过了SysUserMapper实例往数据库插入了一条用户信息，这只是MyBatis-Plus的一条简单的特性，后续我们会详细讲解BaseMapper<T>以及MyBatis-Plus原理。

@RunWith(SpringRunner.class)
@SpringBootTest
public class SysUserMapperTest {
	@Autowired
	private SysUserMapper sysUserMapper;
	//打印出SysUserMapper实例
	@Test
	public void outputInstance() {
		System.out.println(sysUserMapper);
	}
	//往用户表插入一条数据
	@Test
	public void insertSysUser() {
		SysUser entity = new SysUser();
		entity.setUsername("wangke");
		entity.setAvatar("/users/wangke.png");
		entity.setCreateTime("2020-05-22 17:45:34");
		entity.setMobile("18595317730");
		entity.setNickname("wangke");
		entity.setPassword("123456");
		entity.setRemark("超级管理员");
		entity.setStatus(1);
		entity.setUpdateTime("2020-05-22 17:45:34");
		sysUserMapper.insert(entity);
	}
}