第一章:MyBatis-Plus 实战入门

大家好, 我是上白书妖!

知识源于积累,登峰造极源于自律

今天我根据以前所以学的一些文献,笔记等资料整理出一些小知识点

一、简介

MyBatis-Plus（简称 MP）是一个 MyBatis 的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。
简介：MyBatis-Plus快速入门官网指南
参考教程：MyBatis-Plus快速入门官网指南

二、创建并初始化数据库

1、创建数据库

mybatis_plus

2、创建 User 表

表结构图:

id	name	age	email
1	上白书妖	20	shangbaishuyao@163.com
2	西门吹嘘	23	ximenchuicu@163.com
3	东方不败	25	dongfangbubai@163.com
4	独孤一拜	23	duguqiubai@163.com
5	齐天大圣	999	qitiandashneg@163.com

其对应的数据库 Schema (模式,架构)脚本如下：

DROP TABLE IF EXISTS user; 

CREATE TABLE user
(
	id BIGINT(20) NOT NULL COMMENT '主键ID',
	name VARCHAR(30) NULL DEFAULT NULL COMMENT '姓名',
	age INT(11) NULL DEFAULT NULL COMMENT '年龄',
	email VARCHAR(50) NULL DEFAULT NULL COMMENT '邮箱',
	PRIMARY KEY (id)
);

其对应的数据库 Data 脚本如下：

DELETE FROM user;

INSERT INTO user (id, name, age, email) VALUES
(1, '上白书妖', 20, 'shangbaishuyao@163.com'),
(2, '西门吹嘘', 23, 'ximenchuicu@163.com'),
(3, '东方不败', 25, 'dongfangbubai@163.com'),
(4, '独孤一拜', 23, 'duguqiubai@163.com'),
(5, '齐天大圣', 999, 'qitiandashneg@163.com');

三、初始化工程

使用 Spring Initializr 快速初始化一个 Spring Boot 工程

四、添加依赖

1.添加依赖

注意：引入 MyBatis-Plus 之后请不要再次引入 MyBatis 以及 MyBatis-Spring，以避免因版本差异导致的问题。

<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter</artifactId>
		</dependency>

		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>

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

		<!--mysql-->
		<dependency>
			<groupId>mysql</groupId>
			<artifactId>mysql-connector-java</artifactId>
		</dependency>
        
        <!--lombok用来简化实体类-->
		<dependency>
			<groupId>org.projectlombok</groupId>
			<artifactId>lombok</artifactId>
		</dependency>

	</dependencies>

2、idea中安装lombok插件

五、配置

在 application.properties 配置文件中添加 MySQL 数据库的相关配置：

#mysql数据库连接
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.url=jdbc:mysql://114.55.29.125:3306/mybatis_plus?useSSL=false
spring.datasource.username=root
spring.datasource.password=root

#mybatis日志
mybatis-plus.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl

spring boot 2.1
注意：driver和url的变化

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://114.55.29.125:3306/mybatis_plus?serverTimezone=GMT%2B8
spring.datasource.username=root
spring.datasource.password=root

注意：
1、这里的 url 使用了 ?serverTimezone=GMT%2B8 后缀，因为Spring Boot 2.1 集成了 8.0版本的jdbc驱动，这个版本的 jdbc 驱动需要添加这个后缀，否则运行测试用例报告如下错误：
java.sql.SQLException: The server time zone value ‘Öйú±ê׼ʱ¼ä’ is unrecognized or represents more
2、这里的 driver-class-name 使用了 com.mysql.cj.jdbc.Driver ，在 jdbc 8 中 建议使用这个驱动，否则运行测试用例的时候会有 WARN 信息

六、编写代码

1.主类

在 Spring Boot 启动类中添加 @MapperScan 注解，扫描 Mapper 文件夹

@SpringBootApplication
@MapperScan("com.atguigu.mybatis_plus.mapper")
public class MybatisPlusApplication
{
	......
}

2、实体

创建包 entity 编写实体类 User.java（此处使用了 Lombok 简化代码）

@Data
public class User
 {
    private Long id;
    private String name;
    private Integer age;
    private String email;
}

查看编译结果:

3、mapper

创建包 mapper 编写Mapper 接口： UserMapper.java

public interface UserMapper extends BaseMapper<User>
{
    
}

七、开始使用

添加测试类，进行功能测试：

@RunWith(SpringRunner.class)
@SpringBootTest
public class MybatisPlusApplicationTests 
{

    @Autowired
    private UserMapper userMapper;

    @Test
    public void testSelectList() 
    {
        //UserMapper 中的 selectList() 方法的参数为 MP 内置的条件封装器 Wrapper
        //所以不填写就是无任何条件
        List<User> users = userMapper.selectList(null);
        users.forEach(System.out::println);
    }
}

注意：
IDEA在 userMapper 处报错，因为找不到注入的对象，因为类是动态创建的，但是程序可以正确的执行。
为了避免报错，可以在 dao 层 的接口上添加 @Repository 注
控制台输出：

User(id=1, name=上白书妖, age=20, email=shangbaishuyao@163.com)
User(id=2, name=西门吹嘘, age=23, email=ximenchuicu@163.com)
User(id=3, name=东方不败, age=20, email=dongfangbubai@163.com)
User(id=4, name=独孤一拜, age=23, email=duguqiubai@163.com)
User(id=5, name=齐天大圣, age=999, email=qitiandashneg@163.com)

通过以上几个简单的步骤，我们就实现了 User 表的 CRUD 功能，甚至连 XML 文件都不用编写！

上白书妖结束寄语:
知识源于积累,登峰造极源于自律