【mybatis源码】重要对象

mybatis的各个对象说明：https://blog.csdn.net/hancoder/article/details/111244516
mybatis个人源码解析地址：https://blog.csdn.net/hancoder/article/details/110152732
mybatis插件分析：https://blog.csdn.net/hancoder/article/details/110914534

一、mybatis相关

这个章节的对象都是全局唯一的，即mybatis启动后，不管怎么样，全局都是单例的。

Configuration：全局唯一

MapperRegistry：mapper注册器，全局唯一，他主要负责addMapper注册的逻辑，和config是互相持有的

SqlSessionFactory：全局唯一。xml的解析结果最顶级是解析出来个SqlSessionFactory

SqlSession：每个线程都有自己的SqlSession

configuration

// properties文件的内容
Properties variables;
// 解析过的mapper.xml。有两种形式：接口 或 namespace:接口 。他叫防止接口和xml互相调用addMapper的死循环
Set<String> loadedResources;
// 解析好的sql
Map<String, MappedStatement> mappedStatements ;

MapperRegistry

全局唯一，他知道指定类型的接口是否被解析过

public class MapperRegistry {
    
    

  private final Configuration config;
    // knownMappers知道接口是否被解析过，如果被解析过，也可以通过他拿到对应的代理工厂
  private final Map<Class<?>, MapperProxyFactory<?>> knownMappers;

SqlSessionFactory

全局唯一

使用 SqlSessionFactory 的最佳实践是在应用运行期间不要重复创建多次，多次重建 SqlSessionFactory 被视为一种代码“坏味道（bad smell）”。因此 SqlSessionFactory 的最佳作用域是应用作用域。有很多方法可以做到，最简单的就是使用单例模式或者静态单例模式。

Element：任何一个标签都是一个元素

二、接口相关

MapperRegistry

防止重复解析

knownMappers

addMapper解析时会put进(type,MapperProxyFactory)

MapperProxyFactory

mapper代理工厂，每个类都有一个他的代理工厂

MapperProxy

MapperProxyFactory虽然每个类都有一个，但对于每个类也是全局唯一的，而MapperProxy就不一样了，不只是每个类都有一个，而且不同的session持有的还是不同的MapperProxy对象，虽然他们都是从同一个MapperProxy创建出来的

因为Mapper接口不能直接被实例化，Mybatis利用JDK动态代理，创建MapperProxy间接实例化Mapper对象。
MapperProxy还可以缓存MapperMethod对象

namespace

接口

三、sql相关

MappedStatement

持有sql的任何信息，被config持有着Map<String, MappedStatement> mappedStatements

public final class MappedStatement {
    
    

  private String resource;
  private Configuration configuration;
    SqlCommandType sqlCommandType;
    // 还有sql标签中的一些属性

介绍一下：

作用： MappedStatement与Mapper配置文件中的一个select/update/insert/delete节点相对应。
MappedStatement对象存储在Configuration对象的mappedStatements属性中，是一个HashMap，存储时key = 全限定类名 + 方法名，value = 对应的MappedStatement对象。

MapperMethod

每个mapper代理都是会话间隔离的

负责解析Mapper接口的方法，并封装成MapperMethod对象
将Sql命令的执行路由到恰当的SqlSesison方法上

持有属性：

SqlCommand command;是个内部类，
- name
- 增删改查类型的SqlCommandType
MethodSignature method;是个内部类
- boolean returnsMany;返回值的类型，下面4个选1
- boolean returnsMap;
- boolean returnsVoid;
- Class<?> returnType;
- String mapKey;
- Integer resultHandlerIndex;
- Integer rowBoundsIndex;//是否传过来了分页rowBounds
- SortedMap<Integer, String> params;
- boolean hasNamedParameters;

BoundSql形参映射

String sql;
List parameterMappings;
Object parameterObject;
Map<String, Object> additionalParameters;
MetaObject metaParameters;

public class BoundSql {
    
    

  private String sql;// 可以从中看出静态sql和动态sql的解析进度，如是否变成？
  private List<ParameterMapping> parameterMappings;// 对应的java形参和java类型的映射
  private Object parameterObject;//MapperMethod.ParamMap类型，
  private Map<String, Object> additionalParameters;
  private MetaObject metaParameters;

StatementHandler

封装了JDBC Statement操作，负责对JDBC statement 的操作，如设置参数、将Statement结果集转换成List集合

JDBC处理器

ParameterHandler

负责对用户传递的参数转换成JDBC Statement 所需要的参数

ResultSetHandler

负责将JDBC返回的ResultSet结果集对象转换成List类型的集合

TypeHandler

负责java数据类型和jdbc数据类型之间的映射和转换

四、会话相关

如何指定要使用的session类型：

SqlSession sqlSession = factory.openSession(ExecutorType.REUSE,true);//自动提交

Executor执行器

Executor会在执行openSession()的时候创建，返回的sqlSession里包含了指定的执行器。执行器分3种：

SimpleExecutor（普通的执行器，默认）：每次都会创建一个新的预处理器PrepareStatement。查询5个参数（SQL声明映射、参数、行范围、结果处理器、动态SQL语句）
- 每次都会创建一个新的预处理器PrepareStatement
BatchExecutor（重用语句并执行批量更新）：相同的SQL只进行一次预处理
ReuseExecutor（重用预处理语句prepared statements）：只针对修改操作，必须调用executor.doFlushStatements(isRoolback:false)，才会真正提交
- 批处理，就可以不用一条一条修改，可以100,100执行，
  - 但是他只针对修改操作。
  - doUpdate(SQL声明MappedStatemtn,具体SQL参数)。
  - 最后必须得自己调用doFlushStatement(isRollback:false)，才回生效

SqlSession

每个线程都应该有它自己的 SqlSession 实例。SqlSession 的实例是线程不安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。绝对不能将 SqlSession 实例的引用放在一个类的静态域，甚至一个类的实例变量也不行。也绝不能将 SqlSession 实例的引用放在任何类型的管理作用域中，比如 Servlet 架构中的 HttpSession。如果你现在正在使用一种 Web 框架，要考虑 SqlSession 放在一个和 HTTP 请求对象相似的作用域中。换句话说，每次收到的 HTTP 请求，就可以打开一个 SqlSession，返回一个响应，就关闭它。这个关闭操作是很重要的，你应该把这个关闭操作放到 finally 块中以确保每次都能执行关闭。

对应的处理器

StatementHandler：接口
- BaseStatementHandler：抽象类，实现接口
  - SimpleStatementHandler：下面3个实现了BaseStatementHandler
  - PreparedStatementHandler：
  - CallableStatementHandler：
- RoutingStatementHandler：实现StatementHandler，持有delegate，装饰者模式

public abstract class BaseStatementHandler implements StatementHandler {
    
    

  protected final Configuration configuration;// 全局唯一的配置
  protected final ObjectFactory objectFactory;
  protected final TypeHandlerRegistry typeHandlerRegistry;
  protected final ResultSetHandler resultSetHandler;
  protected final ParameterHandler parameterHandler;

  protected final Executor executor;// 执行器
  protected final MappedStatement mappedStatement;//
  protected final RowBounds rowBounds;//分页参数

  protected BoundSql boundSql;//

五、缓存相关

一级缓存：仅当前会话共享
二级缓存：全局都一致

BaseExecutor执行器抽象类

一级缓存
获取连接
query、update对应抽象方法doQuery()、doUpdate()，这个就是在3个执行器里实现的

二级缓存抽象到CachingExecutor（他的父接口也是Executor）（装饰者模式）

装饰者属性delegate指向BaseExecutor
把原来的SimpleExecutor作为构造参数传入
二级缓存提交后才会进入缓存cachingExecutor.comit(true);
二级缓存跨线程
先走二级缓存，再走一级缓存

if(list==null){
      
      
    list=delegate.query(ms,...);
    tcm.putObject(cache,key,list);
}