SpringBoot中的自动代码生成 - 基于Mybatis-Plus

作者：汤圆

个人博客：javalover.cc

前言

大家好啊，我是汤圆，今天给大家带来的是《SpringBoot中的自动代码生成 - 基于Mybatis-Plus》，希望对大家有帮助，谢谢

文章纯属原创，个人总结难免有差错，如果有，麻烦在评论区回复或后台私信，谢啦

简介

基于Mybatis-Plus的自动代码生成有很多方式，这里介绍下我在用的两种：

• 本地代码生成：Mybatis-Plus官方
• 在线代码生成：第三方

这两种各有优缺点，看喜欢哪一种了

听说Idea也有自动生成的插件，但是我还没去看，我觉得这俩就够用了（但也说不准哪天，用了插件后，才发现柳暗花明呢）

有的官人，可能要问了，既然Mybatis-Plus官网有例子了，为啥还要在这里写出来呢？

是因为对于我这种不熟悉模板引擎的人来说，官网介绍的一些配置我们可以省掉，从而减少我们调试的时间（因为默认的模板生成配置就够用了，我们不需要再去接触那些模板语法啥的）

本地代码生成

就是在自己的项目里，写一个Java程序，配置好各种参数，启动后就可以自动生成

这种方法的好处是，直接生成到本地项目，不需要手动再去复制粘贴

缺点就是，刚开始的配置比较多（但是一劳永逸）

好了，下面开始上代码，好消息是下面的代码都有注释说明，另一个好消息是生成的代码也是有注释的（尤其是entity类的字段注解，很实用）

1. 配置pom.xml

   <!-- mybatis-plus代码生成器 -->
   <dependency>
       <groupId>com.baomidou</groupId>
       <artifactId>mybatis-plus-generator</artifactId>
       <version>3.4.0</version>
   </dependency>
   <!-- velocity模板引擎，用于mybatis-plus代码生成器 -->
   <dependency>
       <groupId>org.apache.velocity</groupId>
       <artifactId>velocity-engine-core</artifactId>
       <version>2.3</version>
   </dependency>
   <!-- lombok 自动生成会用到-->
   <dependency>
       <groupId>org.projectlombok</groupId>
       <artifactId>lombok</artifactId>
       <version>1.18.16</version>
   </dependency>

2. 自动生成代码的Java主程序：参考官网

   // 演示例子，执行 main 方法控制台输入模块表名回车自动生成对应项目目录中
   public class GenerateCode {
   
       /**
        * <p>
        * 读取控制台内容
        * </p>
        */
       public static String scanner(String tip) {
           Scanner scanner = new Scanner(System.in);
           StringBuilder help = new StringBuilder();
           help.append("请输入" + tip + "：");
           System.out.println(help.toString());
           if (scanner.hasNext()) {
               String ipt = scanner.next();
               if (StringUtils.isNotBlank(ipt)) {
                   return ipt;
               }
           }
           throw new MybatisPlusException("请输入正确的" + tip + "！");
       }
   
       public static void main(String[] args) {
           // 代码生成器
           AutoGenerator mpg = new AutoGenerator();
   
           // 1. 全局配置
           GlobalConfig gc = new GlobalConfig();
           // 项目根目录
           String projectPath = System.getProperty("user.dir");
           // 生成代码的输出目录：一般这个就是固定的，这里不用写到具体的哪个包，因为下面会单独配置包名
           gc.setOutputDir(projectPath + "/src/main/java");
           // 生成代码的author
           gc.setAuthor("javalover");
           // 生成代码后，是否自动打开生成的目录：这里我们不需要，因为就是生成到当前项目
           gc.setOpen(false);
           // 设置全局配置
           mpg.setGlobalConfig(gc);
   
           // 2. 数据源配置
           DataSourceConfig dsc = new DataSourceConfig();
           dsc.setUrl("jdbc:mysql://localhost:3306/guns?autoReconnect=true&useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=CONVERT_TO_NULL&useSSL=false&serverTimezone=CTT&nullCatalogMeansCurrent=true");
           dsc.setDriverName("com.mysql.cj.jdbc.Driver");
           dsc.setUsername("root");
           dsc.setPassword("root");
           mpg.setDataSource(dsc);
   
           // 3. 包配置
           PackageConfig pc = new PackageConfig();
           // 设置包名：和上面的输出目录进行拼接(ourDir+parent)
           pc.setParent("cn.stylefeng.guns.modular.business");
           // 检测命令行输入的模块名：和上面的包名进行拼接（outDir+parent+moduleName)，生成代码都会放到这个模块下
           pc.setModuleName(scanner("模块名"));
           mpg.setPackageInfo(pc);
   
           // 4. 策略配置
           StrategyConfig strategy = new StrategyConfig();
           // 自动生成 实体类的命名：数据库映射到实体类，下划线转驼峰
           strategy.setNaming(NamingStrategy.underline_to_camel);
           // 这里如果不设置，会跟随上面实体类的命名设置
           strategy.setColumnNaming(NamingStrategy.underline_to_camel);
           // 字段注解：这里我们把表字段的注解打开，比如@TableField("car_name")
           strategy.setEntityTableFieldAnnotationEnable(true);
           // 实体类的父类：如果有就配置，记得加包名
           strategy.setSuperEntityClass("cn.stylefeng.roses.kernel.db.api.pojo.entity.BaseEntity");
           // 映射类的父类：如果有就配置，记得加包名
           strategy.setSuperMapperClass("com.baomidou.mybatisplus.core.mapper.BaseMapper");
           // 服务接口的父类：如果有就配置，记得加包名
           strategy.setSuperServiceClass("com.baomidou.mybatisplus.extension.service.IService");
           // 服务实现类的父类：如果有就配置，记得加包名
           strategy.setSuperServiceImplClass("com.baomidou.mybatisplus.extension.service.impl.ServiceImpl");
           // 控制器类的父类：如果有就配置，记得加包名
           // strategy.setSuperControllerClass("");
   
           // lombok：是否开启Lombok的注解，比如@Data,@EqualsAndHashCode(callSuper = true)
           strategy.setEntityLombokModel(true);
           // 控制器的@RestController注解：是否开启，不开启则默认为@Controller
           strategy.setRestControllerStyle(true);
           // 监测命令行的输入：表名
           strategy.setInclude(scanner("表名，多个英文逗号分割").split(","));
           // 控制器的请求映射url风格：驼峰转连字符，比如"carList"-> "car-list"
           strategy.setControllerMappingHyphenStyle(true);
           // 设置表的前缀：设置后，生成的类名和Controller的请求映射中就不会包含表前缀
           // 设置后为 @RequestMapping("/gps/car")，而不是@RequestMapping("/gps/gps-car")
           // 类名同理
           strategy.setTablePrefix("gps");
           mpg.setStrategy(strategy);
   
           // 5. 配置模板引擎
           // 默认采用velocity模板
   //        mpg.setTemplateEngine(new VelocityTemplateEngine());
           mpg.execute();
       }
   }
   

启动程序，在命令行依次输入包名，表名，等待运行完成就可以了

生成后的目录结构如下：

可以看到，基本的框架都有了

下面我们看下生成的entity文件：

Car.java

/**
 * <p>
 * 车辆管理
 * </p>
 *
 * @author javalover
 * @since 2021-04-22
 */
@Data
@EqualsAndHashCode(callSuper = true)
@TableName("gps_car")
public class Car extends BaseEntity {

    private static final long serialVersionUID = 1L;

    /**
     * 车辆id
     */
    @TableId("car_id")
    private Long carId;

    /**
     * 所属公司id
     */
    @TableField("company_id")
    private Long companyId;

    /**
     * 车辆名称
     */
    @TableField("car_name")
    private String carName;

    /**
     * 车辆种类
     */
    @TableField("car_type")
    private Integer carType;

    /**
     * 车辆颜色
     */
    @TableField("car_color")
    private String carColor;

    /**
     * 司机
     */
    @TableField("car_driver")
    private String carDriver;

    /**
     * 车辆价格
     */
    @TableField("car_price")
    private BigDecimal carPrice;

    /**
     * 油耗
     */
    @TableField("fuel_consumption")
    private BigDecimal fuelConsumption;

    /**
     * 车牌号
     */
    @TableField("car_number")
    private String carNumber;

    /**
     * 车架号
     */
    @TableField("frame_number")
    private String frameNumber;

    /**
     * 载重
     */
    @TableField("load_weight")
    private BigDecimal loadWeight;

    /**
     * 车照片
     */
    @TableField("car_img")
    private String carImg;

    /**
     * 车辆实时定位
     */
    @TableField("car_location")
    private String carLocation;
}

可以看到，注释的很详细啊，多好(字段的注释是根据数据库的注释来的)

在线代码生成

就是在第三方的网站，配置各种参数，点击生成就可以了，然后下载到本地

这种方法的好处是，前期不用太多配置，使用方便

缺点就是

• 需要在线配置一个小型的数据库，上传SQL语句
• 生成后，需要拉到本地项目中
• 不够灵活，比如父类的配置等

其实它的缺点就是因为它的简单导致的

这种就比较适合新的项目，想要快速上手体验的朋友

因为在线的操作很简单，这里给出链接，具体操作大家体验下就知道了

在线链接：https://gen.stylefeng.cn/#/cr...

总结

自动生成代码的方式有很多，而这里的只是冰山一角

角1：基于Mybatis-Plus官网的例子（灵活，功能全）

角2：基于第三方的在线生成（简单，上手快）

后记

最后，感谢大家的观看，谢谢

期待官人们的点赞哦