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

2023-11-10 15:33:34

作者：汤圆

个人博客：javalover.cc

前言

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

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

简介

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

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

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

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

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

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

本地代码生成

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

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

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

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

  1. 配置pom.xml

    <dependency>
    <groupId>com.baomidougroupId>
    <artifactId>mybatis-plus-generatorartifactId>
    <version>3.4.0version>dependency><dependency>
    <groupId>org.apache.velocitygroupId>
    <artifactId>velocity-engine-coreartifactId>
    <version>2.3version>dependency><dependency>
    <groupId>org.projectlombokgroupId>
    <artifactId>lombokartifactId>
    <version>1.18.16version>dependency>复制代码

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

    // 演示例子，执行 main 方法控制台输入模块表名回车自动生成对应项目目录中public class GenerateCode {    /**
     ** 读取控制台内容
     **/
    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();
    }
}复制代码

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

    生成后的目录结构如下：

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

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

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

    Car.java

    /**
 ** 车辆管理
 **
 * @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语句

  • 生成后，需要拉到本地项目中

  • 不够灵活，比如父类的配置等

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

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

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

在线链接：gen.stylefeng.cn/#/createCod…

总结

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

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

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

后记

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

期待官人们的点赞哦

上一篇：MyBatis Plus 的基本用法


下一篇：SpringBoot 在线协同办公小程序开发 全栈式项目实战