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

MyBatis底层原理深度解析：动态代理与注解如何实现ORM映射

article 2025/3/13 22:56:23

一、引言

MyBatis作为一款优秀的ORM框架，其核心设计思想是通过动态代理和注解将接口方法与SQL操作解耦。开发者只需定义Mapper接口并添加注解，便能实现数据库操作，这背后隐藏着精妙的动态代理机制与源码设计。本文将从源码层解析MyBatis如何实现这一过程。

二、动态代理机制：从接口到实现类

关键点：MyBatis通过JDK动态代理为Mapper接口生成代理对象，拦截所有方法调用，将其路由到SQL执行逻辑。

1. Mapper接口代理的创建

// 用户定义的Mapper接口
public interface UserMapper {
    @Select("SELECT * FROM user WHERE id = #{id}")
    User selectById(int id);
}

// 获取Mapper代理对象
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

源码入口：SqlSession#getMapper()调用MapperRegistry.getMapper()，最终通过MapperProxyFactory创建代理。

// MapperProxyFactory核心代码
public class MapperProxyFactory<T> {
    public T newInstance(SqlSession sqlSession) {
        final MapperProxy<T> mapperProxy = new MapperProxy<>(sqlSession, mapperInterface, methodCache);
        return (T) Proxy.newProxyInstance(mapperInterface.getClassLoader(), new Class[]{mapperInterface}, mapperProxy);
    }
}

MapperProxy：实现InvocationHandler接口，拦截所有方法调用。

2. 方法拦截与路由

当调用userMapper.selectById(1)时，实际进入MapperProxy.invoke()：

// MapperProxy#invoke 简化逻辑
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
    if (method.isDefault()) { /* 处理默认方法 */ }
    // 将方法封装为MapperMethod对象
    final MapperMethod mapperMethod = cachedMapperMethod(method);
    return mapperMethod.execute(sqlSession, args);
}

MapperMethod：封装了SQL类型（SELECT/INSERT）、方法签名和返回类型。

三、注解解析：从注解到MappedStatement

关键流程：启动时解析Mapper接口的注解，生成MappedStatement，存储SQL和映射信息。

1. 注解解析入口

MapperAnnotationBuilder类负责解析接口方法上的注解：

// MapperAnnotationBuilder#parse 核心逻辑
public void parse() {
    for (Method method : type.getMethods()) {
        parseStatement(method); // 解析每个方法
    }
}

private void parseStatement(Method method) {
    final SqlCommandType sqlCommandType = getSqlCommandType(method);
    // 解析@Select、@Insert等注解
    final String sql = getSqlAnnotation(method); 
    // 构建MappedStatement
    builderAssistant.addMappedStatement(/* ... */);
}

2. 构建MappedStatement

每个方法对应一个MappedStatement，包含：

id：接口全限定名 + 方法名
sqlSource：解析后的SQL（含动态标签）
resultMaps：结果集映射配置

四、SQL执行与结果映射

1. 执行入口：MapperMethod.execute()

根据SQL类型调用SqlSession对应方法：

// MapperMethod#execute 简化逻辑
public Object execute(SqlSession sqlSession, Object[] args) {
    switch (command.getType()) {
        case SELECT:
            if (method.returnsVoid()) { /* ... */ }
            else {
                Object param = method.convertArgsToSqlCommandParam(args);
                return sqlSession.selectOne(command.getName(), param);
            }
        case INSERT: /* ... */
    }
}

2. 参数绑定与动态SQL

参数处理：使用ParamNameResolver解析方法参数名（支持@Param注解）。
动态SQL：SqlSource解析包含<if>,<foreach>等标签的SQL，生成可执行的SQL字符串。

3. 结果集映射

核心类：DefaultResultSetHandler

// 结果映射核心逻辑
List<Object> resultList = new ArrayList<>();
while (rs.next()) {
    Object resultObject = createResultObject(rs, resultMap, lazyLoader);
    // 通过反射或TypeHandler填充属性
    applyPropertyMappings(rs, resultObject);
    resultList.add(resultObject);
}
return resultList;