StatementHandler是MyBatis将SQL落地到数据库的核心组件，通过封装JDBC操作实现参数绑定、预编译执行与结果映射，全程基于Connection、Statement、ResultSet等标准接口，不耦合具体数据库厂商。
MyBatis 的 StatementHandler 是真正把 SQL 语句“落地”到数据库的关键组件，它不直接操作数据库，而是作为 JDBC 操作的封装层，把 MyBatis 的抽象逻辑（比如参数绑定、动态 SQL、结果映射）翻译成标准 JDBC 行为。
它和底层 JDBC 驱动的交互，本质上就是按 JDBC 规范创建、配置、执行 Statement/PreparedStatement，并处理返回结果。整个过程是面向接口、委托驱动的，不耦合具体数据库厂商。
StatementHandler 如何拿到 JDBC 的 Connection
StatementHandler 本身不管理连接，它依赖上层传入一个有效的 Connection 对象：
- 这个
Connection来自SqlSession所持有的Transaction（事务对象）； -
Transaction内部通过DataSource获取连接（例如 HikariCP、Druid 或原生DriverManager）； -
StatementHandler.prepare(connection, timeout)方法一被调用，就用这个连接去创建 JDBC 的 Statement 实例。
Connection conn = transaction.getConnection(); // 由事务提供 Statement stmt = handler.prepare(conn, 30); // prepare 内部调用 conn.prepareStatement(sql) 等
注意：这里的 conn 已经是真实由 JDBC 驱动（如 mysql-connector-java、postgresql-jdbc）创建的实例，具备与数据库通信能力。
立即学习“Java免费学习笔记（深入）”；
StatementHandler 怎么选择用 Statement 还是 PreparedStatement
这取决于 SQL 是否含参数，以及 MappedStatement 中的配置：
-
SimpleStatementHandler：对应java.sql.Statement，用于无参数、纯字符串拼接的 SQL（不推荐，易 SQL 注入，且无法复用执行计划）； -
PreparedStatementHandler（默认）：对应java.sql.PreparedStatement，对#{}占位符做预编译，由 JDBC 驱动完成参数类型绑定和转义； -
CallableStatementHandler：对应java.sql.CallableStatement，用于调用存储过程。
MyBatis 在创建 StatementHandler 时，会根据 MappedStatement.getSqlCommandType() 和 SQL 文本特征自动选型，绝大多数场景走的是 PreparedStatementHandler。
参数怎么从 Java 对象落到 JDBC Statement 上
不是简单 stmt.setString(1, "xxx")，而是一整套协作流程：
-
StatementHandler.parameterize(stmt)被调用； - 它内部委托给
ParameterHandler（通常是DefaultParameterHandler）； -
ParameterHandler遍历BoundSql.getParameterMappings()，获取每个参数名、JDBC 类型、Java 类型、TypeHandler； - 每个
TypeHandler（如StringTypeHandler、IntegerTypeHandler）负责调用类似ps.setString(i, value)的 JDBC 原生方法； - 所有这些调用最终由 JDBC 驱动接收，并序列化为数据库协议包（如 MySQL 的 COM_STMT_EXECUTE 包）发往服务端。
✅ 关键点：MyBatis 不自己解析 SQL 或拼字符串，而是让 JDBC 驱动做预编译 + 参数绑定，既安全又高效。
查询结果如何从 ResultSet 映射回 Java 对象
StatementHandler.query(stmt, resultHandler) 执行后：
- JDBC 驱动返回
ResultSet（本质是网络流或内存缓存的结果集游标）； -
StatementHandler不直接解析，而是交给ResultSetHandler； -
ResultSetHandler使用TypeHandler逐列读取rs.getString("name")、rs.getInt("id")等； - 再结合
resultMap或注解规则，组装成User、Order等目标对象。
这个过程完全基于 JDBC 标准接口，只要驱动实现了 ResultSet 的规范行为，MyBatis 就能兼容。
小结：交互链条很清晰
MyBatis Mapper 接口调用 → SqlSession → Executor → StatementHandler.prepare() → 从 Connection 创建 PreparedStatement → StatementHandler.parameterize() → ParameterHandler + TypeHandler 设置参数 → StatementHandler.query()/update() → JDBC 驱动执行 SQL 并返回 ResultSet/影响行数 → ResultSetHandler 处理结果 → 返回 Java 对象
所有环节都建立在 JDBC 四大核心接口之上：Connection、Statement（含子类）、ResultSet、SQLException。MyBatis 没有绕过 JDBC，而是把它用得更稳、更灵活、更可扩展。
