Substituindo MyBatis por MyBatis-Plus no Projeto Ruoyi Vue

Objetivo: Substituir o MyBatis pelo MyBatis-Plus dentro do projeto.

1. Criação de Branch

Crie uma nova branch para a alteração, como troca-mbatisplus, para manter o código original seguro.

2. Gerenciamento de Dependências

No arquivo pom.xml da raiz do projeto, adicione as seguintes configurações para gerenciar as versões:``` ... <mybatis-plus.version>3.5.9</mybatis-plus.version>

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

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-jsqlparser</artifactId>
    <version>${mybatis-plus.version}</version>
</dependency>

Nota: Para funcionalidades básicas, somente mybatis-plus-boot-starter é necesssário. Neste exemplo, foram incluídos mybatis-plus-bom e mybatis-plus-jsqlparser conforme a documentação oficial para habilitar o plugin de paginação.

Em seguida, adicione as dependências nos módulos common e framework.

No módulo common:``` <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-jsqlparser</artifactId>


No módulo `framework`:```
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
</dependency>
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-jsqlparser</artifactId>
</dependency>

3. Configuração da Aplicação (application.yml)

Comente ou remova a seção de configuração original do MyBatis e adicione a nova seção para o MyBatis-Plus.```

Configuração original do MyBatis (comentada)

#mybatis:

typeAliasesPackage: com.ruoyi.**.domain

mapperLocations: classpath*:mapper/**/*Mapper.xml

configLocation: classpath:mybatis/mybatis-config.xml

Configuração do 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 # Descomente para logar SQL #log-impl: org.apache.ibatis.logging.stdout.StdOutImpl


  
### 4. Substituição da Clasce de Configuração

Delete ou comente todo o conteúdo da classe `MyBatisConfig.java` original. Crie uma nova clase `MyBatisPlusConfig.java` no mesmo pacote para configurar os plugins do MyBatis-Plus, como o de paginação.```
package com.ruoyi.framework.config;

import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MyBatisPlusConfig {

    @Bean
    public PaginationInnerInterceptor criadorPaginador() {
        return new PaginationInnerInterceptor();
    }
}

5. Resolução de Problemas com o Maven

Em alguns casos, a dependência mybatis-plus-jsqlparser pode não ser encontrada. Verifique as configurações de repositórios e espelhos (mirrors) do seu arquivo settings.xml do Maven. Adicionar um repositório central ou o repositório do Baomidou pode resolver o problema.

Tags: ruoyi MyBatis-Plus spring-boot pagination dependency-management

Publicado em 6-18 05:02