深入解析MyBatis源码与实战

MyBatis源码并实践

分析MyBatis源码并实践例子是一个系统性的学习过程，以下内容基于实际开发场景和源码结构组织，涵盖核心模块和典型用法。

MyBatis 核心架构分析

MyBatis的核心模块分为配置解析、SQL执行、结果映射和插件扩展四大模块。源码分析可从SqlSessionFactoryBuilder的构建过程入手，重点关注XMLConfigBuilder对配置文件的解析逻辑。

关键类：

• SqlSessionFactory：全局单例，管理数据库会话。
• Configuration：存储所有配置信息（映射器、类型处理器等）。
• Executor：执行SQL语句的核心接口。

示例1：动态SQL生成原理

动态SQL通过SqlNode和DynamicContext实现。例如标签解析为IfSqlNode，其apply()方法通过OGNL表达式判断条件是否成立。

// 示例：IfSqlNode源码片段
public boolean apply(DynamicContext context) {
    if (evaluator.evaluateBoolean(test, context.getBindings())) {
        contents.apply(context);
        return true;
    }
    return false;
}

示例2：一级缓存与二级缓存

一级缓存（BaseExecutor中的localCache）默认开启，生命周期与SqlSession相同。二级缓存需在映射文件中显式配置，通过CachingExecutor装饰器实现。

缓存失效场景：

• 执行insert/update/delete操作。
• 手动调用clearCache()方法。

---

示例3：插件开发（Interceptor）

自定义插件需实现Interceptor接口，通过@Intercepts注解指定拦截的目标方法。

@Intercepts({
    @Signature(type= Executor.class, method="query", 
              args={MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class})
})
public class ExamplePlugin implements Interceptor {
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        // 前置逻辑
        Object result = invocation.proceed();
        // 后置逻辑
        return result;
    }
}

示例4：类型处理器扩展

自定义类型处理器需继承BaseTypeHandler，例如将Java的LocalDateTime与数据库的TIMESTAMP转换：

public class LocalDateTimeTypeHandler extends BaseTypeHandler {
    @Override
    public void setNonNullParameter(PreparedStatement ps, int i, 
                                   LocalDateTime parameter, JdbcType jdbcType) {
        ps.setTimestamp(i, Timestamp.valueOf(parameter));
    }
    // 其他方法省略...
}

示例5：批量操作优化

通过BatchExecutor提升批量插入性能，需在创建SqlSession时指定执行器类型：

try (SqlSession session = sqlSessionFactory.openSession(ExecutorType.BATCH)) {
    UserMapper mapper = session.getMapper(UserMapper.class);
    for (User user : userList) {
        mapper.insert(user);
    }
    session.commit(); // 统一提交
}

调试技巧

1. 日志输出：在log4j.properties中配置org.apache.ibatis为DEBUG级别。
2. 断点位置：
   • DefaultSqlSession：跟踪SQL执行入口。
   • MapperProxy：分析接口方法调用链路。
3. 工具辅助：使用Arthas动态观察Configuration对象中的映射器注册情况。

常见问题排查

• 参数绑定错误：检查#{param}与@Param注解是否匹配。
• 缓存脏读：二级缓存跨会话更新时需设置flushCache="true"。
• 动态SQL失效：确认OGNL表达式语法正确（如test="name != null"）。

以上仅为部分示例，完整实践需结合MyBatis官方文档和实际业务场景扩展。建议从简单的CRUD操作开始，逐步深入插件、缓存等高级特性。

Spring Boot整合MyBatis

以下是Spring Boot整合MyBatis的源码实例，涵盖基础操作、动态SQL、插件开发等场景，适合学习和项目参考：

基础CRUD操作

1. 单表插入并返回主键
   使用@Options注解或实现插入后获取自增ID。

2. 批量插入数据
   通过标签实现批量插入，提升数据库性能。

3. 注解方式实现查询
   使用@Select注解直接编写SQL，简化XML配置。

4. 结果集映射
   通过@Results或解决字段名与属性名不一致问题。

5. 分页查询
   整合PageHelper插件实现物理分页，搭配P