mybatis源码探索之SqlSession
SqlSessionFactory
SqlSessionFactory 使用了工厂模式创建SqlSession的，它的默认实现类是DefaultSqlSessionFactory。
方法
它共有以下几个方法：
public interface SqlSessionFactory {
SqlSession openSession();
SqlSession openSession(boolean autoCommit);
SqlSession openSession(Connection connection);
SqlSession openSession(TransactionIsolationLevel level);
SqlSession openSession(ExecutorType execType);
SqlSession openSession(ExecutorType execType, boolean autoCommit);
SqlSession openSession(ExecutorType execType, TransactionIsolationLevel level);
SqlSession openSession(ExecutorType execType, Connection connection);
Configuration getConfiguration();
}
可以根据参数的不同创建不同特性的SqlSession，具体实现可以参考DefaultSqlSessionFactory源码
DefaultSqlSessionFactory
它的核心方法是openSessionFromDataSource(ExecutorType execType, TransactionIsolationLevel level, boolean autoCommit)，从数据源中获取SqlSession。
private SqlSession openSessionFromDataSource(ExecutorType execType, TransactionIsolationLevel level, boolean autoCommit) {
Transaction tx = null;
try {
final Environment environment = configuration.getEnvironment();
//获取事务工厂，默认是ManagedTransactionFactory
final TransactionFactory transactionFactory = getTransactionFactoryFromEnvironment(environment);
tx = transactionFactory.newTransaction(environment.getDataSource(), level, autoCommit);
// 获取执行器，默认是SimpleExecutor
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();
}
}
常用的方法是openSession()，但是调用的还是核心方法。通过无参的openSession()方法创建SqlSession时，事务默认不自动提交，事务隔离级别null，默认执行器类型是ExecutorType.REUSE
@Override
public SqlSession openSession() {
return openSessionFromDataSource(configuration.getDefaultExecutorType(), null, false);
}
SqlSession
SqlSession 是 MyBaits 对外提供的最关键的核心接口，通过它可以执行数据库读写命令、获取映射器、管理事务等； SqlSession 也意味着客户端与数据库的一次连接，客户端对数据库的访问请求都是由SqlSession来处理的，SqlSession 由 SqlSessionFactory 创建，每个 SqlSession 都会引用 SqlSessionFactory 中全局唯一单例存在的 configuration 对象。
SqlSession的默认实现类是DefaultSqlSession
方法
SqlSession的方法主要分为以下6类：
1、SQL语句执行方法
2、立即批量更新方法
3、事务控制方法
4、本地缓存
5、映射器获取
6、SqlSession关闭
对应的主要方法如下：
SqlSession的方法中参数statement，都是**Mapper接口中的方法的全限定名，例如：mapperClasses.UserInfoMapper.selectByPrimaryKey。
1、SQL语句执行方法
int delete(String statement, Object parameter);
int insert(String statement, Object parameter);
int update(String statement, Object parameter);
void select(String statement, Object parameter, RowBounds rowBounds, ResultHandler handler);
<T> T selectOne(String statement, Object parameter);
<K, V> Map<K, V> selectMap(String statement, Object parameter, String mapKey, RowBounds rowBounds);
<E> List<E> selectList(String statement, Object parameter, RowBounds rowBounds, ResultHandler handler);
<T> Cursor<T> selectCursor(String statement, Object parameter, RowBounds rowBounds);
delete、insert方法最终调用的还是update方法，update源码如下：
public int update(String statement, Object parameter) {
try {
dirty = true;
// 获取MappedStatement
MappedStatement ms = configuration.getMappedStatement(statement);
return executor.update(ms, wrapCollection(parameter));
} catch (Exception e) {
throw ExceptionFactory.wrapException("Error updating database. Cause: " + e, e);
} finally {
ErrorContext.instance().reset();
}
}
select、selectOne最终调用的是selectList方法，selectMap方法也是通过selectList方法查询到结果的，只不过再查询之后又转换成了map对象。
selectList方法源码如下：
private <E> List<E> selectList(String statement, Object parameter, RowBounds rowBounds, ResultHandler handler) {
try {
MappedStatement ms = configuration.getMappedStatement(statement);
return executor.query(ms, wrapCollection(parameter), rowBounds, handler);
} catch (Exception e) {
throw ExceptionFactory.wrapException("Error querying database. Cause: " + e, e);
} finally {
ErrorContext.instance().reset();
}
}
selectOne源码：查询结果集如果是一个就取这个，多个则抛异常
public <T> T selectOne(String statement, Object parameter) {
// Popular vote was to return null on 0 results and throw exception on too many.
List<T> list = this.selectList(statement, parameter);
if (list.size() == 1) {
return list.get(0);
} else if (list.size() > 1) {
throw new TooManyResultsException("Expected one result (or null) to be returned by selectOne(), but found: " + list.size());
} else {
return null;
}
}
selectCursor提供了与List相同的结果，只是它使用迭代器惰性地获取数据。
selectCursor 应该很少使用（应该吧，至少我没有用过）
public <T> Cursor<T> selectCursor(String statement, Object parameter, RowBounds rowBounds) {
try {
MappedStatement ms = configuration.getMappedStatement(statement);
Cursor<T> cursor = executor.queryCursor(ms, wrapCollection(parameter), rowBounds);
registerCursor(cursor);
return cursor;
} catch (Exception e) {
throw ExceptionFactory.wrapException("Error querying database. Cause: " + e, e);
} finally {
ErrorContext.instance().reset();
}
}
2、立即批量更新方法
只有这个方法：
可以使用这个方法清除（执行）缓存在 JDBC 驱动类中的批量更新语句。
List flushStatements();
public List<BatchResult> flushStatements() {
try {
return executor.flushStatements();
} catch (Exception e) {
throw ExceptionFactory.wrapException("Error flushing statements. Cause: " + e, e);
} finally {
ErrorContext.instance().reset();
}
}
3、事务控制方法
//刷新缓存在 JDBC 驱动类中的批量语句并提交数据库连接，如果数据库连接没有updates/deletes/inserts被调用则不会提交
void commit();
//commit()升级版，可以根据参数来决定是否强制提交
void commit(boolean force);
//丢弃挂起的批处理语句并回滚数据库连接，如果数据库连接没有updates/deletes/inserts被调用则不会回滚
void rollback();
//rollback()的升级版，可以根据参数来决定是否强制回滚
void rollback(boolean force);
4、本地缓存
//清空本地缓存，只是清空本地缓存，跟二级缓存没关系
void clearCache();
5、映射器获取
//从configuration对象中的mapperRegistry(mapper注册表)中获取对应的*mapper对象
public <T> T getMapper(Class<T> type) {
return configuration.getMapper(type, this);
}
6、SqlSession关闭方法
//关闭session会话
void close();
举个栗子
public class UserTest {
private final static SqlSessionFactory sqlSessionFactory;
static {
String resource = "mybatis-config.xml";
Reader reader = null;
try {
reader = Resources.getResourceAsReader(resource);
} catch (IOException e) {
System.out.println(e.getMessage());
}
sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader);
}
@Test
public void test(){
SqlSession sqlSession = sqlSessionFactory.openSession();
UserInfoMapper mapper = sqlSession.getMapper(UserInfoMapper.class);
UserInfo userInfos = sqlSession.selectOne("mapperClasses.UserInfoMapper.selectByPrimaryKey" , 1L);
System.out.println(userInfos);
UserInfo userInfo = mapper.selectByPrimaryKey(4L);
System.out.println(userInfo);
}
}
使用mybatis进行crud有两种方式：
1、通过sqlSession提供的操作进行crud，这种是最原始的使用方式。这种方式可读性、可维护性都很差，一般很少使用。
UserInfo userInfos = sqlSession.selectOne("mapperClasses.UserInfoMapper.selectByPrimaryKey" , 1L);
2、通过mapper进行crud，最终调用的还是第一种的方式。这种方式是ibatis被谷歌收购后，谷歌进行升级的
UserInfoMapper mapper = sqlSession.getMapper(UserInfoMapper.class);
UserInfo userInfo = mapper.selectByPrimaryKey(4L);
能力有限，水平一般，如有错误，请多指出。
