mybatis的xml调用流程

详细步骤分解
第一阶段：配置加载与初始化（应用启动时）
解析 MyBatis 主配置文件

系统启动时，通过 SqlSessionFactoryBuilder.build() 方法读取 mybatis-config.xml 文件。

解析全局配置：数据源（DataSource）、事务管理器（TransactionFactory）、环境（Environment）等。

解析类型别名（typeAliases）、插件（plugins）等配置。

解析 Mapper XML 文件

MyBatis 会扫描并解析所有配置的 Mapper XML 文件（如 UserMapper.xml）。

对于 XML 中的每个 SQL 标签（<select>, <insert>, <update>, <delete>）：

创建 MappedStatement 对象

Key：namespace + "." + id（例如：com.example.mapper.UserMapper.selectUserById）

Value：MappedStatement 对象（包含 SQL、参数类型、结果映射、缓存等信息）

将所有 MappedStatement 注册到 Configuration 对象中。

创建 SqlSessionFactory

使用解析完成的 Configuration 对象创建 DefaultSqlSessionFactory 实例。

至此，MyBatis 初始化完成，SqlSessionFactory 随时可以创建 SqlSession。

第二阶段：SQL 执行（运行时）
获取 SqlSession

java
SqlSession sqlSession = sqlSessionFactory.openSession();
创建新的 SqlSession 实例（非线程安全）。

同时会创建 Executor 执行器实例。

获取 Mapper 代理对象

java
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
MyBatis 使用 JDK 动态代理为 UserMapper 接口创建代理对象。

代理对象的方法调用会被 MapperProxy 拦截。

调用 Mapper 方法

java
User user = userMapper.selectUserById(1);
代理对象 MapperProxy 拦截方法调用。

根据接口全限定名 + 方法名构造 Statement ID：

text
com.example.mapper.UserMapper.selectUserById
查找 MappedStatement

代理对象通过 Configuration.getMappedStatement(statementId) 查找对应的 MappedStatement。

如果找不到，抛出异常。

转换参数

使用 ParameterHandler 将 Java 参数转换为 JDBC 参数。

根据 #{id} 中的参数名或顺序进行映射。

执行 SQL

Executor 通过 StatementHandler 执行 SQL：

创建 PreparedStatement

设置参数

执行查询

如果是查询，会先检查缓存。

结果映射

使用 ResultSetHandler 处理 ResultSet。

根据 XML 中配置的 resultMap 或 resultType 将结果行转换为 Java 对象。

处理关联关系（如果配置了 <association> 或 <collection>）。

返回结果

结果沿着调用链返回：ResultSetHandler → StatementHandler → Executor → SqlSession → MapperProxy → 应用程序。

关闭资源

java
sqlSession.close();
关闭 SqlSession，释放数据库连接和其他资源。

代码示例
1. MyBatis 主配置文件 (mybatis-config.xml)
xml
<?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>
    <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="password"/>
            </dataSource>
        </environment>
    </environments>
    
    <mappers>
        <!-- 注册Mapper XML文件 -->
        <mapper resource="mapper/UserMapper.xml"/>
    </mappers>
</configuration>
2. Mapper XML 文件 (UserMapper.xml)
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">
    
    <!-- 定义结果映射 -->
    <resultMap id="UserResultMap" type="User">
        <id property="id" column="id"/>
        <result property="name" column="name"/>
        <result property="email" column="email"/>
        <result property="createTime" column="create_time"/>
    </resultMap>
    
    <!-- select语句 -->
    <select id="selectUserById" parameterType="int" resultMap="UserResultMap">
        SELECT id, name, email, create_time 
        FROM users 
        WHERE id = #{id}
    </select>
    
    <!-- insert语句 -->
    <insert id="insertUser" parameterType="User" useGeneratedKeys="true" keyProperty="id">
        INSERT INTO users (name, email) 
        VALUES (#{name}, #{email})
    </insert>
</mapper>
3. Mapper 接口 (UserMapper.java)
java
package com.example.mapper;

import com.example.entity.User;

public interface UserMapper {
    // 方法名必须与XML中的id一致
    User selectUserById(int id);
    int insertUser(User user);
}
4. 应用程序调用
java
public class MyBatisXmlExample {
    public static void main(String[] args) throws IOException {
        // 1. 读取配置
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        
        // 2. 创建SqlSessionFactory
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        
        // 3. 获取SqlSession
        try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
            // 4. 获取Mapper代理对象
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            
            // 5. 调用方法 - 触发完整XML调用流程
            User user = userMapper.selectUserById(1);
            System.out.println("查询结果: " + user.getName());
            
            // 插入操作
            User newUser = new User();
            newUser.setName("张三");
            newUser.setEmail("zhangsan@example.com");
            int rows = userMapper.insertUser(newUser);
            System.out.println("插入行数: " + rows);
            
            // 提交事务
            sqlSession.commit();
        }
    }
}
关键特点总结
接口与XML绑定：通过 namespace（接口全限定名）和 id（方法名）建立关联。

动态代理：MyBatis 为 Mapper 接口生成代理对象，将方法调用转换为 SQL 执行。

MappedStatement：每个 SQL 操作对应一个 MappedStatement，存储在 Configuration 中。

类型安全：虽然使用 XML 配置，但通过接口调用，保持了类型安全。

灵活的结果映射：通过 resultMap 可以处理复杂的对象关系映射。

这种 XML 方式提供了最大的灵活性，可以编写复杂的 SQL 和结果映射，是 MyBatis 最强大的功能之一。