MyBatis-Plus學習筆記(2)：代碼生成器

AutoGenerator 是 MyBatis-Plus 的代碼生成器，通過 AutoGenerator 可以快速生成 Entity、Mapper、Mapper XML、Service、Controller 等各個模塊的代碼。

項目結構：

生成前：

生成后：

pom.xml：

<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.3.1.tmp</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.47</version>
        </dependency>
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-generator</artifactId>
            <version>3.3.1.tmp</version>
        </dependency>
        <dependency>
            <groupId>org.freemarker</groupId>
            <artifactId>freemarker</artifactId>
            <version>2.3.29</version>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
</dependencies>

代碼生成主類：PlusGenerator

package com.cf.plusdm2;

import com.baomidou.mybatisplus.generator.AutoGenerator;
import com.baomidou.mybatisplus.generator.config.DataSourceConfig;
import com.baomidou.mybatisplus.generator.config.GlobalConfig;
import com.baomidou.mybatisplus.generator.config.PackageConfig;
import com.baomidou.mybatisplus.generator.config.StrategyConfig;
import com.baomidou.mybatisplus.generator.config.rules.NamingStrategy;
import com.baomidou.mybatisplus.generator.engine.FreemarkerTemplateEngine;

public class PlusGenerator {

    public static void main(String[] args) {
        //代碼生成器
        AutoGenerator mpg = new AutoGenerator();

        //全局配置
        GlobalConfig gc = new GlobalConfig();
        String projectPath = System.getProperty("user.dir");
        //生成文件的輸出目錄
        gc.setOutputDir(projectPath + "/src/main/java");
        //開發人
        gc.setAuthor("布禾");
        //是否打開輸出目錄
        gc.setOpen(false);
        //是否覆蓋已有文件，默認false
        gc.setFileOverride(true);
        //實體屬性 Swagger2 注解
        //gc.setSwagger2(true);
        //mapper.xml中生成通用查詢結果列
        gc.setBaseColumnList(true);
        //mapper.xml中生成通用查詢映射結果
        gc.setBaseResultMap(true);
        //設置Controller、Mapper、mapper.xml等命名方式，使用默認即可。
        /*gc.setServiceName("%sService");
        gc.setControllerName();
        gc.setMapperName();
        gc.setEntityName();
        gc.setXmlName();
        gc.setServiceImplName();*/
        mpg.setGlobalConfig(gc);


        //數據源配置
        DataSourceConfig dsc = new DataSourceConfig();
        dsc.setUrl("jdbc:mysql://localhost/localdb?useUnicode=true&characterEncoding=UTF-8");
        //數據庫 schema name
        // dsc.setSchemaName("public");
        //數據庫驅動
        dsc.setDriverName("com.mysql.jdbc.Driver");
        //數據庫連接用戶名
        dsc.setUsername("root");
        //數據庫連接密碼
        dsc.setPassword("123456");
        mpg.setDataSource(dsc);


        //包配置
        PackageConfig pc = new PackageConfig();
        //父包模塊名
        pc.setModuleName("user");
        //父包名，如果為空，將下面子包名必須寫全部， 否則就只需寫子包名
        pc.setParent("com.cf.plusdm2");
        //設置Controller、Mapper、mapper.xml等存放的包名
        /*pc.setController();
        pc.setEntity();
        ...*/
        mpg.setPackageInfo(pc);


        // 策略配置
        StrategyConfig strategy = new StrategyConfig();
        //數據庫表映射到實體的命名策略
        strategy.setNaming(NamingStrategy.underline_to_camel);
        //數據庫表字段映射到實體的命名策略, 未指定按照 naming 執行
        strategy.setColumnNaming(NamingStrategy.underline_to_camel);
        //是否為lombok模型，默認false
        strategy.setEntityLombokModel(true);
        //生成 @RestController 控制器
        strategy.setRestControllerStyle(true);
        //需要包含的表名，允許正則表達式
        strategy.setInclude("tb_user");
        //駝峰轉連字符
        strategy.setControllerMappingHyphenStyle(true);
        //表前綴
        strategy.setTablePrefix("tb_");
        mpg.setStrategy(strategy);
        mpg.setTemplateEngine(new FreemarkerTemplateEngine());
        mpg.execute();
    }
}

當以上生成不能滿足需求時，MyBatis-Plus也提供了自定義生成的方法，如使用InjectionConfig和TemplateConfig。

自定義生成Controller

1.首先創建用於生成Controller的FreeMarker模板文件，內容可以參照com.baomidou.mybatis-plus-generator.3.3.1.tmp.mybatis-plus-generator-3.3.1.tmp.jar!.templates.controller.java.ftl(默認Controller的模板文件)模板文件進行修改。
src/main/resources/ftl/controller.java.ftl：

package ${package.Controller};


import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.beans.factory.annotation.Autowired;
<#if restControllerStyle>
import org.springframework.web.bind.annotation.RestController;
<#else>
import org.springframework.stereotype.Controller;
</#if>
<#if superControllerClassPackage??>
import ${superControllerClassPackage};
</#if>
<#if cfg.servicePackage??>
import ${cfg.servicePackage}.${table.serviceName};
</#if>
<#if cfg.entityPackage??>
import ${cfg.entityPackage}.${table.entityName};
</#if>

/**
 * <p>
 * ${table.comment!} 前端控制器
 * </p>
 *
 * @author ${author}
 * @since ${date}
 */
<#if restControllerStyle>
@RestController
<#else>
@Controller
</#if>
@RequestMapping("<#if package.ModuleName??>/${package.ModuleName}</#if>/<#if controllerMappingHyphenStyle??>${controllerMappingHyphen}<#else>${table.entityPath}</#if>")
<#if kotlin>
class ${table.controllerName}<#if superControllerClass??> : ${superControllerClass}()</#if>
<#else>
<#if superControllerClass??>
public class ${table.controllerName} extends ${superControllerClass} {
<#else>
public class ${table.controllerName} {
</#if>
     @Autowired
     private ${table.serviceName} ${table.serviceName?uncap_first};

     @RequestMapping("/add")
     public String insert(User user){
         return ${table.serviceName?uncap_first}.save(user) ? "success" : "fail";
     }
}
</#if>

2.在PlusGenerator中策略配置上方添加InjectionConfig和TemplateConfig的配置：

        //自定義配置
        InjectionConfig cfg = new InjectionConfig() {
            @Override
            public void initMap() {
                // to do nothing
            }
        };
        //傳入模板的參數，在模板中通過cfg.servicePackage的方式來獲取
        Map<String, Object> map = new HashMap<>();
        map.put("servicePackage", pc.getParent() + "." + pc.getService());
        map.put("entityPackage", pc.getParent() + "." + pc.getEntity());
        cfg.setMap(map);
        mpg.setCfg(cfg);

        //配置模板
        TemplateConfig templateConfig = new TemplateConfig();
        templateConfig.setController("/ftl/controller.java");
        mpg.setTemplate(templateConfig);

使用templateConfig.setController()方法來設置生成controller的模板，注意不要帶上.ftl/.vm, 會根據使用的模板引擎自動識別。當未設置值時，則使用默認MyBatis-Plus提供的默認的模板。當設置為null時，則不會生成Controller。(mapper、service等類似)

重新運行PlusGenerator，生成后的Controller如下：

package com.cf.plusdm2.user.controller;


import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RestController;
import com.cf.plusdm2.user.service.IUserService;
import com.cf.plusdm2.user.entity.User;

/**
 * <p>
 *  前端控制器
 * </p>
 *
 * @author 布禾
 * @since 2020-02-10
 */
@RestController
@RequestMapping("/user/user")
public class UserController {
     @Autowired
     private IUserService iUserService;

     @RequestMapping("/add")
     public String insert(User user){
         return iUserService.save(user) ? "success" : "fail";
     }
}

代碼生成器詳細使用可參考：代碼生成器