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

Posted 汤圆学Java

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了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/#/createCode

总结

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

角1:基于Mybatis-Plus官网的例子(灵活,功能全)

角2:基于第三方的在线生成(简单,上手快)

后记

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

期待官人们的点赞哦

以上是关于SpringBoot中的自动代码生成 - 基于Mybatis-Plus的主要内容,如果未能解决你的问题,请参考以下文章

基于springboot的多数据源自动配置实现

springboot+mybatis项目自动生成

springboot自动重启

SpringBoot源码学习系列之异常处理自动配置

Springboot自动装配的原理

springboot 整合 Lkadoc 强大的api接口文档自动生成