Springboot整合Mybatis Plus【超详细】

Mybatis Plus简介

MyBatisPlus是基于MyaBatis框架基础上开发的增强型工具，旨在简化开发，提高效率。

MyBatis Plus特性：

特性	说明
无入侵	做增强不做改变，不会对现有工程产生影响
损耗小	启动即会自动注入基本 CURD，性能基本无损耗，直接面向对象操作
强大的CRUD操作	内置通用Mapper，少量配置即可实现单表CRUD操作
支持Lambda	编写查询条件无序担心字段错误
内置分页插件	方便高效
支持主键自动生成	支持多达 4 种主键策略（内含分布式唯一 ID 生成器 - Sequence），可自由配置完美解决主键问题
支持自定义全局通用操作	支持全局通用方法注入
内置性能分析插件	可输出 Sql 语句及其执行时间，建议开发测试时启用该功能，能快速定位慢查询

快速整合

总结需要做的步骤，不拖拉

1，导入依赖
2，yml文件中配置信息
3，启动类上加上扫描mapper接口所在包的注解
4，编写配置类
5，实现自动注入通用字段接口（非必需）
6，编写Mybatis Plus的controller、service、entity、mapper、xml的生成器工具类

1，导入依赖

        <!--mybatis plus--><dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-boot-starter</artifactId><version>${mybatis-plus.version}</version></dependency><!--mybatis plus生成器依赖--><dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-generator</artifactId><version>${mybatis-plus.version}</version></dependency><!--velocity模版依赖--><dependency><groupId>org.apache.velocity</groupId><artifactId>velocity</artifactId><version>${velocity.version}</version><exclusions><exclusion><groupId>commons-collections</groupId><artifactId>commons-collections</artifactId></exclusion></exclusions></dependency>

2，yml文件中配置信息

mybatis-plus:# entity包路径,自行修改typeAliasesPackage: com.tunda.openai.model.entity# enum包路径,自行修改typeEnumsPackage: com.tunda.openai.common.enumsglobal-config:db-config:db-column-underline: true# 逻辑删及设置默认值（deleted字段是数据库自定义字段）logic-delete-field: deletedlogic-not-delete-value: 0logic-delete-value: 1configuration:mapUnderscoreToCamelCase: true# log-impl: org.apache.ibatis.logging.slf4j.Slf4jImpl #开启sql日志log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 控制台 打印sqldefault-enum-type-handler: com.baomidou.mybatisplus.extension.handlers.MybatisEnumTypeHandler

3，启动类上加上扫描mapper接口所在包的注解

@SpringBootApplication
@MapperScan(basePackages ="com.tunda.openai.mapper")
public class Application {public static void main(String[] args) {SpringApplication.run(Application.class,args);}
}

4，编写配置类

@Configuration
@EnableTransactionManagement
public class MybatisPlusConfig {@Beanpublic MybatisPlusInterceptor mybatisPlusInterceptor() {MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();PaginationInnerInterceptor pii = new PaginationInnerInterceptor();pii.setDbType(DbType.MYSQL);pii.setMaxLimit(500L);interceptor.addInnerInterceptor(pii);return interceptor;}@Beanpublic ConfigurationCustomizer configurationCustomizer() {return configuration -> configuration.setUseDeprecatedExecutor(false);}
}

5，实现自动注入通用字段接口（非必需）

@Component
public class MybatisMetaObjectHandler implements MetaObjectHandler {@Overridepublic void insertFill(MetaObject metaObject) {insertOrUpdateFill(metaObject, true);}@Overridepublic void updateFill(MetaObject metaObject) {insertOrUpdateFill(metaObject, false);}private void insertOrUpdateFill(MetaObject metaObject, boolean isInsert) {if (isInsert) {if (Objects.isNull(getFieldValByName("createTime",metaObject)))this.setFieldValByName("createTime", LocalDateTime.now(), metaObject);this.setFieldValByName("deleted", 0, metaObject);} else {if (Objects.isNull(getFieldValByName("updateTime",metaObject)))this.setFieldValByName("updateTime", LocalDateTime.now(), metaObject);}}
}

6，编写生成器工具类

具体说明：传送门->https://blog.csdn.net/qq_45399396/article/details/123986811

public class MybatisPlusGenerator {//生成文件所在项目路径private static String baseProjectPath = "D:\\generatorCode";//基本包名private static String basePackage = "com.tunda.openai";//作者(一般公司名简称)private static String authorName = "tunda";//要生成的表名，为空时生成所有表private static String[] tables = {"t_goods_info"};//table前缀private static String prefix = "";//数据库配置四要素private static String driverName = "com.mysql.jdbc.Driver";private static String url = "jdbc:mysql://129.139.254.38:3306/tunsdda_gpt?serverTimezone=GMT%2B8&zeroDateTimeBehavior=CONVERT_TO_NULL&useUnicode=true&characterEncoding=utf-8&useSSL=false";private static String username = "root";private static String password = "root";public static void main(String[] args) {// 代码生成器AutoGenerator mpg = new AutoGenerator();// 1、全局配置GlobalConfig gc = new GlobalConfig();//可以将生成得代码单独放在文件夹里，检查完没问题在手动将包复制到项目中gc.setOutputDir(baseProjectPath);gc.setAuthor(authorName);// 生成实体类的文档注解中作者名gc.setOpen(true);// 生成代码后自动打开生成目录文件gc.setFileOverride(true); // 是否覆盖原来生成的gc.setIdType(IdType.AUTO);// 指定生成的主键类型：自增长gc.setDateType(DateType.ONLY_DATE);gc.setActiveRecord(false);mpg.setGlobalConfig(gc);// 2、数据源配置DataSourceConfig dsc = new DataSourceConfig();dsc.setUrl(url);dsc.setDriverName(driverName);dsc.setUsername(username);dsc.setPassword(password);dsc.setDbType(DbType.MYSQL); // mysql数据库gc.setServiceName("%sService"); //去掉Service接口的首字母'I'dsc.setTypeConvert(new MySqlTypeConvert() {@Overridepublic IColumnType processTypeConvert(GlobalConfig globalConfig, TableField tableField) {return super.processTypeConvert(globalConfig, tableField);}});mpg.setDataSource(dsc);// 3、包配置PackageConfig pc = new PackageConfig();pc.setModuleName(null)// 生成的controller路径映射为一个"/",覆盖默认的"//".setParent(basePackage)// 生成controller，service，xml并设置路径。.setEntity("entity").setMapper("mapper").setService("service").setServiceImpl("service.impl").setController("controller");mpg.setPackageInfo(pc);// 5、策略配置StrategyConfig strategy = new StrategyConfig();strategy.setCapitalMode(true);// 开启全局大写命名strategy.setNaming(NamingStrategy.underline_to_camel);// 实体类名驼峰strategy.setColumnNaming(NamingStrategy.underline_to_camel);// 属性名驼峰strategy.setInclude(tables);// 设置要映射的表名注解@Tablestrategy.setSuperEntityClass(BaseEntity.class); // 预先定义一个BaseEntity类实现Serializable接口strategy.setEntityLombokModel(true); // 使用 lombokstrategy.setRestControllerStyle(true);// 开启 restful风格strategy.setEntityTableFieldAnnotationEnable(false);// 不生成实体类字段swagger类型注解,而是采用文档类型注解：/**xxx*/if (prefix != null) strategy.setTablePrefix(prefix);  // 表前缀if (ArrayUtils.isNotEmpty(tables)) strategy.setInclude(tables);  // 表名// 6、自动填充配置：非必须（自动加上注解）TableFill createTime = new TableFill("create_time", FieldFill.INSERT);TableFill updateTime = new TableFill("update_time", FieldFill.UPDATE);ArrayList<TableFill> tableFills = new ArrayList<>();tableFills.add(createTime);tableFills.add(updateTime);strategy.setTableFillList(tableFills);strategy.setLogicDeleteFieldName("deleted");// 自动加上逻辑删注解mpg.setStrategy(strategy);mpg.setTemplateEngine(new VelocityTemplateEngine());// 执行生成器mpg.execute();}}

注意事项：生成的代码当中，entiry实体类需要注意一下@EqualsAndHashCode，生成的时候，@EqualsAndHashCode(callSuper = true)。
但是大多数情况下，@EqualsAndHashCode(callSuper = false) 或者直接去掉这个注解也可以，所以这个的生成器生成的这个注解需要手动修改一下（改为false或者直接去掉这个注解）

到此为止，Springboot整合Mybatis Plus结束，接下来就是注意事项

1，问题一：mybatis-plus中@TableField.fill设置为FieldFill.UPDATE不生效

要想实现自动注入字段属性，必需实现第5步骤，也就是实现MetaObjectHandler接口，
其次，这种不生效的也存在两个注意的场景
场景一：使用原生sql语句，则注入字段属性不生效
场景二：使用update()方法时，需要调用两个参数的重载方法才有效，就这里需要注意一下。

使用方法API

1，新增操作

这里的this表示的是在service的实现类对象

2，修改操作

通过Wappers的Lambda表达式来构造where后面的条件

3，查询操作

Mybatis Plus封装了丰富的查询操作api，尤其是单表操作的API，相比于SpringJPA来说，好处多多。

3,1 多条件查询

.

.

完整的示例如下：

3.2 排序

完整的示例如下：

3.3 分组

完整的示例如下：

3.4 分页

完整的示例如下：

4，删除操作