Spring Boot 学习(11)整合MyBatis-Plus

写在前面:最近利用晚上的时间在网上看视频学习Spring Boot,这博客是对学习的一点点总结及记录,技术是开源的、知识是共享的
如果你对Spring Boot 感兴趣,可以关注我的动态,我们一起学习。用知识改变命运,让家人过上更好的生活

一、Mybatis-Plus 介绍

1. 什么是 Mybatis-Plus

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

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 操作智能分析阻断,也可自定义拦截规则,预防误操作

二、设计建表结构

现有一张 user 表,其表结构如下:
在这里插入图片描述

CREATE TABLE `user` (
  `id` bigint(20) NOT NULL COMMENT '主键ID',
  `NAME` varchar(30) DEFAULT NULL COMMENT '姓名',
  `age` int(11) DEFAULT NULL COMMENT '年龄',
  `email` varchar(50) DEFAULT NULL COMMENT '邮箱',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

三、搭建工程

工程目录结构

在这里插入图片描述

1. 使用 Spring Initializer 初始化一个 Spring Boot 工程

需要引入项目所需要的依赖

pom.xml

	<properties>
        <java.version>1.8</java.version>
    </properties>

    <!-- 引入 Spring Boot Starter 父工程 -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.2.2.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <dependencies>

        <!-- 引入 spring-boot-starter -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>

        <!-- spring-boot-starter-test -->
        <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>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

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

# 数据库配置
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/guli_edu?serverTimezone=GMT%2B8
spring.datasource.username=root
spring.datasource.password=root

# mybatis日志(控制台显示sql语句)
mybatis-plus.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl

3. 配置 MapperScan 注解

在 Spring Boot 启动类中添加 @MapperScan 注解

注解的作用是扫描 Mapper 文件夹

@SpringBootApplication
@MapperScan("com.zxy.mpdemo.mapper")
public class MainApplication {

    public static void main(String[] args) {
        SpringApplication.run(MainApplication.class, args);
    }

}

四、Mybatis-Plus入门

1. 编写实体类

注意: 在此处使用了 Lombok 简化代码,不需要写Getter和Setter 方法。需要在Class 上面加 @Data这个注解

User.java

@Data
public class User {

    private Long id;       // 用户id
    private String name;   // 用户名
    private Integer age;   // 用户年龄
    private String email;  // 用户邮箱
}

2. 编写Mapper类

UserMapper.java

@Repository
public interface UserMapper extends BaseMapper<User> {

}

注意:

Mapper 需要继承 BaseMapper 接口,继承该接口后,无需编写 mapper.xml 文件,即可获得CRUD功能。

在这里插入图片描述
说明:

通用 CRUD 封装BaseMapper接口,为 Mybatis-Plus 启动时自动解析实体表关系映射转换为 Mybatis 内部对象注入容器

泛型 T 为任意实体对象

3. 添加测试类,进行功能测试

@SpringBootTest
public class DemoTest {

    @Autowired
    private UserMapper userMapper;

    /**
     * 查询所有的用户
     */
    @Test
    public void testGetAllUser() {

        List<User> users = userMapper.selectList(null);
        for (int i = 0; i < users.size(); i++) {
            System.out.println(users.get(i));
        }
    }
}

控制台输出结果:
在这里插入图片描述

User(id=1, name=parker, age=18, email=parker@126.com)
User(id=2, name=manu, age=16, email=manu@qq.com)
User(id=3, name=扬帆向海, age=19, email=yang@126.com)

五、分页

MyBatis Plus自带分页插件,只要简单的配置即可实现分页功能

1. 创建配置类

@EnableTransactionManagement
@Configuration
@MapperScan("com.baomidou.cloud.service.*.mapper*")
public class MybatisPlusConfig {

    @Bean
    public PaginationInterceptor paginationInterceptor() {
        PaginationInterceptor paginationInterceptor = new PaginationInterceptor();
        // 设置请求的页面大于最大页后操作, true调回到首页,false 继续请求  默认false
        // paginationInterceptor.setOverflow(false);
        // 设置最大单页限制数量,默认 500 条,-1 不受限制
        // paginationInterceptor.setLimit(500);
        return paginationInterceptor;
    }
}

2. 测试分页功能

	/**
     * mp实现分页
     */
    @Test
    public void testPage() {

        // 创建page对象,传递两个参数:当前页和每页记录数
        Page<User> page = new Page<>(1, 3);
        // 分页查询
        userMapper.selectPage(page, null);
        // 通过page对象获取分页数据
        List<User> records = page.getRecords(); // 每页数据
        long current = page.getCurrent(); // 当前页
        long pages = page.getPages();// 总页数
        long total = page.getTotal();// 总记录数
        long size = page.getSize();// 每页记录数
        boolean previous = page.hasPrevious();// 是否有上一页
        boolean next = page.hasNext();// 是否有下一页

        System.out.println(records);
        System.out.println(current);
        System.out.println(pages);
        System.out.println(total);
        System.out.println(size);
        System.out.println(previous);
        System.out.println(next);
    }

六、自动填充功能

项目中经常会遇到一些数据,每次都使用相同的方式填充,例如记录的创建时间,更新时间等。

我们可以使用MyBatis Plus的自动填充功能,完成这些字段的赋值工作:

1. 数据库表中添加自动填充字段

在User表中添加datetime类型的新的字段 create_time、update_time

2. 实体上添加注解

@Data
public class User {

	// 为了节约篇幅,在此删除了其他属性字段
	
    @TableField(fill = FieldFill.INSERT)
    private Date createTime; // 创建时间
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private Date updateTime; // 修改时间
}

3. 实现元对象处理器接口

@Component
public class MyMetaObjectHandler implements MetaObjectHandler {

    /**
     * 在mp执行添加操作的时候运行(会将createTime和updateTime加入到数据库中)
     *
     * @param metaObject
     */
    @Override
    public void insertFill(MetaObject metaObject) {

        this.setFieldValByName("createTime", new Date(), metaObject);
        this.setFieldValByName("updateTime", new Date(), metaObject);
    }

    /**
     * 在mp执行修改操作的时候运行
     *
     * @param metaObject
     */
    @Override
    public void updateFill(MetaObject metaObject) {

        this.setFieldValByName("updateTime", new Date(), metaObject);
    }
}

七、逻辑删除

  • 物理删除:真实删除,将对应数据从数据库中删除,之后查询不到此条被删除数据

  • 逻辑删除:假删除,将对应数据中代表是否被删除字段状态修改为“被删除状态”,之后在数据库中仍旧能看到此条数据记录

1.数据库中添加 deleted字段

ALTER TABLE `user` ADD COLUMN `deleted` boolean

2. 实体类添加deleted 字段

注意:需要加上 @TableLogic 注解 和 @TableField(fill = FieldFill.INSERT) 注解

@TableField(fill = FieldFill.INSERT)
@TableLogic // 用于逻辑删除的注解
private Integer deleted; // 逻辑删除标记

3. 元对象处理器接口添加deleted的insert默认值

@Component
public class MyMetaObjectHandler implements MetaObjectHandler {

    @Override
    public void insertFill(MetaObject metaObject) {
        // 添加逻辑删除的默认值
        this.setFieldValByName("deleted", 0, metaObject);
    }

4. application.properties 加入配置

此为默认值,如果你的默认值和mp默认的一样,该配置可无

# 0表示没删除,1表示删除
mybatis-plus.global-config.db-config.logic-delete-value=1
mybatis-plus.global-config.db-config.logic-not-delete-value=0

5. 在 MybatisPlusConfig 中注册 Bean

@EnableTransactionManagement // 事务
@Configuration // 标明是一个配置类
@MapperScan("com.zxy.mpdemo.mapper")
public class MybatisPlusConfig {
    /**
     * 逻辑删除
     *
     * @return
     */
    @Bean
    public ISqlInjector sqlInjector() {
        return new LogicSqlInjector();
    }
}

八、乐观锁

意图:

当要更新一条记录的时候,希望这条记录没有被别人更新

乐观锁实现方式:

取出记录时,获取当前version
更新时,带上这个version
执行更新时, set version = newVersion where version = oldVersion
如果version不对,就更新失败

1. 数据库中添加version字段

ALTER TABLE `user` ADD COLUMN `version` INT

2. 实体类添加version字段

添加 @Version 注解

@TableField(fill = FieldFill.INSERT) 
@Version
private Integer version; // 乐观锁版本号

3. 元对象处理器接口添加version的insert默认值

@Override
    public void insertFill(MetaObject metaObject) {

        // 添加乐观锁的默认版本是1
        this.setFieldValByName("version", 1, metaObject);
    }

注意:

  • 支持的数据类型只有 int,Integer,long,Long,Date,Timestamp,LocalDateTime
  • 整数类型下 newVersion = oldVersion + 1
  • newVersion 会回写到 entity 中
  • 仅支持 updateById(id) 与 update(entity, wrapper) 方法
  • 在 update(entity, wrapper) 方法下, wrapper 不能复用!!!

4. 在 MybatisPlusConfig 中注册 Bean

	/**
     * 乐观锁插件
     *
     * @return
     */
    @Bean
    public OptimisticLockerInterceptor optimisticLockerInterceptor() {
        return new OptimisticLockerInterceptor();
    }


由于水平有限,本博客难免有不足,恳请各位大佬不吝赐教!

发布了81 篇原创文章 · 获赞 1441 · 访问量 20万+
展开阅读全文

没有更多推荐了,返回首页

©️2019 CSDN 皮肤主题: 鲸 设计师: meimeiellie

分享到微信朋友圈

×

扫一扫,手机浏览