SqlSessionManager
SqlSessionManager本身实现了SqlSessionFactory, SqlSession两个接口,所以本身能够构建Sqlsession和使用Sqlsesion声明的CURD相关的查询方法。SqlSessionManager不能通过构造器进行实例化,只能通过newInstance()方法进行实例化,事实上,在newInstance()方法中调用了SqlSessionFactoryBuilder.build()方法实例化了一个DefaultSqlsessionFactory。然后再使用构造器进行实例化。
SqlSessionManager内部维护着三个属性sqlSessionFactory,sqlSessionProxy,localSqlSession。其中sqlSessionFactory的作用就是参与对sqlSessionProxy的构建,从下面的构造器代码就知道,sqlSessionProxy使用了动态代理模式创建了SqlSession的代理对象。在以后操作CURD相关方法时候,都会委托给这个代理对象。最后一个属性localSqlSession由一个本地线程进行维护,这样保证了并发安全,除了此功能外,这个属性体现了“纳管”这一概念,在执行完startManagedSession()方法后,会将对应线程的SqlSession进行管理,在使用代理模式创建代理实例时,不再通过opensession()方法进行获取,而是直接从本地线程中进行获取。除了这一点差异之外, SqlSessionManager还提供了多个额外的方法用于操作本地线程中的SqlSession对象。如下列方法:
- isManagedSessionStarted() 判断是否受到SqlSessionManager的管制,其本质是判断SqlSeesion对象是否在本地线程对象中
- getConnection() 从本地线程中获取连接对象
- close(); 关闭线程所属的SqlSession对象,并将SqlSession对象置为NULL
SqlSessionManager构造器代码和newInstance()方法
1 private SqlSessionManager(SqlSessionFactory sqlSessionFactory) { 2 this.sqlSessionFactory = sqlSessionFactory; 3 this.sqlSessionProxy = (SqlSession) Proxy.newProxyInstance( 4 SqlSessionFactory.class.getClassLoader(), 5 new Class[]{SqlSession.class}, 6 new SqlSessionInterceptor()); 7 } 8 //通过InputStream进行实例化 9 public static SqlSessionManager newInstance(InputStream inputStream, Properties properties) { 10 return new SqlSessionManager(new SqlSessionFactoryBuilder().build(inputStream, null, properties)); 11 } 12 //通过SqlSessionFactory 进行实例化 13 public static SqlSessionManager newInstance(SqlSessionFactory sqlSessionFactory) { 14 return new SqlSessionManager(sqlSessionFactory); 15 } 16 //通过Reader进行实例化 17 public static SqlSessionManager newInstance(Reader reader, String environment) { 18 return new SqlSessionManager(new SqlSessionFactoryBuilder().build(reader, environment, null));
我们知道使用JDK动态代理必须实现InvocationHandler接口并且覆写invoke()方法,SqlSessionManager构造器在实例化代理类时SqlSessionInterceptor类就实现了InvocationHandler接口,观察invoke()方法。invoke第一行代码尝试从本地线程中拿到Sqlsession,但如果未调用startManagedSession()方法,那么永远拿到的都是null值,也就是说,invoke每次通过openSession()方法拿到新实例。
1 private class SqlSessionInterceptor implements InvocationHandler { 2 public SqlSessionInterceptor() { 3 // Prevent Synthetic Access 4 } 5 6 @Override 7 public Object invoke(Object proxy, Method method, Object[] args) throws Throwable { 8 //从本地线程中获取获取SqlSession,使用SqlSessionManager时并不会向本地线程中放置Sqlsession,此时sqlsession实例为null,除非启用了startManagedSession() 9 final SqlSession sqlSession = SqlSessionManager.this.localSqlSession.get(); 10 if (sqlSession != null) { 11 try { 12 return method.invoke(sqlSession, args); 13 } catch (Throwable t) { 14 throw ExceptionUtil.unwrapThrowable(t); 15 } 16 } else { 17 //通过sqlSessionFactory获取SqlSession 18 final SqlSession autoSqlSession = openSession(); 19 try { 20 final Object result = method.invoke(autoSqlSession, args); 21 autoSqlSession.commit(); 22 return result; 23 } catch (Throwable t) { 24 autoSqlSession.rollback(); 25 throw ExceptionUtil.unwrapThrowable(t); 26 } finally { 27 autoSqlSession.close(); 28 } 29 } 30 } 31 }
运行一个实例
对比使用了startManagedSession()方法的SqlSessionManager和直接newInstance()的测试有什么不同。首先配置一个SqlMapper,存在一个list方法,查询学生表中的学生id,姓名,年纪三个值。
- SqlMapper接口
1 package com.zzz.mybatis.mapper; 2 3 import java.util.List; 4 import java.util.Map; 5 import org.apache.ibatis.annotations.Flush; 6 import org.apache.ibatis.annotations.MapKey; 7 import org.apache.ibatis.annotations.Select; 8 9 public interface SqlMapper { 10 @Select("select id,name,age from student") 11 public List<Map<String, Object>> list(); 12 13 @Flush 14 public void flush(); 15 16 @MapKey(value="id") 17 @Select("select id,name,age from student") 18 public Map<String,Map<String,String>> listByMapkey(); 19 }
- 单元测试类
1 package com.zzz.mybatis.service; 2 3 import org.apache.ibatis.session.SqlSessionManager; 4 import org.junit.Test; 5 6 public class SqlSessionManagerTest { 7 @Test 8 public void SqlSessionManagerByNewInstance() { 9 SqlSessionManager manager=SqlSessionManager.newInstance(getClass().getResourceAsStream("/mybatis-config.xml")); 10 Object rs=manager.selectOne("com.zzz.mybatis.mapper.SqlMapper.list"); 11 System.out.println(rs.toString()); 12 } 13 14 @Test 15 public void SqlSessionManagerByLocalThread() { 16 SqlSessionManager manager=SqlSessionManager.newInstance(getClass().getResourceAsStream("/mybatis-config.xml")); 17 manager.startManagedSession(); 18 Object rs=manager.selectOne("com.zzz.mybatis.mapper.SqlMapper.list"); 19 System.out.println(rs.toString()); 20 rs=manager.selectOne("com.zzz.mybatis.mapper.SqlMapper.list"); 21 System.out.println(rs.toString()); 22 } 23 24 }
- 运行结果
Setting autocommit to false on JDBC Connection [com.mysql.jdbc.JDBC4Connection@5e853265] ==> Preparing: select id,name,age from student ==> Parameters: <== Columns: id, name, age <== Row: 1, zhangsan, 22 <== Total: 1 Setting autocommit to false on JDBC Connection [com.mysql.jdbc.JDBC4Connection@57e1b0c] ==> Preparing: select id,name,age from student ==> Parameters: <== Columns: id, name, age <== Row: 1, zhangsan, 22 <== Total: 1
两者的区别和联系
两者的查询方式都是通过JDK的动态代理实现,只不过在sqlSessionProxy内部一个使用了本地线程获取SqlSession实例,一个使用openSession()方法获取SqlSession实例。使用debug观察使用了非manager.startManagedSession();所使用的SqlSession对象,可以看到localSqlSession中取到的值为NULL,SqlSession必须通过openSessiom()方法获取实例。
- 使用非startManagedSession()生成SqlSession实例
如果启用了startManagedSession()方法,则会从localSqlSession中获取SqlSession实例,可以看到两次的id号都是71,也就是两次查询都是同一个实例。
- 使用startManagedSession()生成SqlSession实例