（Mybatis笔记）mybatis-plus 3.4.3.4 + mybatis-plus-generator 3.5.1 代码生成器使用——超详细

前提须知：使用（以下教程仅适用 3.5.1 以上版本，对历史版本的不兼容）

1.前言

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

3.开始使用

（1）创建一个SpringBoot工程项目

这里我之前写过创建步骤，教程如下：

CSDN链接：（Spring笔记）IDEA创建SpringBoot项目工程

（2）工程准备好之后，在pom.xml中引入mybatis-plus+mysql及相关依赖

        
        
            com.baomidou
            mybatis-plus-boot-starter
            3.4.3.4
        
        
        
            com.baomidou
            mybatis-plus-generator
            3.5.1
        
        
        
            org.freemarker
            freemarker
            2.3.31
        
        
        
            mysql
            mysql-connector-java
            8.0.26
        
        
        
            org.projectlombok
            lombok
            1.18.20
            provided
        
        
        
            com.alibaba
            fastjson
            1.2.78
        
        
        
            io.springfox
            springfox-swagger2
            2.9.2
        
        
            io.springfox
            springfox-swagger-ui
            2.9.2

（3）依赖准备好后，创建Java类，在main()方法中：配置连接mysql数据库信息+调用自动生成API并设置各类参数，根据自定义策略，执行自动生成代码操作。这里新建一个FastAutoGeneratorTest.java，提供主方法main()。

***数据库配置***：

    
    private static final DataSourceConfig.Builder DATA_SOURCE_ConFIG = new DataSourceConfig
            .Builder("jdbc:mysql://localhost:3306/数据库名称?useUnicode=true&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=UTC", "mysql用户名", "mysql密码")
            .dbQuery(new MySqlQuery()) //数据库查询
            .schema("mybatis-plus") //数据库schema(部分数据库适用)
            .typeConvert(new MySqlTypeConvert()) //数据库类型转换器
            .keyWordsHandler(new MySqlKeyWordsHandler()); //数据库关键字处理器

***全局配置***：提醒：开启swagger2需要添加依赖哟(上述已添加)—— .enableSwagger()

FastAutoGenerator.create(DATA_SOURCE_CONFIG)
                // 全局配置
                .globalConfig((scanner, builder) -> builder
                        .fileOverride() //覆盖已生成文件，默认值:false
                        .outputDir(System.getProperty("user.dir") + "/src/main/java") //指定输出目录，默认值: windows:D://
                        .author(scanner.apply("请输入开发者名称："))//作者名，baomidou 默认值:作者
                        .dateType(DateType.TIME_PACK)//时间策略，DateType.ONLY_DATE 默认值: DateType.TIME_PACK
                        .commentDate("yyyy-MM-dd")//注释日期，默认值: yyyy-MM-dd
                        //.disableOpenDir()// 禁止打开输出目录，默认值:true
                        //.enableKotlin() //开启 kotlin 模式，默认值:false
                        .enableSwagger() //开启 swagger 模式，默认值:false
                        .build()//加入构建队列
                )

***包配置***：

                .packageConfig((scanner, builder) -> builder
                        .parent(scanner.apply("请输入包名："))//父包名，默认值:com.baomidou
                        //.moduleName("sys")//父包模块名，默认值:无
                        .entity("entity")//Entity 包名，默认值:entity
                        .service("service")//Service 包名，默认值:service
                        .serviceImpl("service.impl")//Service Impl 包名，默认值:service.impl
                        .mapper("mapper")//Mapper 包名，默认值:mapper
                        .xml("mapper.xml")//Mapper XML 包名，默认值:mapper.xml
                        .controller("controller")//Controller 包名，默认值:controller
                        //.other("other")//自定义文件包名,	输出自定义文件时所用到的包名
                        .pathInfo(Collections.singletonMap(OutputFile.mapperXml, "src/main/resources/mapper")) //路径配置信息，Collections.singletonMap(OutputFile.mapperXml, "D://")
                        .build()//加入构建队列
                )

***模板引擎***：

.templateConfig((scanner, builder) -> builder
                        //.disable()//禁用所有模板
                        //.entityKt("/templates/entity.java")// 设置实体模板路径(kotlin)，/templates/entity.java
                        .disable(TemplateType.ENTITY)//禁用模板 TemplateType.ENTITY
                        .entity("/templates/entity.java") //设置实体模板路径(JAVA)，/templates/entity.java
                        .service("/templates/service.java")//设置 service 模板路径，/templates/service.java
                        .serviceImpl("/templates/serviceImpl.java")//设置 serviceImpl 模板路径，/templates/serviceImpl.java
                        .mapper("/templates/mapper.java")//设置 mapper 模板路径，/templates/mapper.java
                        .mapperXml("/templates/mapper.xml")//设置 mapperXml 模板路径，/templates/mapper.xml
                        .controller("/templates/controller.java")//设置 controller 模板路径，/templates/controller.java
                        .build()//加入构建队列
                )

***注入配置——自定义模板***：tableInfo和objectMap会在控制台输出表和对象信息

.injectionConfig(builder -> builder
                        .beforeOutputFile((tableInfo, objectMap) -> {
                            System.out.println("tableInfo: " + tableInfo.getEntityName() + " objectMap: " + objectMap.size());
                        }) //输出文件之前消费者
                        .customMap(Collections.singletonMap("my_field", "你好！这是我自己注入的属性哦")) //自定义配置 Map 对象
                        //.customFile(Collections.singletonMap("test.txt", "/templates/test.vm")) //自定义配置模板文件
                        .build()//加入构建队列
                )

***策略配置***：

                
                .strategyConfig(builder -> builder
                        
                        .enableCapitalMode()//开启大写命名，默认值:false
                        .enableSkipView()//开启跳过视图，默认值:false
                        //.disableSqlFilter()//禁用 sql 过滤，默认值:true，语法不能支持使用 sql 过滤表的话，可以考虑关闭此开关
                        .likeTable(new LikeTable("t_user_login"))//模糊表匹配(sql 过滤)	likeTable 与 notLikeTable 只能配置一项
                        
                        .addInclude("t_user_login")// 增加表匹配(内存过滤)，include 与 exclude 只能配置一项
                        
                        .addTablePrefix("t_")//增加过滤表前缀
                        .addFieldSuffix("_")//增加过滤表后缀
                        .addFieldPrefix("ul_")//增加过滤字段前缀
                        .addFieldSuffix("_")//增加过滤字段后缀

注意+警告+重点：过滤表前缀.addTablePrefix()+过滤表字段.addFieldPrefix()，作用于实例类的私有属性的变量名，本人亲测，字段变量名不能有下划线，必须遵守驼峰命名规范，否则接口数据返回null，不论SpringBoot控制台打印mybatis日志有数据！。以本人错误为例：ul_username、ul_password。在用postman访问接口查询Mysql时，返回null。使用前缀过滤后：username、password，数据正常返回。

***实体策略配置***：紧跟策略配置同级

    
    .entityBuilder()//实体策略配置
    .disableSerialVersionUID()//禁用生成 serialVersionUID，默认值:true
    .enableLombok()//开启 lombok 模型，默认值:false
    .enableChainModel()//开启链式模型，默认值:false
    .enableRemoveIsPrefix()//开启 Boolean 类型字段移除 is 前缀，默认值:false
    .enableTableFieldAnnotation()//开启生成实体时生成字段注解，默认值:false
    .enableActiveRecord()//开启 ActiveRecord 模型，默认值:false
    .naming(NamingStrategy.underline_to_camel)//数据库表映射到实体的命名策略，默认下划线转驼峰命名:NamingStrategy.underline_to_camel
    .columnNaming(NamingStrategy.underline_to_camel)//数据库表字段映射到实体的命名策略，默认为 null，未指定按照 naming 执行
    //.addSuperEntityColumns("id", "created_by", "created_time", "updated_by", "updated_time")//添加父类公共字段
    //.addIgnoreColumns("age")//添加忽略字段
    .addTableFills(new Column("create_time", FieldFill.INSERT))//添加表字段填充
    .addTableFills(new Property("updateTime", FieldFill.INSERT_UPDATE))//添加表字段填充
    .idType(IdType.AUTO)//全局主键类型
    .formatFileName("%sBean")//格式化文件名称，生成实体的后缀，建议这样使用，生成后：UserLoginBean
    //.nameConvert(INameConvert)//名称转换实现
    //.versionColumnName("version")//乐观锁字段名(数据库)
    //.versionPropertyName("version")//乐观锁属性名(实体)
    //.logicDeleteColumnName("deleted")//逻辑删除字段名(数据库)
    //.logicDeletePropertyName("deleteFlag")//逻辑删除属性名(实体)
    //.enableSchema()//启用 schema，默认值:false，多 schema 场景的时候打开
    //.addExclude("t_simple")//增加表排除匹配(内存过滤)，include 与 exclude 只能配置一项
    //.notLikeTable(new LikeTable("USER"))//模糊表排除(sql 过滤)	likeTable 与 notLikeTable 只能配置一项

注意+警告+重点：以下两个记得加上，作用于实例类的驼峰命名，否则会有类名会有下划线

.naming(NamingStrategy.underline_to_camel)

.columnNaming(NamingStrategy.underline_to_camel)

***controller策略配置***：

    
    .controllerBuilder()//controller 策略配置
    .enableHyphenStyle()//开启驼峰转连字符，默认值:false
    .enableRestStyle()//开启生成@RestController 控制器，默认值:false
    .formatFileName("%sController")//格式化文件名称——controller包下自动生成的类后缀，例如UserLoginController

***Service策略配置***：

    
    .serviceBuilder()//service 策略配置
    .formatServiceFileName("%sService")//转换 service 接口文件名称，例如：UserLoginService
    .formatServiceImplFileName("%sServiceImpl")//转换 service 实现类文件名称，例如：UserLoginServiceImpl

***mapper策略配置***：

    
    .mapperBuilder()//mapper 策略配置
    .superClass(baseMapper.class)//设置父类，baseMapper是com.baomidou.mybatisplus.core.mapper中的
    .enableMapperAnnotation()//开启 @Mapper 注解，默认值:false
    .enablebaseResultMap()//启用 baseResultMap 生成，默认值:false
    .enablebaseColumnList()//启用 baseColumnList，默认值:false
    .formatMapperFileName("%sMapper")//转换 mapper 接口文件名称后缀，mapper目录下的，例如：UserLoginMapper（有@Mapper）
    .formatXmlFileName("%sMapper")//转换 xml 文件名称后缀，例如：UserLoginMapper.xml，Mybatis的xml映射文件
    .build()//加入构建队列

***自动生成模板引擎***：

    
    //Velocity
    //.templateEngine(new VelocityTemplateEngine())
    //Beetl
    //.templateEngine(new BeetlTemplateEngine())
    //Freemarker
    .templateEngine(new FreemarkerTemplateEngine())
    
    .execute();

说明：模板引擎，默认Velocity方式，Beetl和Freemaker方式需要按如上方式进行设置，这三种方式都需要在pom.xml文件中添加对应依赖，这里有点关键点，就是所选依赖版本，必须与mybatis-plus-generator中的版本一致，不然会在运行自动生成时报错。

本人使用的 mybatis-plus-generator中的版本：

本人的pom.xml中引入的模板引擎依赖，亲测三种模板引擎方式都可以使用

4.演示自动生成过程java+xml

（1）自动生成前项目工程目录如下：

（2）运行FastAutoGeneratorTest.java

（3）自动生成工程目录概况

——Mapper映射接口

@Mapper
public interface UserLoginMapper extends baseMapper {

}

——Service服务接口

public interface UserLoginService extends IService {

}

——Service服务实现类

@Service
public class UserLoginServiceImpl extends ServiceImpl implements UserLoginService {

}

——entity实体Bean类

@Getter
@Setter
@Accessors(chain = true)
@TableName("t_user_login")
@ApiModel(value = "UserLoginBean对象", description = "用户登录表")
public class UserLoginBean extends Model {

    @ApiModelProperty("登录自增ID")
    @TableId(value = "ul_id", type = IdType.AUTO)
    private Integer id;

    @ApiModelProperty("登录名")
    @TableField("ul_username")
    private String username;

    @ApiModelProperty("登录密码")
    @TableField("ul_password")
    private String password;


    @Override
    public Serializable pkVal() {
        return this.id;
    }
}

——controller业务控制类Mapper.xml

@RestController
@RequestMapping("/user-login-bean")
public class UserLoginController {

}

——Mapper.xml（UserLoginMapper.xml）





    
    
        
        
        
    

    
    
        ul_id, ul_username, ul_password

重点注意：自动生成的映射xml文件，需要在配置文件声明，本人习惯yml格式，下面贴出我的配置样式

# SpringBoot资源配置
spring:
  datasource:
    name: testdb  #数据库名
    url: jdbc:mysql://localhost:3306/数据库名称?useUnicode=true&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=UTC #url
    username: xxx  #用户名
    password: xxx  #密码
    driver-class-name: com.mysql.cj.jdbc.Driver  #数据库链接驱动

# 启动默认端口
server:
  port: 8085   

mybatis-plus:
  mapper-locations: classpath*:mapper*Mapper.xml # 根据项目工程更改
  type-aliases-package: com.example.entity #根据项目工程更改
  configuration:
    cache-enabled: false
    map-underscore-to-camel-case: true
    auto-mapping-behavior: full
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # mybatis打印日志
  global-config:
    # 逻辑删除配置
    db-config:
      #id-type: AUTO
      # 删除前
      logic-not-delete-value: 1
      # 删除后
      logic-delete-value: 0

（4）到这里所有的准备工程已完成，下面测试自动生成代码自带的CRUD能否获取MySQL数据库的用户表信息。

5.改动UserLoginController（测试自带的CRUD）

（1）写个简单的接口测试数据：

@RestController
@RequestMapping("/user-login-bean")
public class UserLoginController {

    
    @Autowired
    UserLoginService userLoginService;

    //浏览器访问 http://localhost:8085/user-login-bean/getUserById
    @RequestMapping("/getUserById")
    public UserLoginBean getUserById(){
        //getById是mybatisplus封装好的，通过ID值，查找映射表中的信息
        return userLoginService.getById(1);
    }
}

（2）运行SpringBoot工程：

（3）浏览器URL地址栏键入：http://localhost:8085/user-login-bean/getUserById

***获取MySQL的用户表信息成功***

6.自定义SQL语句

上面测试的是MyBatis-Plus代码自动生成的测试，显然单表的CRUD不符合我们的开发需求，那下面演示一下，在Mapper.xml映射文件中，自定义SQL语句，然后通过Bean、Mapper、Service、Controller、是否能成功查询用户登录表信息，废话不多说，开始！

（1）UserLoginMapper.xml，增添findAllUser内容：





    
    
        
        
        
    

    
    
        ul_id, ul_username, ul_password

（2）UserLoginMapper接口，增添findAllUser内容

@Mapper
public interface UserLoginMapper extends baseMapper {
    List findAllUser();
}

（3）UserLoginService接口，增添findAllUser内容

public interface UserLoginService extends IService {
     List findAllUser();
}

（4）UserLoginServiceImpl服务实现类，注入Mapper的findAllUser()方法

@Service
public class UserLoginServiceImpl extends ServiceImpl implements UserLoginService {
    
    @Autowired
    UserLoginMapper userLoginMapper;

    @Override
    public List findAllUser() {
        return userLoginMapper.findAllUser();
    }
}

（5）UserLoginService接口，增添findAllUser内容

@RestController
@RequestMapping("/user-login-bean")
public class UserLoginController {

    
    @Autowired
    UserLoginService userLoginService;

    //浏览器访问 http://localhost:8085/user-login-bean/getUserById
    @RequestMapping("/getUserById")
    public UserLoginBean getUserById(){
        //getById是mybatisplus封装好的，通过ID值，查找映射表中的信息
        return userLoginService.getById(1);
    }
    //浏览器访问 http://localhost:8085/user-login-bean/findAllUser
    @RequestMapping("/findAllUser")
    public List findAllUser(){
        //findAllUser() 是自定义的SQL查询映射方法——查询t_user_login表中全部用户信息
        return userLoginService.findAllUser();
    }
}

（6）重新运行SpringBoot工程项目，浏览器URL键入：http://localhost:8085/user-login-bean/findAllUser

（Mybatis笔记）mybatis-plus 3.4.3.4 + mybatis-plus-generator 3.5.1 代码生成器使用——超详细

前提须知：使用（以下教程仅适用 3.5.1 以上版本，对历史版本的不兼容）

Java相关栏目本月热门文章