分析MyBatis与MyBatis-Plus的特点和在Spring Boot中同时使用MyBatis与MyBatis-Plus进行高效开发

苦学编程啊

于 2025-03-09 16:42:42 发布

阅读量1.1k

点赞数 47

分类专栏： SpringBoot 文章标签： mybatis

本文链接：https://blog.csdn.net/2201_75525624/article/details/146134470

版权

SpringBoot 专栏收录该内容

3 篇文章

订阅专栏

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

前言

提示：本文将深入探讨如何在Spring Boot项目中同时运用MyBatis与MyBatis-Plus，结合两者优势以实现高效且灵活的数据库操作。通过详细分析其优缺点、特点，并提供完整的代码示例，助您在实际开发中做出更佳的框架选择与应用。

在实际的Java后端开发过程中，数据库操作一直是一个关键环节。Spring Boot框架为我们提供了便捷的项目搭建与配置管理，而MyBatis和MyBatis-Plus作为流行的ORM框架，各自有着独特的优势。MyBatis以灵活的SQL编写能力著称，适合处理复杂业务逻辑；MyBatis-Plus则在MyBatis的基础上进行了增强，内置大量CRUD方法，可减少样板代码，提高开发效率。那么，如何在同一Spring Boot项目中同时使用这两个框架，发挥它们的互补作用呢？本文将为您详细解答

一、框架概述

MyBatis

MyBatis是一款优秀的持久层框架，它支持自定义SQL语句，通过XML文件或注解的方式编写SQL，能够灵活地应对各种复杂的查询需求。其核心在于将SQL语句与Java代码分离，便于维护和优化，特别适合处理业务逻辑多变、对SQL性能要求较高的场景。

MyBatis-Plus

MyBatis-Plus是MyBatis的增强工具，在保留MyBatis原有特性的基础上，提供了更多的便捷功能。它内置了大量的通用CRUD操作方法，减少了开发过程中重复编写SQL和Mapper接口的工作量；同时，还提供了丰富的条件构造器、插件机制等，进一步提升了开发效率和代码的可维护性。

二、同时使用的优缺点

优点

灵活性与适应性：项目中不同模块的数据库操作需求各异，对于标准的CRUD操作和简单动态查询，MyBatis-Plus能快速实现，减少样板代码；而对于复杂的SQL查询，如多表关联、子查询等，MyBatis则提供了精细的控制，两者结合可灵活应对各种业务场景。
开发效率提升：MyBatis-Plus的通用操作和条件构造器等功能，可显著加快开发速度，尤其在搭建基础功能模块时优势明显；MyBatis在处理复杂业务逻辑时，其SQL编写能力也能确保开发的灵活性和准确性，两者相辅相成，提高整体开发效率。
互补性与扩展性：根据具体需求选择合适的工具，既利用MyBatis-Plus的优势快速开发，又可以在需要时切换到MyBatis进行复杂查询。并且，MyBatis-Plus作为MyBatis的增强工具，两者可以无缝共存于同一个项目中，便于后续的功能扩展和优化。

缺点

性能开销：相比原生MyBatis，MyBatis-Plus由于增加了额外的功能层，可能会有一定的性能开销。在极端性能敏感的应用场景中，如高并发、大数据量的实时查询等，可能需要权衡使用哪种框架，或者对两者的使用场景进行更精细的划分，以优化整体性能。
学习成本增加：尽管MyBatis-Plus简化了很多操作，但初学者仍需掌握基本的MyBatis知识，如SQL映射、缓存机制等。同时使用两种框架会增加一定的学习负担，开发团队需要投入更多的时间和精力去熟悉两者的特性和使用方法，尤其在处理两者结合使用时的一些特殊配置和问题时，更需要深入理解。
配置与管理复杂度：在项目中同时引入MyBatis和MyBatis-Plus，需要在pom.xml中添加多个依赖，并在配置文件中进行相应的配置，如数据源配置、Mapper接口扫描等。此外，管理两个不同的Mapper接口和XML文件也会稍微复杂一些，需要合理的项目结构和规范的代码管理，以避免出现混淆和冲突。

三、特点概括

MyBatis-Plus特点

内置通用CRUD方法：提供了如新增、删除、更新、查询等丰富的通用方法，无需重复编写SQL和Mapper接口，大大减少了样板代码，提高了开发效率。
条件构造器：通过链式调用的方式，方便地构建动态查询条件，使代码更加简洁、易读且易于维护。
插件机制：支持自定义插件，可以根据项目需求扩展功能，如性能分析插件、分页插件等，进一步增强框架的灵活性和可扩展性。
与MyBatis无缝集成：作为MyBatis的增强工具，能够与MyBatis完美结合使用，充分利用MyBatis的现有功能和生态。

MyBatis特点

灵活的SQL编写：在XML文件中自由编写SQL语句，能够灵活地应对各种复杂的业务场景，如多表关联查询、存储过程调用等。
强大的映射功能：通过ResultMap等机制，将数据库查询结果与Java对象进行灵活映射，支持复杂的字段映射关系和嵌套结果处理。
缓存机制：提供了一级缓存和二级缓存功能，可以有效减少数据库访问次数，提高数据查询性能。
丰富的事务管理：支持编程式和声明式事务管理，能够满足不同场景下的事务控制需求。

四、代码示例

1. 添加依赖

在pom.xml文件中添加MyBatis和MyBatis-Plus的依赖：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
    </dependency>
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
        <version>3.5.1</version>
    </dependency>
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>2.2.0</version>
    </dependency>
</dependencies>

2. 配置数据源

在application.yml或application.properties中配置数据源信息：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/your_database?useSSL=false&serverTimezone=UTC
    username: your_username
    password: your_password
    driver-class-name: com.mysql.cj.jdbc.Driver

# MyBatis Plus 配置
mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
  mapper-locations: classpath*:mapper/*.xml

3. 创建实体类

假设我们有一个User实体类：

package com.example.demo.entity;

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;

@TableName("user")
public class User {
    @TableId(type = IdType.AUTO)
    private Long id;
    private String name;
    private Integer age;

    // Getters and Setters
    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }
}

4. 创建Mapper接口

创建一个MyBatis-Plus的Mapper接口：

package com.example.demo.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Param;
import java.util.List;

public interface UserMapper extends BaseMapper<User> {
    List<User> findUsersByCustomCondition(@Param("age") int age, @Param("name") String name);
}

5. 定义XML Mapper

如果需要使用MyBatis的XML方式进行复杂查询，可以在src/main/resources/mapper目录下创建一个XML文件，例如UserMapper.xml：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper  PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"  "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.demo.mapper.UserMapper">
    <select id="findUsersByCustomCondition" resultType="com.example.demo.entity.User">
        SELECT * FROM user WHERE age > #{age} AND name LIKE CONCAT('%', #{name}, '%')
    </select>
</mapper>

6. 使用Mapper进行查询

在服务层或其他地方注入并使用这些Mapper：

package com.example.demo.service;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.example.demo.entity.User;
import com.example.demo.mapper.UserMapper;
import java.util.List;

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

    public List<User> getUsersByNameAndAge(String name, int age) {
        QueryWrapper<User> queryWrapper = new QueryWrapper<>();
        queryWrapper.eq("name", name).gt("age", age);
        return userMapper.selectList(queryWrapper);
    }

    public List<User> getUsersByCustomCondition(int age, String name) {
        return userMapper.findUsersByCustomCondition(age, name);
    }
}

7. 控制器示例

最后，创建一个控制器来测试这些服务方法：

package com.example.demo.controller;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import com.example.demo.entity.User;
import com.example.demo.service.UserService;
import java.util.List;

@RestController
public class UserController {
    @Autowired
    private UserService userService;

    @GetMapping("/users/byNameAndAge")
    public List<User> getUsersByNameAndAge(@RequestParam String name, @RequestParam int age) {
        return userService.getUsersByNameAndAge(name, age);
    }

    @GetMapping("/users/customCondition")
    public List<User> getUsersByCustomCondition(@RequestParam int age, @RequestParam String name) {
        return userService.getUsersByCustomCondition(age, name);
    }
}

总结

在Spring Boot项目中同时使用MyBatis和MyBatis-Plus，能够充分发挥两者的互补优势，实现高效、灵活的数据库操作。MyBatis-Plus适用于标准的CRUD操作和简单动态查询，可显著减少样板代码，提高开发效率；而MyBatis则在处理复杂的SQL查询和需要精细控制的情况下表现出色。通过合理的配置和使用，我们可以在项目中根据不同模块的需求选择合适的框架，既保证了开发速度，又满足了复杂业务场景的处理要求。然而，在使用过程中也需要注意其可能带来的性能开销、学习成本增加以及配置管理的复杂度等问题，通过合理的项目规划和代码管理，可以有效规避这些问题，实现两者的和谐共存与高效协作，为项目开发提供更强大的支持。