一、SqlSessionFactory
顾名思义就是不断地获取SqlSession的工厂,体现了一种简单工厂设计模式,从接口来看,里边重载了很多openSession方法,外加一个getConfiguration()获取Configuration配置类方法,并且只有一个默认实现类DefaultSqlSessionFactory。
SqlSessionFactory sqlSessionFactory=new SqlSessionFactoryBuilder().build(in);
SqlSessionFactoryBuilder从名字来看这里体现了一种建造者设计模式,所以我们只需要关心起build方法,最终都会走向如下。
public SqlSessionFactory build(InputStream inputStream, String environment, Properties properties) {
try {
//解析configuration配置文件用的
XMLConfigBuilder parser = new XMLConfigBuilder(inputStream, environment, properties);
return build(parser.parse());
} catch (Exception e) {
throw ExceptionFactory.wrapException("Error building SqlSession.", e);
} finally {
ErrorContext.instance().reset();
try {
inputStream.close();
} catch (IOException e) {
// Intentionally ignore. Prefer previous error.
}
}
}
最后build将返回new DefaultSqlSessionFactory(config)实例对象,从代码来看,SqlSessionFactory的实例化过程并不难,很容易理解。
二、DefaultSqlSessionFactory
这是SqlSessionFactory的默认实现类,构造方法的参数也只有一个Configuration,接下来就是openSession方法的实现,从源码可以知道,所有的openSession方法都会相应的调用到最终的openSessionFromDataSource和openSessionFromConnection这两个方法,一个是从数据源获取,另一个是从连接中获取。所以这里主要看看这两个方法。
从数据源:
private SqlSession openSessionFromDataSource(ExecutorType execType, TransactionIsolationLevel level, boolean autoCommit) {
Transaction tx = null;
try {
final Environment environment = configuration.getEnvironment();
final TransactionFactory transactionFactory = getTransactionFactoryFromEnvironment(environment);
tx = transactionFactory.newTransaction(environment.getDataSource(), level, autoCommit);
final Executor executor = configuration.newExecutor(tx, execType);
return new DefaultSqlSession(configuration, executor, autoCommit);
} catch (Exception e) {
closeTransaction(tx); // may have fetched a connection so lets call close()
throw ExceptionFactory.wrapException("Error opening session. Cause: " + e, e);
} finally {
ErrorContext.instance().reset();
}
}
- 从配置中获取Environment 实例
- 获取事务工厂:这里是从Environment 获取的,Environment 会根据配置文件中配置的transactionManager 的type类型来生成对应的实例对象(JDBC和MANAGED)区别在于一个是用JDBC来管理提交和回滚,而MANAGED则不会管理事务的提交和回滚。但是默认会关闭连接,所以需要在配置的时候加上这个属性。
- 实例化Transaction
- 实例化一个执行器(Executor 后续在重点分析)
- 返回DefaultSqlSession实例对象
另一种方式从连接中获取也是一样的逻辑。
三、总结
SqlSessionFactory就是SqlSession的实例化工厂,根据不同的需求(传递的参数)生产对应的SqlSession对象,其openSession方法最终都会调用openSessionFromDataSource和openSessionFromConnection方法,然后返回DefaultSqlSession实例,这里比较简单,我们发现不管是SqlSessionFactory还是SqlSession亦或是Executor等都离不开Configuration对象。所以接下来我们重点分析一下Configuration对象。
以上,有任何不对的地方,请指正,敬请谅解。