Fluent Mybatis让你摆脱Xml文件的技巧

来源：jb51　　时间：2021/8/4 17:56:00　　对本文有异议

一、啥是Fluent-Mybatis

与Mybatis-Plus类似，是对Mybaits进一步的封装，使之语法简洁明了，更重要的是不需要在自主创建Xml文件，可以只用一个实体类对象，通过代码生成器，在编译的过程中生成所需要的各类文件，简化了项目的基础构建，提高开发效率。

在这里插入图片描述

二、SpringBoot + Fluent-Mybatis

1、创建数据库测试表

DROP TABLE IF EXISTS `t_user`;
create table `t_user`
(
    id bigint auto_increment comment '主键ID' primary key,
    name varchar(30) charset utf8 null comment '姓名',
    age int null comment '年龄',
    email varchar(50) charset utf8 null comment '邮箱',
    gmt_create datetime null comment '记录创建时间',
    gmt_modified datetime null comment '记录最后修改时间',
    is_deleted tinyint(2) default 0 null comment '逻辑删除标识'
);

2、创建一个Springboot项目，pom文件如下

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.3.1.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.mybatis.fluent</groupId>
    <artifactId>fluent_mybatis</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>fluent_mybatis</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>1.8</java.version>
        <fluent.mybatis.version>1.5.6</fluent.mybatis.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <!--JDBC驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <scope>runtime</scope>
        </dependency>
        <!--Mybatis-->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>2.0.1</version>
        </dependency>
        <!-- fluent mybatis依赖-->
        <dependency>
            <groupId>com.github.atool</groupId>
            <artifactId>fluent-mybatis</artifactId>
            <version>${fluent.mybatis.version}</version>
        </dependency>
        <dependency>
            <groupId>com.github.atool</groupId>
            <artifactId>fluent-mybatis-processor</artifactId>
            <version>${fluent.mybatis.version}</version>
            <scope>provided</scope>
        </dependency>
 
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
            <exclusions>
                <exclusion>
                    <groupId>org.junit.vintage</groupId>
                    <artifactId>junit-vintage-engine</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>
 
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>
 
</project>

3、代码生成器

import cn.org.atool.generator.FileGenerator;
import cn.org.atool.generator.annotation.Table;
import cn.org.atool.generator.annotation.Tables;
 
public class AppEntityGenerator {
 
    public static void main(String[] args) {
        FileGenerator.build(Abc.class);
    }
 
    @Tables(
            /** 数据库连接信息 **/
            url = "jdbc:mysql://IP:3306/test?useSSL=false&useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai", 
            username = "XXXXXX",
            password = "XXXXXX",
            /** Entity类parent package路径 **/
            basePack = "com.mybatis.fluent.fluent_mybatis",
            /** Entity代码源目录 **/
            srcDir = "/src/main/java",
            /** Dao代码源目录 **/
            daoDir = "/src/main/java",
            /** 如果表定义记录创建，记录修改，逻辑删除字段 **/
            gmtCreated = "gmt_create", gmtModified = "gmt_modified", logicDeleted = "is_deleted",
            /** 需要生成文件的表 **/
            tables = @Table(value = {"t_user"})
    )
    static class Abc {
 
    }
}

需要注意，默认的是MySQL数据库，如果需要其他数据库，需要手动配置dbType和driver，其他选项按照需要修改。例如oralce

import cn.org.atool.generator.FileGenerator;
import cn.org.atool.generator.annotation.Table;
import cn.org.atool.generator.annotation.Tables;
import cn.org.atool.generator.database.DbType;
 
public class AppEntityGenerator {
 
    public static void main(String[] args) {
        FileGenerator.build(Abc.class);
    }
 
    @Tables(
            /** 数据库连接信息 **/
            dbType= DbType.ORACLE,
            driver= "oracle.jdbc.OracleDriver",
            url = "jdbc:oracle:thin:@IP:1521:orcl",
            username = "XXXXXX",
            password = "XXXXXX",
            /** Entity类parent package路径 **/
            basePack = "com.mybatis.fluent.fluent_mybatis",
            /** Entity代码源目录 **/
            srcDir = "/src/main/java",
            /** Dao代码源目录 **/
            daoDir = "/src/main/java",
            /** 如果表定义记录创建，记录修改，逻辑删除字段 **/
            gmtCreated = "INSERT_DATE_TIME",
            /** 需要生成文件的表 **/
            tables = @Table(value = {"table_name"})
    )
    static class Abc {
 
    }
}

main方法启动执行，生成的项目结构，如果在执行是出现异常

在这里插入图片描述

需要暂时注释

在这里插入图片描述

当生成好对应文件，项目目录如下

在这里插入图片描述

此时TUserDaoImpl会有错误

在这里插入图片描述

此时将需要将之前注释的provided打开，在执行

在这里插入图片描述

执行过后，异常消除。此时你就拥有的对数据库此表的强大操作能力。

4、测试CURD

import cn.org.atool.fluent.mybatis.model.IPagedList;
import cn.org.atool.fluent.mybatis.model.StdPagedList;
import com.mybatis.fluent.fluent_mybatis.dao.impl.HospitalinfoDaoImpl;
import com.mybatis.fluent.fluent_mybatis.dao.impl.TUserDaoImpl;
import com.mybatis.fluent.fluent_mybatis.entity.HospitalinfoEntity;
import com.mybatis.fluent.fluent_mybatis.entity.TUserEntity;
import com.mybatis.fluent.fluent_mybatis.helper.TUserWrapperHelper;
import com.mybatis.fluent.fluent_mybatis.wrapper.HospitalinfoQuery;
import com.mybatis.fluent.fluent_mybatis.wrapper.TUserQuery;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;
 
import javax.annotation.Resource;
import java.io.Serializable;
import java.util.List;
 
@SpringBootTest
class FluentMybatisApplicationTests {
 
    @Resource
    private TUserDaoImpl dao;
 
    @Test
    void add() {
        TUserEntity entity = new TUserEntity().setAge(20).setEmail("122@163.com").setName("lisi").setIsDeleted(false);
        Serializable id = dao.save(entity);
        System.out.println("插入后返回的主键ID为：" + id);
    }
 
    @Test
    void select(){
        /**
         * 分页查询构造条件
         */
        TUserQuery query = TUserQuery.query().limit(0,1);
        List<TUserEntity> list = dao.listEntity(query);
        System.out.println(list);
    }
 
    @Test
    void upData(){
        TUserEntity entity = dao.selectById(1L);
        System.out.println(entity);
        entity.setAge(2000).setEmail("120098922@qq.com").setName("lisi111").setIsDeleted(true);
        System.out.println(entity);
        boolean b = dao.updateById(entity);
        System.out.println(b);
    }
 
    @Test
    void delete(){
        boolean b = dao.deleteById(1L);
        System.out.println(b);
        TUserQuery query = TUserQuery.query();
        List<TUserEntity> list = dao.listEntity(query);
        System.out.println(list);
    }
 
}