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.