使用MybatisPlus自定義模版中能獲取到的信息
使用MybatisPlus的AutoGenerator生成代碼
這個可自行官網查看,或者搜索引擎查一下一大堆可以參考的,這裡就不過多敘述。
模版中能獲取到哪些信息
官方沒有給出在自定義模版中你能獲取到哪些信息來生成你想要的代碼,所以本人就看瞭一下源碼,能獲取到的信息都在com.baomidou.mybatisplus.generator.engine.AbstractTemplateEngine類的getObjectMap方法中,如下:
/** * <p> * 渲染對象 MAP 信息 * </p> * * @param tableInfo 表信息對象 * @return */ public Map<String, Object> getObjectMap(TableInfo tableInfo) { Map<String, Object> objectMap = new HashMap<>(); ConfigBuilder config = this.getConfigBuilder(); if (config.getStrategyConfig().isControllerMappingHyphenStyle()) { objectMap.put("controllerMappingHyphenStyle", config.getStrategyConfig().isControllerMappingHyphenStyle()); objectMap.put("controllerMappingHyphen", StringUtils.camelToHyphen(tableInfo.getEntityPath())); } objectMap.put("restControllerStyle", config.getStrategyConfig().isRestControllerStyle()); objectMap.put("package", config.getPackageInfo()); GlobalConfig globalConfig = config.getGlobalConfig(); objectMap.put("author", globalConfig.getAuthor()); objectMap.put("idType", globalConfig.getIdType() == null ? null : globalConfig.getIdType().toString()); objectMap.put("logicDeleteFieldName", config.getStrategyConfig().getLogicDeleteFieldName()); objectMap.put("versionFieldName", config.getStrategyConfig().getVersionFieldName()); objectMap.put("activeRecord", globalConfig.isActiveRecord()); objectMap.put("kotlin", globalConfig.isKotlin()); objectMap.put("date", new SimpleDateFormat("yyyy-MM-dd").format(new Date())); objectMap.put("table", tableInfo); objectMap.put("enableCache", globalConfig.isEnableCache()); objectMap.put("baseResultMap", globalConfig.isBaseResultMap()); objectMap.put("baseColumnList", globalConfig.isBaseColumnList()); objectMap.put("entity", tableInfo.getEntityName()); objectMap.put("entityColumnConstant", config.getStrategyConfig().isEntityColumnConstant()); objectMap.put("entityBuilderModel", config.getStrategyConfig().isEntityBuilderModel()); objectMap.put("entityLombokModel", config.getStrategyConfig().isEntityLombokModel()); objectMap.put("entityBooleanColumnRemoveIsPrefix", config.getStrategyConfig().isEntityBooleanColumnRemoveIsPrefix()); objectMap.put("superEntityClass", this.getSuperClassName(config.getSuperEntityClass())); objectMap.put("superMapperClassPackage", config.getSuperMapperClass()); objectMap.put("superMapperClass", this.getSuperClassName(config.getSuperMapperClass())); objectMap.put("superServiceClassPackage", config.getSuperServiceClass()); objectMap.put("superServiceClass", this.getSuperClassName(config.getSuperServiceClass())); objectMap.put("superServiceImplClassPackage", config.getSuperServiceImplClass()); objectMap.put("superServiceImplClass", this.getSuperClassName(config.getSuperServiceImplClass())); objectMap.put("superControllerClassPackage", config.getSuperControllerClass()); objectMap.put("superControllerClass", this.getSuperClassName(config.getSuperControllerClass())); return objectMap; }
下面我就順便整理一下方便以後查看
屬性 | 類型 | 描述 | 示例 |
---|---|---|---|
controllerMappingHyphenStyle | boolean | controllerMapping是否為連字符形式 | 駝峰:@RequestMapping("/managerUserActionHistory")連字符:@RequestMapping("/manager-user-action-history") |
controllerMappingHyphen | String | 實體類的連字符形式 | manager-user-action-history |
restControllerStyle | boolean | 是否為RestController模式 | |
package | Map | 所有包配置信息 | |
package.Entity | String | Entity所在包路徑 | com.geek.sean.test.model |
package.Mapper | String | Mapper所在包路徑 | com.geek.sean.test.mapper |
package.Xml | String | Mapper的xml文件所在包路徑 | com.geek.sean.test.mapper.xml |
package.ServiceImpl | String | Service實現類所在包路徑 | com.geek.sean.test.service.impl |
package.Service | String | Service所在包路徑 | com.geek.sean.test.service |
package.Controller | String | Controller所在包路徑 | com.geek.sean.test.controller |
author | String | GlobalConfig中配置的author | |
idType | String | GlobalConfig中配置的idType | |
logicDeleteFieldName | String | 策略配置項中配置的邏輯刪除屬性名稱 | |
versionFieldName | String | 策略配置項中配置的樂觀鎖屬性名稱 | |
activeRecord | boolean | 是否開啟ActiveRecord模式 | |
kotlin | boolean | 是否開啟 Kotlin 模式 | |
date | String | 當前日期(yyyy-MM-dd) | 2019-07-09 |
table | TableInfo | 表信息,關聯到當前字段信息 | |
table.name | String | 表名 | 例:sys_user |
table.comment | String | 表描述 | 用戶信息表 |
table.entityName | String | 實體類名稱 | SysUser |
table.mapperName | String | Mapper類名 | SysUserMapper |
table.xmlName | String | Mapper對應的xml名稱 | SysUserMapper |
table.serviceName | String | Service名稱 | SysUserService |
table.serviceImplName | String | Service實現類名稱 | SysUserServiceImpl |
table.controllerName | String | Controller名稱 | SysUserController |
table.fields | List<TableField> | 字段信息集合 | |
table.fields[n].name | String | 字段名稱 | user_id |
table.fields[n].type | String | 字段類型 | int(11)、varchar(64)、timestamp、char(1) |
table.fields[n].propertyName | String | 屬性名 | userId、userName |
table.fields[n].columnType | String | 屬性類型 | String、Integer |
table.fields[n].comment | String | 字段描述 | 用戶名 |
table.importPackages | List<String> | 引入包集合 | [‘com.baomidou.mybatisplus.enums.IdType’,‘java.util.Date’] |
table.fieldNames | String | 表字段名,逗號分隔 | user_id, user_name, password |
enableCache | boolean | 是否在xml中添加二級緩存配置 | |
baseResultMap | boolean | 是否開啟 BaseResultMap | |
baseColumnList | boolean | 是否開啟 baseColumnList | |
entity | String | Entity類名 | |
entityColumnConstant | boolean | 【實體】是否生成字段常量(默認 false) | |
entityBuilderModel | boolean | 【實體】是否為構建者模型(默認 false) | |
entityLombokModel | boolean | 【實體】是否為lombok模型(默認 false) | |
entityBooleanColumnRemoveIsPrefix | boolean | Boolean類型字段是否移除is前綴(默認 false) | 比如 : 數據庫字段名稱 : ‘is_xxx’,類型為 : tinyint. 在映射實體的時候則會去掉is,在實體類中映射最終結果為 xxx |
superEntityClass | String | Entity父類 | BaseEntity |
superMapperClassPackage | String | Mapper父類包路徑 | com.baomidou.mybatisplus.mapper.BaseMapper |
superMapperClass | String | Mapper父類 | BaseMapper |
superServiceClassPackage | String | Service父類包路徑 | com.baomidou.mybatisplus.service.IService |
superServiceClass | String | Service父類 | IService |
superServiceImplClassPackage | String | Service實現類父類包路徑 | com.baomidou.mybatisplus.service.impl.ServiceImpl |
superServiceImplClass | String | Service實現類父類 | ServiceImpl |
superControllerClassPackage | String | Controller類父類包路徑 | |
superControllerClass | String | Controller父類 |
總結瞭一上午,個別字段沒有放上,自己用到時候可以再去源碼看看。
MybatisPlus遇到的坑
springBoot項目整合mybatis-plus、lombok時遇到瞭使用代碼生成器生成實體類及mapper後,調用方法時報錯找不到mapper,後經過一項項調整pom文件內jar包依賴,才知道mybatis-plus版本號存在很多不兼容。
1、導入依賴
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-jdbc</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>2.0.1</version> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <scope>runtime</scope> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> <!-- mybatis的orm插件 --> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus</artifactId> <version>2.1.9</version> </dependency> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatisplus-spring-boot-starter</artifactId> <version>1.0.4</version> </dependency> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <scope>provided</scope> </dependency> <!--阿裡數據庫鏈接依賴 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> </dependency> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid</artifactId> <version>1.1.9</version> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-configuration-processor</artifactId> <optional>true</optional> </dependency>
因為我用的是阿裡雲的數據庫,所以需要導入阿裡雲及數據庫依賴,lombok為簡化實體類生成的插件jar包。
註意:千萬註意mybatis-plus版本!!!千萬註意mybatis-plus版本!!!千萬註意mybatis-plus版本!!!
2、配置分頁配置文件和數據源
package com.ds.tech.config; import javax.sql.DataSource; import org.springframework.boot.context.properties.ConfigurationProperties; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.jdbc.datasource.DataSourceTransactionManager; import com.alibaba.druid.pool.DruidDataSource; /** * 數據源配置 */ @Configuration public class DataSourceConfig { @Bean(name="dataSource") @ConfigurationProperties(prefix="spring.datasource") public DataSource dataSource(){ return new DruidDataSource(); } // 配置事物管理器 @Bean(name="transactionManager") public DataSourceTransactionManager transactionManager(){ return new DataSourceTransactionManager(dataSource()); } }
package com.ds.tech.config; import org.mybatis.spring.annotation.MapperScan; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import com.baomidou.mybatisplus.plugins.PaginationInterceptor; @Configuration //掃描dao或者是Mapper接口 @MapperScan("com.ds.tech.mapper*") public class MybatisPlusConfig { /** * mybatis-plus 分頁插件 */ @Bean public PaginationInterceptor paginationInterceptor(){ PaginationInterceptor page = new PaginationInterceptor(); page.setDialectType("mysql"); return page; } }
配置代碼生成器,然後就可以生成代碼使用瞭
package com.ds.tech; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; import com.baomidou.mybatisplus.generator.AutoGenerator; import com.baomidou.mybatisplus.generator.InjectionConfig; import com.baomidou.mybatisplus.generator.config.*; import com.baomidou.mybatisplus.generator.config.converts.MySqlTypeConvert; import com.baomidou.mybatisplus.generator.config.rules.DbType; import com.baomidou.mybatisplus.generator.config.rules.NamingStrategy; /** * <p> * 代碼生成器演示 * </p> */ public class MpGenerator { final static String dirPath = "D://mybatis"; /** * <p> * MySQL 生成演示 * </p> */ public static void main(String[] args) { AutoGenerator mpg = new AutoGenerator(); // 選擇 freemarker 引擎,默認 Veloctiy //mpg.setTemplateEngine(new FreemarkerTemplateEngine()); // 全局配置 GlobalConfig gc = new GlobalConfig(); gc.setOutputDir(dirPath); gc.setAuthor("dashen"); gc.setFileOverride(true); //是否覆蓋 gc.setActiveRecord(false);// 不需要ActiveRecord特性的請改為false gc.setEnableCache(false);// XML 二級緩存 gc.setBaseResultMap(false);// XML ResultMap gc.setBaseColumnList(false);// XML columList // 自定義文件命名,註意 %s 會自動填充表實體屬性! // gc.setMapperName("%sDao"); // gc.setXmlName("%sMapper"); // gc.setServiceName("MP%sService"); // gc.setServiceImplName("%sServiceDiy"); // gc.setControllerName("%sAction"); mpg.setGlobalConfig(gc); // 數據源配置 DataSourceConfig dsc = new DataSourceConfig(); dsc.setDbType(DbType.MYSQL); dsc.setTypeConvert(new MySqlTypeConvert(){ // 自定義數據庫表字段類型轉換【可選】 // @Override // public DbColumnType processTypeConvert(String fieldType) { // System.out.println("轉換類型:" + fieldType); // // 註意!!processTypeConvert 存在默認類型轉換,如果不是你要的效果請自定義返回、非如下直接返回。 // return super.processTypeConvert(fieldType); // } }); dsc.setDriverName("com.mysql.jdbc.Driver"); dsc.setUsername("k"); dsc.setPassword("mj^"); dsc.setUrl("jdbc:mysql://rm-2zql.rds.aliyuncs.06/mjmk_dev?useUnicode=true&characterEncoding=utf-8"); mpg.setDataSource(dsc); // 策略配置 StrategyConfig strategy = new StrategyConfig(); // strategy.setCapitalMode(true);// 全局大寫命名 ORACLE 註意 strategy.setTablePrefix(new String[] { "tb_", "tsys_" });// 此處可以修改為您的表前綴 strategy.setNaming(NamingStrategy.underline_to_camel);// 表名生成策略 strategy.setInclude(new String[] { "store" }); // 需要生成的表 // strategy.setExclude(new String[]{"test"}); // 排除生成的表 // 自定義實體父類 // strategy.setSuperEntityClass("com.baomidou.demo.TestEntity"); // strategy.setSuperEntityClass("java.io.Serializable"); // 自定義實體,公共字段 // strategy.setSuperEntityColumns(new String[] { "test_id", "age" }); // 自定義 mapper 父類 // strategy.setSuperMapperClass("com.baomidou.demo.TestMapper"); // 自定義 service 父類 // strategy.setSuperServiceClass("com.baomidou.demo.TestService"); // 自定義 service 實現類父類 // strategy.setSuperServiceImplClass("com.baomidou.demo.TestServiceImpl"); // 自定義 controller 父類 // strategy.setSuperControllerClass("com.baomidou.demo.TestController"); // 【實體】是否生成字段常量(默認 false) // public static final String ID = "test_id"; // strategy.setEntityColumnConstant(true); // 【實體】是否為構建者模型(默認 false) // public User setName(String name) {this.name = name; return this;} strategy.setEntityBuilderModel(true); strategy.setEntityLombokModel(true); mpg.setStrategy(strategy); // 包配置 PackageConfig pc = new PackageConfig(); pc.setParent("com.ds.tech"); // pc.setModuleName(""); pc.setController("controller"); pc.setEntity("entity"); pc.setMapper("mapper"); pc.setService("service"); pc.setServiceImpl("serviceImpl"); pc.setXml("mapperXml"); mpg.setPackageInfo(pc); // 註入自定義配置,可以在 VM 中使用 cfg.abc 【可無】 InjectionConfig cfg = new InjectionConfig() { @Override public void initMap() { Map<String, Object> map = new HashMap<String, Object>(); map.put("abc", this.getConfig().getGlobalConfig().getAuthor() + "-mp"); this.setMap(map); } }; // 自定義 xxList.jsp 生成 List<FileOutConfig> focList = new ArrayList<FileOutConfig>(); /* focList.add(new FileOutConfig("/template/list.jsp.vm") { @Override public String outputFile(TableInfo tableInfo) { // 自定義輸入文件名稱 return "D://my_" + tableInfo.getEntityName() + ".jsp"; } }); cfg.setFileOutConfigList(focList); mpg.setCfg(cfg);*/ // 調整 xml 生成目錄演示 /* focList.add(new FileOutConfig("/templates/mapper.xml.vm") { @Override public String outputFile(TableInfo tableInfo) { return dirPath + tableInfo.getEntityName() + "Mapper.xml"; } }); cfg.setFileOutConfigList(focList); */ mpg.setCfg(cfg); // 關閉默認 xml 生成,調整生成 至 根目錄 /* TemplateConfig tc = new TemplateConfig(); tc.setXml(null); mpg.setTemplate(tc);*/ // 自定義模板配置,可以 copy 源碼 mybatis-plus/src/main/resources/templates 下面內容修改, // 放置自己項目的 src/main/resources/templates 目錄下, 默認名稱一下可以不配置,也可以自定義模板名稱 // TemplateConfig tc = new TemplateConfig(); // tc.setController("..."); // tc.setEntity("..."); // tc.setMapper("..."); // tc.setXml("..."); // tc.setService("..."); // tc.setServiceImpl("..."); // 如上任何一個模塊如果設置 空 OR Null 將不生成該模塊。 // mpg.setTemplate(tc); // 執行生成 mpg.execute(); // 打印註入設置【可無】 System.err.println(mpg.getCfg().getMap().get("abc")); } }
以上為個人經驗,希望能給大傢一個參考,也希望大傢多多支持WalkonNet。
推薦閱讀:
- 一篇超詳細的SpringBoot整合MybatisPlus的文章
- SpringBoot項目使用mybatis-plus逆向自動生成全套代碼
- Springboot Mybatis Plus自動生成工具類詳解代碼
- mybatis plus generator 根據數據庫自動生成實體類的實現示例
- MyBatisPlus代碼生成器的原理及實現詳解