【笔记-MyBatis】StatementHandler

时间:2024-07-16 06:59:48
Author:赵志乾
Date:2024-07-15
Declaration:All Right Reserved!!!

1. 简介

        StatementHandler封装了对JDBC各类Statement的操作,如设置fetchSize属性、设置查询超时时间、与数据库进行交互等;

public interface StatementHandler {

  // 用于创建JDBC Statement对象,并完成Statement对象的属性设置
  Statement prepare(Connection connection, Integer transactionTimeout) throws SQLException;
  // 用于使用MyBatis中的ParameterHandler组件为PreparedStatement和CallableStatement参数占位符设置值
  void parameterize(Statement statement) throws SQLException;
  // 将SQL命令添加到批处理列表中
  void batch(Statement statement) throws SQLException;
  // 调用Statement对象的execute方法执行更新语句,如:INSERT、UPDATE、DELETE语句
  int update(Statement statement) throws SQLException;
  // 执行查询语句,并使用ResultSetHandler处理查询结果集
  <E> List<E> query(Statement statement, ResultHandler resultHandler) throws SQLException;
  // 带游标的查询,返回Cursor对象,能够通过Iterator动态地从数据库中加载数据,适用于查询数据量较大的情况,避免将所有数据加载到内存中
  <E> Cursor<E> queryCursor(Statement statement) throws SQLException;
  // 获取Mapper配置的SQL信息,BoundSql封装了动态SQL解析后的SQL文本和参数映射信息
  BoundSql getBoundSql();
  // 获取ParameterHandler实例
  ParameterHandler getParameterHandler();
}

2. 类体系

        BaseStatementHandler是一个抽象类,封装了通用的处理逻辑及方法执行流程,具体方法由子类实现,使用了模板模式;

  • SimpleStatementHandler:封装了对JDBC Statement对象的操作;
  • PreparedStatementHandler:封装了对JDBC PreparedStatement对象的操作;
  • CallableStatementHandler:封装了对JDBC CallableStatement对象的操作;
  • RoutingStatementHandler:依据 Mapper配置中的statementType属性(取值为STATEMENT、PREPARED、CALLABLE)创建对应的StatementHandler实现;