当前位置： 首页 > news >正文

MyBatis 和 MyBatis-Plus对比

news 2025/8/25 5:52:41

MyBatis 和 MyBatis-Plus 是 Java 生态中常用的持久层框架，其中 MyBatis-Plus 是在 MyBatis 基础上的增强工具（“只做增强，不做改变”）。下面从语法详解和优劣对比两部分展开说明。

一、MyBatis 语法详解

MyBatis 的核心是 “SQL 映射”，通过 XML 或注解将 Java 方法与 SQL 语句绑定，需手动定义 SQL 逻辑。其语法围绕 “配置文件 + Mapper 接口 + SQL 映射（XML / 注解）” 展开。

1. 核心配置文件（mybatis-config.xml）

用于全局配置 MyBatis，包括数据源、别名、插件、映射器等，示例如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration><!-- 1. 环境配置（数据源） --><environments default="dev"><environment id="dev"><transactionManager type="JDBC"/><dataSource type="POOLED"><property name="driver" value="com.mysql.cj.jdbc.Driver"/><property name="url" value="jdbc:mysql://localhost:3306/test"/><property name="username" value="root"/><property name="password" value="123456"/></dataSource></environment></environments><!-- 2. 别名配置（简化类名引用） --><typeAliases><package name="com.example.entity"/> <!-- 扫描包，别名默认为类名（首字母小写） --></typeAliases><!-- 3. 映射器（关联Mapper接口与SQL映射文件） --><mappers><package name="com.example.mapper"/> <!-- 扫描Mapper接口所在包 --></mappers>
</configuration>
2. Mapper 接口

定义数据操作方法，需与 SQL 映射（XML / 注解）绑定，示例如下：

public interface UserMapper {// 根据ID查询用户User selectById(Long id);// 新增用户int insert(User user);// 批量删除用户int deleteBatch(@Param("ids") List<Long> ids);
}
3. SQL 映射（XML 方式，核心）

通过 XML 标签定义 SQL，支持动态 SQL（MyBatis 一大特色），示例如下（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">
<!-- namespace绑定Mapper接口 -->
<mapper namespace="com.example.mapper.UserMapper"><!-- 1. 基础查询：根据ID查用户 --><select id="selectById" resultType="User"> <!-- id对应接口方法名，resultType对应返回类型（别名） -->SELECT id, username, age, create_time FROM user WHERE id = #{id} <!-- #{id}是参数占位符（预编译，防SQL注入） --></select><!-- 2. 新增用户 --><insert id="insert" parameterType="User"> <!-- parameterType是参数类型 -->INSERT INTO user(username, age, create_time) VALUES(#{username}, #{age}, #{createTime}) <!-- #{属性名}对应实体类字段（需与数据库字段映射） --></insert><!-- 3. 动态SQL：批量删除（if+foreach） --><delete id="deleteBatch">DELETE FROM user<where> <!-- where标签自动处理多余的AND/OR --><if test="ids != null and ids.size() > 0"> <!-- if标签：条件判断（test里是OGNL表达式） -->id IN <foreach collection="ids" item="id" open="(" close=")" separator=","> <!-- foreach遍历集合 -->#{id}</foreach></if></where></delete><!-- 4. 动态SQL：复杂查询（choose/when/otherwise） --><select id="selectByCondition" resultType="User">SELECT * FROM user<where><choose> <!-- choose类似Java的switch：只执行第一个满足条件的when --><when test="username != null">username LIKE CONCAT('%', #{username}, '%')</when><when test="age != null">age = #{age}</when><otherwise>1=1</otherwise> <!-- 默认条件（避免where后无内容） --></choose></where></select>
</mapper>
4. SQL 映射（注解方式，适合简单 SQL）

直接在 Mapper 接口方法上用注解定义 SQL，无需 XML，示例如下：

public interface UserMapper {@Select("SELECT id, username FROM user WHERE id = #{id}")User selectById(Long id);@Insert("INSERT INTO user(username, age) VALUES(#{username}, #{age})")int insert(User user);
}

二、MyBatis-Plus 语法详解

MyBatis-Plus（简称 “MP”）基于 MyBatis 开发，核心是 “增强 CRUD”—— 通过继承接口、条件构造器等简化开发，无需手动写基本 SQL，同时兼容 MyBatis 语法（可混合使用）。

1. 核心依赖与配置

需引入 MyBatis-Plus 依赖（需排除 MyBatis 重复依赖），配置与 MyBatis 类似，仅需新增 MP 专属插件（如分页插件），示例如下（Spring Boot 环境）：

@Configuration
@MapperScan("com.example.mapper") // 扫描Mapper接口
public class MyBatisPlusConfig {// 分页插件（MP提供，开箱即用）@Beanpublic MybatisPlusInterceptor mybatisPlusInterceptor() {MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); // 适配MySQLreturn interceptor;}
}
2. 核心接口：BaseMapper<T>（简化 CRUD）

MP 提供 BaseMapper<T> 接口，内置常用 CRUD 方法，自定义 Mapper 只需继承它即可，无需手动写 SQL。

示例：

// 实体类（需与数据库表映射，用MP注解）
@Data
@TableName("user") // 指定数据库表名（默认类名小写）
public class User {@TableId(type = IdType.AUTO) // 主键策略（自增）private Long id;private String username;private Integer age;@TableField("create_time") // 映射数据库字段（若属性名与字段名一致可省略）private LocalDateTime createTime;
}// Mapper接口：继承BaseMapper<T>，无需写方法
public interface UserMapper extends BaseMapper<User> { // 已继承BaseMapper的20+个方法：insert、selectById、updateById、deleteById、selectList等
}

直接调用继承的方法（Service 层示例）：

@Service
public class UserService {@Autowiredprivate UserMapper userMapper;public void testCRUD() {// 1. 新增User user = new User();user.setUsername("mp-test");user.setAge(20);userMapper.insert(user); // 直接调用BaseMapper的insert方法// 2. 根据ID查询User user = userMapper.selectById(1L);// 3. 更新（根据ID）user.setAge(21);userMapper.updateById(user); // 仅更新非null字段// 4. 删除（根据ID）userMapper.deleteById(1L);// 5. 查询所有List<User> users = userMapper.selectList(null); // 参数为条件构造器，null表示无条件}
}
3. 条件构造器：QueryWrapper/UpdateWrapper（动态 SQL 简化）

MP 提供 QueryWrapper（查询条件）和 UpdateWrapper（更新条件），通过链式方法动态构建条件，无需写 XML 动态 SQL 标签。

示例 1：QueryWrapper（查询条件）

public List<User> selectByCondition() {// 构建查询条件：查询年龄>20、用户名含"张"、且创建时间在2023年后的用户QueryWrapper<User> queryWrapper = new QueryWrapper<>();queryWrapper.gt("age", 20) // gt：大于（字段名用数据库列名，或实体类属性名）.like("username", "张") // like：模糊查询（默认%值%）.ge("create_time", LocalDateTime.of(2023, 1, 1, 0, 0, 0)) // ge：大于等于.orderByDesc("create_time"); // 排序：按创建时间降序// 调用selectList，传入条件构造器return userMapper.selectList(queryWrapper);
}

示例 2：UpdateWrapper（更新条件）

public void updateByCondition() {// 构建更新条件：将年龄<18的用户的username改为"未成年"UpdateWrapper<User> updateWrapper = new UpdateWrapper<>();updateWrapper.lt("age", 18) // lt：小于（条件）.set("username", "未成年"); // set：更新的字段及值// 调用update，传入null（无需实体类）和条件构造器userMapper.update(null, updateWrapper);
}
4. 分页查询（开箱即用）

MP 分页插件配置后，直接用 IPage 接口即可实现分页，无需手动写 LIMIT 语句：

public IPage<User> selectPage(int pageNum, int pageSize) {// 1. 创建分页对象（pageNum：页码，pageSize：每页条数）IPage<User> page = new Page<>(pageNum, pageSize);// 2. 调用selectPage方法（BaseMapper提供），传入分页对象和条件构造器（null表示查所有）return userMapper.selectPage(page, null); // 返回结果包含：总条数（total）、总页数（pages）、当前页数据（records）等
}
5. 其他增强功能（语法涉及注解 / 配置）

  • 逻辑删除：通过 @TableLogic 注解标记逻辑删除字段（如 deleted），删除时自动改为 “更新 deleted=1”，查询时自动过滤 deleted=0：

    @TableLogic // 标记逻辑删除字段
private Integer deleted;

  • 自动填充：通过 @TableField(fill = ...) 标记需自动填充的字段（如 createTime），配合 MetaObjectHandler 实现新增 / 更新时自动赋值：

    @TableField(fill = FieldFill.INSERT) // 新增时自动填充
private LocalDateTime createTime;// 自定义填充处理器
@Component
public class MyMetaObjectHandler implements MetaObjectHandler {@Overridepublic void insertFill(MetaObject metaObject) {this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now());}
}

  • 代码生成器：通过 AutoGenerator 自动生成 Entity、Mapper、Service、Controller 等代码，减少重复工作：

    public class CodeGenerator {public static void main(String[] args) {AutoGenerator generator = new AutoGenerator();// 配置数据源、包名、策略等（略）generator.execute(); // 执行生成}
}

三、MyBatis 与 MyBatis-Plus 的优劣对比

两者核心差异在于 “开发效率” 与 “灵活性” 的权衡，具体对比如下：

1. MyBatis 的优劣

优势：

  • 灵活性极高：开发者可完全控制 SQL 语句，支持复杂查询（如多表联查、子查询、自定义函数等），适合业务逻辑复杂的场景（如金融、电商核心业务）。
  • SQL 优化可控：可直接通过调整 SQL 语句优化性能（如索引利用、查询字段精简），对底层 SQL 透明。
  • 学习成本低：核心逻辑是 “SQL 映射”，只需掌握 XML / 注解与 SQL 的绑定，概念简单清晰。
  • 无额外依赖：轻量框架，仅需 MyBatis 核心包，无多余封装，适合对依赖体积敏感的项目。

劣势：

  • 重复代码多：基本 CRUD（增删改查）需手动写 SQL（即使逻辑简单），Mapper 接口、XML 映射文件需一一对应，开发效率低。
  • 动态 SQL 繁琐：复杂动态 SQL 需写大量 XML 标签（如 if/foreach/where），易出错且维护困难（如标签嵌套、语法错误）。
  • 功能需手动扩展：分页、逻辑删除等功能需自己实现（如自定义分页插件、手动加 deleted 判断），无开箱即用的解决方案。
2. MyBatis-Plus 的优劣

优势：

  • 开发效率极高：继承 BaseMapper 即可实现 80% 以上的基础 CRUD，无需写 SQL；条件构造器简化动态 SQL，无需 XML 标签。
  • 功能丰富且开箱即用：内置分页、逻辑删除、自动填充、代码生成器等功能，无需手动开发，适合快速迭代的项目（如后台管理系统、中小业务）。
  • 兼容 MyBatis：可无缝混合使用 MyBatis 语法（如复杂查询仍用 XML 写 SQL），既保留灵活性又提升效率。
  • 降低新手门槛：无需熟练掌握 XML 动态 SQL，通过条件构造器的链式方法即可完成大部分查询，新手易上手。

劣势：

  • 复杂查询灵活性不足：虽然支持自定义 SQL，但过度依赖条件构造器可能导致复杂查询（如多表联查 + 动态条件）写法繁琐，不如直接写 SQL 直观。
  • 框架依赖增加：需引入 MyBatis-Plus 依赖，且部分功能（如代码生成器）需额外配置，对 “轻量” 有要求的项目可能不适用。
  • 底层 SQL 透明性低：条件构造器生成的 SQL 需通过日志查看，若对 MP API 不熟悉，可能出现 “预期外 SQL”（如条件拼接错误），排查问题成本高。
  • 团队学习成本：需掌握 MP 专属 API（如条件构造器方法、注解），若团队成员不熟悉，可能出现用法不统一的问题。

四、总结：如何选择？

  • 选 MyBatis：若项目业务复杂（多复杂查询）、对 SQL 可控性要求高（需频繁优化），或团队更习惯直接写 SQL。
  • 选 MyBatis-Plus：若项目以基础 CRUD 为主（如后台管理系统）、追求快速开发，或需减少重复代码（如自动填充、分页），可大幅提升效率。

实际开发中，两者常结合使用：基础 CRUD 用 MP 简化开发，复杂查询用 MyBatis 的 XML 写原生 SQL，兼顾效率与灵活性。

http://www.xdnf.cn/news/1356625.html

相关文章：

  • 一个奇怪的问题-Python会替代Java吗？技术语言之争的真相-优雅草卓伊凡
  • 深度学习：CUDA、PyTorch下载安装
  • 用 Bright Data MCP Server 构建实时数据驱动的 AI 情报系统：从市场调研到技术追踪的自动化实战
  • 自由学习记录（87）
  • System.IO.Pipelines 与“零拷贝”：在 .NET 打造高吞吐二进制 RPC
  • 关于 svn无法查看下拉日志提示“要离线”和根目录看日志“no data” 的解决方法
  • 编译Marlin 1.1.9.1固件指南
  • 如何理解“向量”
  • 大数据、hadoop、爬虫、spark项目开发设计之基于数据挖掘的交通流量分析研究
  • 数据挖掘 4.1~4.7 机器学习性能评估参数
  • 【软考架构】云计算相关概念
  • 《CF1120D Power Tree》
  • Implementing Redis in C++ : E(AVL树详解)
  • 深入解析Apache Kafka的核心概念：构建高吞吐分布式流处理平台
  • 自动化运维之k8s——Kubernetes集群部署、pod、service微服务、kubernetes网络通信
  • Linux-函数的使用-编写监控脚本
  • Qt——网络通信(UDP/TCP/HTTP)
  • Linux学习-TCP网络协议
  • Linux shell脚本数值计算与条件执行
  • （计算机网络）JWT三部分及 Signature 作用
  • 如何在 IDEA 中在启动 Spring Boot 项目时加参数
  • [Windows] PDF-XChange Editor Plus官方便携版
  • 海盗王3.0客户端从32位升级64位之路
  • 操作系统文件系统
  • [e3nn] 等变神经网络 | 线性层o3.Linear | 非线性nn.Gate
  • Excel 转化成JSON
  • GPT 模型详解：从原理到应用
  • 第16届蓝桥杯C++中高级选拔赛（STEMA）2024年12月22日真题
  • 以国产IoTDB为代表的主流时序数据库架构与性能深度选型评测
  • 对象作为HashMap的key的注意事项