还在用分页？太Low ！试试 MyBatis 流式查询，真心强大！

╰半夏微凉° 2023-01-01 03:40 134阅读 0赞

*来自：思否（作者：捏造的信仰）*

*原文链接**（底部链接可直达）：*

*https://segmentfault.com/a/1190000022478915*

## 基本概念    ##

**流式查询**指的是查询成功后不是返回一个集合而是返回一个迭代器，应用每次从迭代器取一条查询结果。流式查询的好处是能够降低内存使用。

如果没有流式查询，我们想要从数据库取 1000 万条记录而又没有足够的内存时，就不得不分页查询，而分页查询效率取决于表设计，如果设计的不好，就无法执行高效的分页查询。因此流式查询是一个数据库访问框架必须具备的功能。

流式查询的过程当中，数据库连接是保持打开状态的，因此要注意的是：执行一个流式查询后，数据库访问框架就不负责关闭数据库连接了，需要应用在取完数据后自己关闭。

## MyBatis 流式查询接口 ##

`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<Foo> 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<Foo> 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 也一并关闭了。

所以，解决这个问题的思路不复杂，保持数据库连接打开即可。我们至少有三种方案可选。关注公众号Java技术栈获取 Mybatis 及更多面试题带答案。

### 方案一：SqlSessionFactory ###

我们可以用 SqlSessionFactory 来手工打开数据库连接，将 Controller 方法修改如下：

@GetMapping("foo/scan/1/{limit}")
    public void scanFoo1(@PathVariable("limit") int limit) throws Exception {
        try (
            SqlSession sqlSession = sqlSessionFactory.openSession();  // 1
            Cursor<Foo> 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<Foo> cursor = fooMapper.scan(limit)) {
                cursor.forEach(foo -> { });
            } catch (IOException e) {
                e.printStackTrace();
            }
            return null;
        });
    }

上面的代码中，1 处我们创建了一个 TransactionTemplate 对象（此处 transactionManager 是怎么来的不用多解释，本文假设读者对 Spring 数据库事务的使用比较熟悉了），2 处执行数据库事务，而数据库事务的内容则是调用 Mapper 对象的流式查询。注意这里的 Mapper 对象无需通过 SqlSession 创建。

### 方案三：@Transactional 注解 ###

这个本质上和方案二一样，代码如下：

@GetMapping("foo/scan/3/{limit}")
    @Transactional
    public void scanFoo3(@PathVariable("limit") int limit) throws Exception {
        try (Cursor<Foo> cursor = fooMapper.scan(limit)) {
            cursor.forEach(foo -> { });
        }
    }

它仅仅是在原来方法上面加了个 `@Transactional` 注解。这个方案看上去最简洁，**但请注意 Spring 框架当中注解使用的坑****：****只在外部调用时生效**。在当前类中调用这个方法，依旧会报错。

以上是三种实现 MyBatis 流式查询的方法。

--------------------

推荐阅读：

*  [漫话：如何给女朋友解释什么是缓存穿透、缓存击穿、缓存雪崩？][Link 1]  
    
 *  [Spring Boot 集成 Seata 解决分布式事务问题][Spring Boot _ Seata]  
    
 *  [CTO：再写if-else，逮着罚款1000！][CTO_if-else_1000]  
    
 *  [1.3 万亿条数据查询，如何做到毫秒级响应？][1.3]

**![format_png][]喜欢我可以给我设为星标哦![format_png][]**

![format_png 1][]

![format_png 2][]

**好文章，我****“在看”**

![format_png 3][]

[Link 1]: http://mp.weixin.qq.com/s?__biz=Mzg3MjA4MTExMw%3D%3D&chksm=cef60939f981802f44df2877002adb2ce4225b3e2b876c5b1fcc5345545e0af099979adb1a32&idx=1&mid=2247498383&scene=21&sn=ff7831f3a815ff886640893e3ec7b4b9#wechat_redirect
[Spring Boot _ Seata]: http://mp.weixin.qq.com/s?__biz=Mzg3MjA4MTExMw%3D%3D&chksm=cef609eff98180f999899843d7568a64f7a62efde546de73e371fd078d143e951601ba6e6b94&idx=2&mid=2247498329&scene=21&sn=86366ee0178c6d7d9d29898684fa96bd#wechat_redirect
[CTO_if-else_1000]: http://mp.weixin.qq.com/s?__biz=Mzg3MjA4MTExMw%3D%3D&chksm=cef609a5f98180b349c49062f6614cb3d7620698292b96c9692efa8e27701707c2812804bd97&idx=1&mid=2247498259&scene=21&sn=77b32404ff8b927ced5a5d528fa4e1d7#wechat_redirect
[1.3]: http://mp.weixin.qq.com/s?__biz=Mzg3MjA4MTExMw%3D%3D&chksm=cef609a5f98180b33e1cf9e35634d2b7e77edfc51317bcc8454a46ba410dc4c0e7930fee9bb9&idx=2&mid=2247498259&scene=21&sn=e137537a1e879f8c66b6103c76e265bc#wechat_redirect
[format_png]: /images/20221120/649ba8ce8bc3423090eb4ef67a3f2e47.png
[format_png 1]: /images/20221120/3182086f20f54cc8b9f6d5cc0fc4a687.png
[format_png 2]: /images/20221120/f9a77bd849a34f22835c970d2c4625fd.png
[format_png 3]: /images/20221120/8ca8ffe695a64cacb3f7b85bc3f9fbfa.png