MyBatis 使用步骤、实现原理与 MyBatis-Plus 扩展功能详解》

一、MyBatis 框架使用步骤（标准流程）

MyBatis 是一款优秀的半自动 ORM 框架，用于简化 JDBC 开发、实现数据库操作。

1. 引入依赖

在 Maven/Gradle 中引入 MyBatis 核心依赖 + 数据库驱动：

xml

<!-- MyBatis 核心 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>最新版本</version> </dependency> <!-- MySQL 驱动 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.28</version> </dependency>

2. 编写 MyBatis 核心配置文件

创建mybatis-config.xml，配置环境、数据源、别名、映射器：

xml

<configuration> <!-- 环境配置 --> <environments default="development"> <environment id="development"> <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> <!-- 注册 Mapper --> <mappers> <mapper resource="mapper/UserMapper.xml"/> </mappers> </configuration>

3. 创建实体类（POJO）

对应数据库表结构：

java

运行

public class User { private Long id; private String name; private Integer age; // getter/setter/toString }

4. 编写 Mapper 接口

定义数据库操作方法：

java

运行

public interface UserMapper { User selectById(Long id); }

5. 编写 SQL 映射文件（Mapper.xml）

绑定接口，编写 SQL：

xml

<mapper namespace="com.mapper.UserMapper"> <select id="selectById" resultType="com.entity.User"> select * from user where id = #{id} </select> </mapper>

6. 加载配置、获取 SqlSession、执行操作

java

运行

// 1. 加载配置文件 InputStream in = Resources.getResourceAsStream("mybatis-config.xml"); // 2. 创建 SqlSessionFactory SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(in); // 3. 获取 SqlSession SqlSession session = factory.openSession(); // 4. 获取 Mapper 代理对象 UserMapper userMapper = session.getMapper(UserMapper.class); // 5. 执行方法 User user = userMapper.selectById(1L); // 6. 关闭资源 session.close();

二、MyBatis 实现机制（底层原理）

MyBatis 本质是对 JDBC 的封装 + 动态代理 + SQL 解析执行。

1. 核心流程

1. 加载配置读取mybatis-config.xml和Mapper.xml，封装成Configuration对象。

2. 解析 Mapper解析 SQL、参数类型、返回值类型，生成MappedStatement对象。

3. 创建 SqlSessionFactory工厂模式，用于生产SqlSession。

4. 获取 SqlSession代表一次数据库连接，提供执行 SQL、获取 Mapper、事务控制等能力。

5. 动态代理生成 Mapper 实现类调用session.getMapper(UserMapper.class)时：

   • MyBatis 使用JDK 动态代理创建接口的代理对象
   • 代理对象拦截方法调用，根据方法名 + 命名空间找到对应的 SQL

6. 执行 SQL

   • 通过Executor执行器调度
   • 使用StatementHandler处理 SQL
   • 通过ParameterHandler设置参数
   • 通过ResultSetHandler封装结果集

2. 一句话总结原理

MyBatis 通过动态代理为 Mapper 接口生成代理对象，代理对象根据方法名找到对应的 SQL，最终通过 JDBC 执行并封装结果返回。

三、MyBatis-Plus（MP）扩展了哪些功能？

MyBatis-Plus 是 MyBatis 的增强工具，只增强不修改，简化单表 CRUD，提高开发效率。

1. 内置通用 CRUD 方法（无需写 SQL）

Mapper 继承BaseMapper即可直接使用：

• selectById()
• selectList()
• insert()
• updateById()
• delete()

无需编写 XML、无需定义方法。

2. 条件构造器（Wrapper）

支持链式、动态拼接 SQL 条件，无需手写复杂 SQL：

java

运行

QueryWrapper<User> wrapper = new QueryWrapper<>(); wrapper.eq("age", 20).like("name", "张"); List<User> list = userMapper.selectList(wrapper);

3. Lambda 条件构造器

防字段名写错，更安全：

java

运行

LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(User::getAge, 20).like(User::getName, "张");

4. 分页插件

只需配置插件，即可自动实现物理分页：

java

运行

Page<User> page = new Page<>(1, 10); userMapper.selectPage(page, wrapper);

5. AR 模式（ActiveRecord）

实体类继承Model即可直接调用 CRUD：

java

运行

User user = new User(); user.setName("张三"); user.insert();

6. 主键自动生成策略

支持：

• AUTO 自增
• ID_WORKER 雪花算法（默认）
• UUID
• NONE

7. 逻辑删除

配置后，delete变为update，数据不会真正删除：

• deleted=0未删除
• deleted=1已删除

8. 自动填充

创建时间、更新时间自动赋值：

• @TableField(fill = FieldFill.INSERT)
• @TableField(fill = FieldFill.INSERT_UPDATE)

9. 乐观锁插件

通过版本号实现并发控制：

• @Version

10. 代码生成器（经典 / 新版）

一键生成：

• Controller
• Service
• ServiceImpl
• Mapper
• Mapper.xml
• Entity

真正的零配置、高效率开发神器。

11. 其他高级特性

• 多租户
• 动态表名
• SQL 性能分析插件
• 防全表更新 / 删除插件
• 枚举类型处理器
• 自定义类型处理器

四、总结（博客收尾）

1. MyBatis 使用步骤：引包 → 配置 → 实体 → Mapper 接口 → XML → 测试
2. MyBatis 实现机制：配置解析 + 动态代理 + JDBC 封装
3. MyBatis-Plus：在 MyBatis 基础上提供通用 CRUD、条件构造器、分页、逻辑删除、自动填充、代码生成等