若依二开:升级mybatis-plus 若依 mybatis

上一期我专门对若依框架的模块陈述过自己的一些改进建议，下面把我本地整改完的项目先和大家分享一下。

ruoyi-framework只依赖ruoyi-common（源码是需要依赖ruoyi-system）

改造后是ruoyi-system依赖ruoyi-framework，并且将controller这个目录迁移到模块中（源码中这一部分是以源码方式放在ruoyi-admi中的）

ruoyi-admin是项目入口，只需要依赖ruoyi-system,ruoyi-quartz,suoyi-generator，其中除ruoyi-system（内部又依赖了ruoyi-framework,ruoyi-common）是必须以外，其他的模块是可选

ruoyi-admin入口项目一般有自己的包名，比如我这里是com.ktg,而若依框架的包名是com.ruoyi。所以在启动类我这里做了两个修改。一个是@MapperScan 配置两个扫描路径，分别是业务入口项目的，一个是若依框架的。其次就是@SpringBootApplication 扫描器，也是区分了入口项目路径和若依的包路径。这样做的好处是自己的应用项目没有强制性必须和若依框架的包名相同（当然你也可以直接用com.ruoyi做包名）。其次就是遵循开闭原则，有些时候其实我们不需要若依的源码，只需要若依框架的几个模块的jar包即可，所以强烈推荐使用自己的包名方式配置。

若依框架帮我们封装了一些通用的应用模块，方便我们开箱即用，但是其持久层用的是mybatis框架，总感觉有那么一点点落后，毕竟有些单表的增删改查，不想通过xml重复的配置（即便是通过工具代码生成），所以打算把若依框架的mybatis升级到mybatis-plus。因为mybatis-plus是完全兼容mybatis的 ，所以升级也比较简单，升级后若依原来的mybatis接口都不需要更改。

1. 首先在项目的父pom文件添加mybatis-plus的依赖

 <properties>
<mybatis-plus.version>3.4.2</mybatis-plus.version> 
 </properties>
  <dependencyManagement>
<dependency>
  <groupId>com.baomidou</groupId>
  <artifactId>mybatis-plus-boot-starter</artifactId>
   <version>${mybatis-plus.version}</version>
 </dependency>
</dependencyManagement>

2. 然后在 ruoyi-commom模块的pom文件添加以下依赖，因为继承了父pom文件，所以不需要再添加版本号

 <dependency>
  <groupId>com.baomidou</groupId>
  <artifactId>mybatis-plus-boot-starter</artifactId>
 </dependency>

3. 在ruoyi-framework模块中的 config目录下，把MyBatisConfig.java 这个类删除掉
4. 最后，在入口项目ruoyi-admin的 yml文件中，注释或者删除掉mybatis的配置，添加mybatis-plus的配置

# MyBatis配置
#mybatis:
# 搜索指定包别名
#    typeAliasesPackage: com.ruoyi.**.domain
# 配置mapper的扫描，找到所有的mapper.xml映射文件
#    mapperLocations: classpath*:mapper/**/*Mapper.xml
# 加载全局的配置文件
#    configLocation: classpath:mybatis/mybatis-config.xml

#MyBatis-Plus配置
mybatis-plus:
  mapper-locations: classpath*:mapper/**/*Mapper.xml
  type-aliases-package: com.ruoyi.**.domain
  global-config:
    db-config:
      id-type: auto
  configuration:
    map-underscore-to-camel-case: true
    cache-enabled: false
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

可以看到配置几乎是相同的，只是mybatis前缀换成了mybatis-plus

4. 在ruoyi-framework 的config目录下添加MybatisPlusConfig 配置类

@Configuration
public class MybatisPlusConfig  {
    private final Long MAX_LIMIT = 1000L;

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        //分页插件
        PaginationInnerInterceptor paginationInnerInterceptor = new PaginationInnerInterceptor();
        paginationInnerInterceptor.setDbType(DbType.MYSQL);
        paginationInnerInterceptor.setOverflow(true);
        paginationInnerInterceptor.setMaxLimit(MAX_LIMIT);
        //防止全表更新与删除插件
        interceptor.addInnerInterceptor(new BlockAttackInnerInterceptor());
       // interceptor.addInnerInterceptor(paginationInnerInterceptor);

        return interceptor;
    }
}

这一步你也可以不配置，需要注意的是如果配置则不要添加mybatis-plus的分页插件。因为若依用的是mybatis的第三方分页插件PageHelper，这个分页插件和mybatis-plus自带的分页插件是不通用的，如果配置了拦截器，则不能像若依框架一样 使用startPage() 开启分页功能，而是需要使用mybatis-plus的分页接口。至于若依框架为什么只需要startPage() 这样一行代码就可以实现分页，这个下一期我专题介绍。如下面的代码：

    @GetMapping("/list")
    public TableDataInfo list(SysPost post)
    {
        startPage();
        List<SysPost> list = postService.selectPostList(post);
        return getDataTable(list);
    }

有关PageHelper这个神奇的分页插件，关注我，下一期和大家详细的分析这一行代码背后的来龙去脉。