Mybatis Plus 代码自动生成器常用配置参考(详细解读)

Mybatis Plus 代码自动生成器常用配置

代码自动生成器常用配置

从ssm转springboot,尝试了jpa,还是没有mybatis顺手,但是mybatis generator不管是maven插件还是IDEA插件,都有点受限,比如想做个模糊搜索,还是要自己写语句,一套下来没比jpa上直接写语句便宜多少,所以还是花点时间转到mybaitis plus上了,简单总结一下。

基础配置

  1. 依赖
		<!--spring-boot-starter-web-->
		<dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!--mybatis plus-->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.4.2</version>
        </dependency>
        <!--mybatis plus代码生成器-->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-generator</artifactId>
            <version>3.4.1</version>
        </dependency>
         <!--代码生成器的模板引擎-->
        <dependency>
            <groupId>org.freemarker</groupId>
            <artifactId>freemarker</artifactId>
            <version>2.3.31</version>
        </dependency>
  1. 数据源等配置 application.yml
	#数据源
	spring:
	  datasource:
	    driver-class-name: org.postgresql.Driver
	    url: jdbc:postgresql://localhost:5432/ultron
	    username: postgres
	    password: password
	#xml位置
	mybatis-plus:
	  mapper-locations: classpath:/mapper/*Mapper.xml
  1. 在 Spring Boot 启动类中添加 @MapperScan 注解,扫描 Mapper 文件夹
	@SpringBootApplication
	@MapperScan("com.example.ultron.mapper")
	public class UltronApplication {
	    public static void main(String[] args) {
	        SpringApplication.run(UltronApplication.class, args);
	    }
	}
  • mybaitis plus具体的基础配置与使用可以参考官方指南

代码自动生成配置(详)

1.常量

	final String ProjectPath = System.getProperty("user.dir");//D://workspace/ultron
    final String CustomMapperPath = "/src/main/resources/mapper/";//自定义xml输出位置
    final String SuperEntityClass = "com.example.ultron.pojo.BaseEntity";//实体的公共父类
    final String JdbcUrl = "jdbc:postgresql://localhost:5432/ultron";//数据库连接字符串
    final String DriverName = "org.postgresql.Driver";//数据库驱动
    final String Username = "postgres";//数据库用户名
    final String Password = "password";//数据库密码

2.主方法用于运行生成代码

    public static void main(String[] args) {
        //GenerateTables generateTables = JsonReader.read(PATH);
        MyBatisGenerator genarator = new MyBatisGenerator();
        String[] generateTables = {
                //"t_user","auth","role" //已经生成过的数据库表
                "newtable" //待运行生成的数据库表
        };
        assert generateTables != null;
        genarator.genarate(generateTables);//调用代码生成方法
    }

3.代码生成方法

     public void genarate(String... generateTables) {
        //代码生成器
        AutoGenerator mpg = new AutoGenerator();
        //1.加载全局配置
        GlobalConfig gc = getGlobalConfig();
        mpg.setGlobalConfig(gc);
        //2.加载数据源配置
        DataSourceConfig dsc = getDataSourceConfig();
        mpg.setDataSource(gc);
        //3.加载包配置
        PackageConfig pc = getPackageConfig();
        mpg.setPackageInfo(pc);
        //4.加载模板配置
        TemplateConfig templateConfig = getTemplateConfig();
        mpg.setTemplate(templateConfig);
        //5.加载策略配置
        StrategyConfig strategy = getStrategyConfig();
        mpg.setStrategy(strategy);
        /*
         自定义包输出配置(将xml输出到resource下而非source root下)
         */
        // 如果模板引擎是 freemarker 默认为/templates/mapper.xml.ftl
        String templatePath = "/templates/mapper.xml.ftl";
        // 如果模板引擎是 velocity
        // String templatePath = "/templates/mapper.xml.vm";
        // 自定义mapper.xml的输出
        List<FileOutConfig> focList = new ArrayList<>();
        // 自定义配置会被优先输出
        focList.add(new FileOutConfig(templatePath) {
            @Override
            public String outputFile(TableInfo tableInfo) {
                // 自定义输出文件名 , 如果你 Entity 设置了前后缀、此处注意 xml 的名称会跟着发生变化!!
                return ProjectPath + CustomMapperPath + tableInfo.getEntityName() + "Mapper" + StringPool.DOT_XML;
            }
        });
        //6.设置模板引擎//支持 Velocity(默认)/Freemarker/Beetl
        mpg.setTemplateEngine(new FreemarkerTemplateEngine());
        //生成器执行,生成代码
        mpg.execute();
    }

4.各项配置详解

(1) 全局必要的配置

    public GlobalConfig getGlobalConfig() {
        GlobalConfig gc = new GlobalConfig();
        //全局路径到项目的Source Root根目录即可
        gc.setOutputDir(ProjectPath + "/src/main/java");
        //设置作者
        gc.setAuthor("author");
        //实体属性 Swagger2 注解
        gc.setSwagger2(true);
        //是否覆盖生成文件
        gc.setFileOverride(true);
        //Service默认生成会有I-前缀
        //其他Controller/ServiceImpl则没有,不需要单独设置
        gc.setServiceName("%sService");//%s是占位符
        //如果主键在数据库设置了自增
        //则就需要在pojo/vo中的实体类中标注主键@TableId(type=IdType.AUTO)
        //或者在此设置IdType
        gc.setIdType(IdType.AUTO);
        return gc;
    }

(2) 数据源配置

    public DataSourceConfig getDataSourceConfig() {
        DataSourceConfig dsc = new DataSourceConfig();
        dsc.setDbType(DbType.POSTGRE_SQL);//必须设置数据库类型
        dsc.setUrl(JdbcUrl);
        //PostgreSQL可设置,默认为"public",MySQL不需要设置
        //dsc.setSchemaName("public");
        dsc.setDriverName(DriverName);
        dsc.setUsername(Username);
        dsc.setPassword(Password);
        return dsc;
    }

(3) 包配置,用于指定生成的controller/service(impl)/entity/mapper/xml等输出的包位置

    public PackageConfig getPackageConfig() {
        PackageConfig pc = new PackageConfig();
        pc.setParent("com.example");
        pc.setModuleName("ultron");//模块名
        //配置entity的输出包,其他的包名controller/service/service.impl/mapper等默认一样
        pc.setEntity("vo");
        return pc;
    }

(4) 模板配置,用于指定生成各类文件的模板,一般均采用默认模板,如果不需要自动生成哪一类文件,则向setter传null即可。

    public TemplateConfig getTemplateConfig() {
        TemplateConfig templateConfig = new TemplateConfig();
        // 配置自定义输出模板
        //指定自定义模板路径,注意不要带上.ftl/.vm, 会根据使用的模板引擎自动识别
        // templateConfig.setEntity("templates/entity2.java");
        // templateConfig.setService();
        //不自动生成Controller
        templateConfig.setController(null);
        //已经另外配置了路径输出xml,故设置不自动生成xml
        templateConfig.setXml(null);
        return templateConfig ;
    }

(5) 策略配置,用于设置各种生成策略和一些数据表策略

    public StrategyConfig getStrategyConfig() {
        StrategyConfig strategy = new StrategyConfig();
        //数据库表映射到实体的命名策略:下划线转驼峰命名
        strategy.setNaming(NamingStrategy.underline_to_camel);
        //数据库表字段映射到实体的命名策略:下划线转驼峰命名 //未指定按照 naming 执行
        strategy.setColumnNaming(NamingStrategy.underline_to_camel);
        //自定义继承的Entity类全称,带包名
        /*	自定义公共父类时需要给字段注解:
        *	@TableField(exist = false)//表示该属性不是数据库表字段,但又是必须使用的
        *	否则mybatis-plus使用对象属性进行SQL操作,比如save(insert/insertBatch)
        *	会报错表示对象属性非数据据库表的字段
        */
        strategy.setSuperEntityClass(SuperEntityClass);
        //[实体]是否为lombok模型(默认 false)
        //3.3.2以下版本默认生成了链式模型,3.3.2以后,默认不生成,如有需要,请开启 chainModel
        strategy.setChainModel(true);
        strategy.setEntityLombokModel(true);
        //是否生成实体时,生成字段注解
        /*
        *	部分字段注解:
        *	@TableField(exist = false):表示该属性不是数据库表字段,但又是必须使用的。
        *	@TableField(exist = true):表示该属性是数据库表字段,默认是这个注解。
        *	@TableName:数据库表相关
        *	@TableId:表主键标
        *	@TableField:表字段标识
        *	@TableLogic:表字段逻辑处理注解(逻辑删除)
        */
        strategy.setEntityTableFieldAnnotationEnable(true);
        //设置RestController模式
        //strategy.setRestControllerStyle(true);
        //公共的父类控制器,没有就不用设置
        // strategy.setSuperControllerClass("");
        //写于父类中的公共字段
        //strategy.setSuperEntityColumns("id");
        //需要包含的表名,当enableSqlFilter为false时,允许正则表达式(与exclude二选一配置)
        strategy.setInclude(generateTables);
        //strategy.setControllerMappingHyphenStyle(true);
        //strategy.setTablePrefix(pc.getModuleName() + "_");
        
        return strategy;
    }

(6) 自定义配置,不常用

    public InjectionConfig getInjectionConfig() {
        InjectionConfig cfg = new InjectionConfig() {
            @Override
            public void initMap() {
                // to do nothing
            }
        };
        /*
        cfg.setFileCreate(new IFileCreate() {
            @Override
            public boolean isCreate(ConfigBuilder configBuilder, FileType fileType, String filePath) {
                // 判断自定义文件夹是否需要创建
                checkDir("调用默认方法创建的目录,自定义目录用");
                if (fileType == FileType.MAPPER) {
                    // 已经生成 mapper 文件判断存在,不想重新生成返回 false
                    return !new File(filePath).exists();
                }
                // 允许生成模板文件
                return true;
            }
        });
        */
        cfg.setFileOutConfigList(focList);
        return cfg;
    }
  • 更多关于 mybatis plus 的配置,参考 官网.
上一篇:mybatis-plus


下一篇:设计模式之策略模式