关于MyBatis的知识点总结了个思惟导图分享给你们java
基本概念
流式查询指的是查询成功后不是返回一个集合而是返回一个迭代器,应用每次从迭代器取一条查询结果。流式查询的好处是可以下降内存使用。sql
若是没有流式查询,咱们想要从数据库取 1000 万条记录而又没有足够的内存时,就不得不分页查询,而分页查询效率取决于表设计,若是设计的很差,就没法执行高效的分页查询。所以流式查询是一个数据库访问框架必须具有的功能。数据库
流式查询的过程中,数据库链接是保持打开状态的,所以要注意的是:执行一个流式查询后,数据库访问框架就不负责关闭数据库链接了,须要应用在取完数据后本身关闭。apache
MyBatis 流式查询接口
MyBatis 提供了一个叫 org.apache.ibatis.cursor.Cursor 的接口类用于流式查询,这个接口继承了 java.io.Closeable 和 java.lang.Iterable 接口,由此可知:app
Cursor 是可关闭的;框架
Cursor 是可遍历的。spa
除此以外,Cursor 还提供了三个方法:.net
isOpen():用于在取数据以前判断 Cursor 对象是不是打开状态。只有当打开时 Cursor 才能取数据;设计
isConsumed():用于判断查询结果是否所有取完。3d
getCurrentIndex():返回已经获取了多少条数据
由于 Cursor 实现了迭代器接口,所以在实际使用当中,从 Cursor 取数据很是简单:
cursor.forEach(rowObject -> {...});
但构建 Cursor 的过程不简单
咱们举个实际例子。下面是一个 Mapper 类:
@Mapper
public interface FooMapper {
@Select("select * from foo limit #{limit}")
Cursor scan(@Param("limit") int limit);
}
方法 scan() 是一个很是简单的查询。经过指定 Mapper 方法的返回值为 Cursor 类型,MyBatis 就知道这个查询方法一个流式查询。
而后咱们再写一个 SpringMVC Controller 方法来调用 Mapper(无关的代码已经省略):
@GetMapping("foo/scan/0/{limit}")
public void scanFoo0(@PathVariable("limit") int limit) throws Exception {
try (Cursor cursor = fooMapper.scan(limit)) { // 1
cursor.forEach(foo -> {}); // 2
}
}
上面的代码中,fooMapper 是 @Autowired 进来的。注释 1 处调用 scan 方法,获得 Cursor 对象并保证它能最后关闭;2 处则是从 cursor 中取数据。
上面的代码看上去没什么问题,可是执行 scanFoo0() 时会报错:
java.lang.IllegalStateException: A Cursor is already closed.
这是由于咱们前面说了在取数据的过程当中须要保持数据库链接,而 Mapper 方法一般在执行完后链接就关闭了,所以 Cusor 也一并关闭了。
因此,解决这个问题的思路不复杂,保持数据库链接打开便可。咱们至少有三种方案可选。
方案一:SqlSessionFactory
咱们能够用 SqlSessionFactory 来手工打开数据库链接,将 Controller 方法修改以下:
@GetMapping("foo/scan/1/{limit}")
public void scanFoo1(@PathVariable("limit") int limit) throws Exception {
try (
SqlSession sqlSession = sqlSessionFactory.openSession(); // 1
Cursor cursor =
sqlSession.getMapper(FooMapper.class).scan(limit) // 2
) {
cursor.forEach(foo -> { });
}
}
上面的代码中,1 处咱们开启了一个 SqlSession (实际上也表明了一个数据库链接),并保证它最后能关闭;2 处咱们使用 SqlSession 来得到 Mapper 对象。这样才能保证获得的 Cursor 对象是打开状态的。
方案二:TransactionTemplate
在 Spring 中,咱们能够用 TransactionTemplate 来执行一个数据库事务,这个过程当中数据库链接一样是打开的。代码以下:
@GetMapping("foo/scan/2/{limit}")
public void scanFoo2(@PathVariable("limit") int limit) throws Exception {
TransactionTemplate transactionTemplate =
new TransactionTemplate(transactionManager); // 1
transactionTemplate.execute(status -> { // 2
try (Cursor cursor = fooMapper.scan(limit)) {
cursor.forEach(foo -> { });
} catch (IOException e) {
e.printStackTrace();
}
return null;
});
}
上面的代码中,1 处咱们建立了一个 TransactionTemplate 对象(此处 transactionManager 是怎么来的不用多解释,本文假设读者对 Spring 数据库事务的使用比较熟悉了),2 处执行数据库事务,而数据库事务的内容则是调用 Mapper 对象的流式查询。注意这里的 Mapper 对象无需经过 SqlSession 建立。
这个本质上和方案二同样,代码以下:
@GetMapping("foo/scan/3/{limit}")
@Transactional
public void scanFoo3(@PathVariable("limit") int limit) throws Exception {
try (Cursor cursor = fooMapper.scan(limit)) {
cursor.forEach(foo -> { });
}
}
它仅仅是在原来方法上面加了个 @Transactional 注解。这个方案看上去最简洁,但请注意 Spring 框架当中注解使用的坑:只在外部调用时生效。在当前类中调用这个方法,依旧会报错。
以上是三种实现 MyBatis 流式查询的方法。