Springboot 3 整合 MyBatis-Plus 详解

2023-02-03 10:12:50

Springboot 3 中的 MyBatis-Plus：简化你的数据库交互

简介

Springboot 3 是一个强大且易用的 Java 框架，它可以大大简化 Spring 应用程序的开发。MyBatis-Plus 是一个功能齐全的 ORM 框架，它可以帮助我们轻松地与数据库进行交互。本文将深入探讨如何在 Springboot 3 中集成 MyBatis-Plus，并提供一些常见问题的解决方法。

集成步骤

引入依赖

首先，我们需要在项目中引入 MyBatis-Plus 的依赖。在 pom.xml 文件中添加以下依赖：

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus</artifactId>
    <version>3.5.3</version>
</dependency>

配置 MyBatis-Plus

接下来，我们需要在 Springboot 项目中配置 MyBatis-Plus。在 application.yml 文件中添加以下配置：

# MyBatis-Plus 配置
mybatis-plus:
  # 数据库类型
  typeAliasesPackage: com.example.demo.entity
  mapperLocations: classpath:/mybatis/mapper/*.xml

创建 Mapper 接口

创建一个继承自 BaseMapper 接口的 Mapper 接口，并定义所需的方法。例如：

public interface UserMapper extends BaseMapper<User> {
    List<User> findByName(String name);
}

使用 Mapper 接口

在 Service 层中使用 Mapper 接口。通过在 Service 类中注入 Mapper 接口可以实现：

@Service
public class UserService {
    @Autowired
    private UserMapper userMapper;

    public List<User> findByName(String name) {
        return userMapper.findByName(name);
    }
}

常见问题

"Bean named 'ddlApplicationRunner' is expected to be of type 'org.springframework.boot.Runner' but was actually of type 'org.springframework.beans.factory.support.NullBean'"

这个问题通常是由 MyBatis-Plus 的版本与 Springboot 3 不兼容引起的。将 MyBatis-Plus 的版本更新到 3.5.3 以上可以解决此问题。
"Cannot instantiate interface org.springframework.data.jpa.repository.JpaRepository"

这个问题通常是由于我们使用了 Spring Data JPA 的注解，而 MyBatis-Plus 不支持 Spring Data JPA。删除 Spring Data JPA 的注解可以解决此问题。
"No qualifying bean of type 'com.baomidou.mybatisplus.autoconfigure.MybatisPlusProperties' available: expected at least 1 bean which qualifies as autowire candidate. Dependency annotations: {@org.springframework.beans.factory.annotation.Autowired(required=true)}"

这个问题通常是由于 MyBatis-Plus 的配置错误引起的。检查 application.yml 文件中的 MyBatis-Plus 配置是否正确。
"Cannot resolve reference to bean 'xxxMapper' while setting bean property 'xxxMapper'"

这个问题通常是由于 Mapper 接口和 Mapper XML 文件的路径不正确引起的。检查 Mapper 接口和 Mapper XML 文件的路径是否正确。
"Could not autowire. No beans of 'xxxMapper' type found."

这个问题通常是由于 Mapper 接口没有正确注入 Service 类引起的。检查 Service 类中的 Mapper 接口是否正确注入。