流式管，国产流式管
点击上方“Java精选”，选择“设为星标”
别问别人为什么，多问自己凭什么！
下方有惊喜留言必回，有问必答！
每一天进步一点点，是成功的开始...
基本概念
流式查询 指的是查询成功后不是返回一个集合而是返回一个迭代器，应用每次从迭代器取一条查询结果。流式查询的好处是能够降低内存使用。
如果没有流式查询，我们想要从数据库取 1000 万条记录而又没有足够的内存时，就不得不分页查询，而分页查询效率取决于表设计，如果设计的不好，就无法执行高效的分页查询。因此流式查询是一个数据库访问框架必须具备的功能。
流式查询的过程当中，数据库连接是保持打开状态的，因此要注意的是：执行一个流式查询后，数据库访问框架就不负责关闭数据库连接了，需要应用在取完数据后自己关闭。
MyBatis流式查询接口
org.apache.ibatis.cursor.Cursor是 提供的一个 接口类用于流式查询，这个接口继承了java.io.Closeable和java.lang.Iterable接口，由此可知：
1、Cursor 是可关闭的；
2、Cursor 是可遍历的。
除此之外，Cursor还提供了三个方法：
1、 isOpen() ：用于在取数据之前判断Cursor对象是否是打开状态。只有当打开时 Cursor 才能取数据；
2、 isConsumed() ：用于判断查询结果是否全部取完。
3、 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.
这是因为我们前面说了在取数据的过程中需要保持数据库连接，而 方法通常在执行完后连接就关闭了，因此Cusor也一并关闭了。
所以，解决这个问题的思路不复杂，保持数据库连接打开即可。我们至少有三种方案可选。
我们可以用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对象是打开状态的。
在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 -> { });
}
}
这种方式仅 仅只是在原来的方法上面加了个 @ 注解。这个方案看上去最简洁，但请注意 Spring 框架当中注解使用的坑：只在外部调用时生效。在当前类中调用这个方法，依旧会报错。
以上是三种实现 MyBatis 流式查询的方法。
作者：捏造的信仰 https://segmentfault.com/a/1190000022478915
公众号“Java精选”所发表内容注明来源的，版权归原出处所有（无法查证版权的或者未注明出处的均来自网络，系转载，转载的目的在于传递更多信息，版权属于原作者。如有侵权，请联系，笔者会第一时间删除处理！
------ THE END ------
精品资料，超赞福利！
3000+ 道各类技术面试题在线刷，最新、最全 Java 面试题！
期往精选 点击标题可跳转
技术交流群！
最近有很多人问，有没有读者交流群！想知道如何加入？方式很简单，兴趣相投的朋友，只需要点击下方卡片，回复“加群”，即可无套路入交流群！
文章有帮助的话，在看，转发吧！
流式管(国产流式管)转载请注明：流式管(国产流式管)