如果沒有流式查詢，我們想要從數(shù)據(jù)庫取 1000 萬條記錄而又沒有足夠的內存時，就不得不分頁查詢，而分頁查詢效率取決于表設計，如果設計的不好，就無法執(zhí)行高效的分頁查詢。因此流式查詢是一個數(shù)據(jù)庫訪問框架必須具備的功能。

流式查詢的過程當中，數(shù)據(jù)庫連接是保持打開狀態(tài)的，因此要注意的是：執(zhí)行一個流式查詢后，數(shù)據(jù)庫訪問框架就不負責關閉數(shù)據(jù)庫連接了，需要應用在取完數(shù)據(jù)后自己關閉。

MyBatis 流式查詢接口

MyBatis 提供了一個叫org.apache.ibatis.cursor.Cursor的接口類用于流式查詢，這個接口繼承了java.io.Closeable和java.lang.Iterable接口，由此可知：

1. Cursor 是可關閉的；
2. Cursor 是可遍歷的。

除此之外，Cursor 還提供了三個方法：

1. isOpen()：用于在取數(shù)據(jù)之前判斷 Cursor 對象是否是打開狀態(tài)。只有當打開時 Cursor 才能取數(shù)據(jù)；
2. isConsumed()：用于判斷查詢結果是否全部取完。
3. getCurrentIndex()：返回已經獲取了多少條數(shù)據(jù)

因為 Cursor 實現(xiàn)了迭代器接口，因此在實際使用當中，從 Cursor 取數(shù)據(jù)非常簡單：

cursor.forEach(rowObject -> {...});

但構建 Cursor 的過程不簡單

我們舉個實際例子。下面是一個Mapper類：

@Mapper public interface FooMapper { @Select("select * from foo limit #{limit}") Cursorscan(@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 (Cursorcursor = fooMapper.scan(limit)) { // 1 cursor.forEach(foo -> {}); // 2 }
}

上面的代碼中，fooMapper 是@Autowired進來的。

• 注釋 1 處調用 scan 方法，得到 Cursor 對象并保證它能最后關閉；
• 注釋 2 處則是從 cursor 中取數(shù)據(jù)。

上面的代碼看上去沒什么問題，但是執(zhí)行scanFoo0()時會報錯：

java.lang.IllegalStateException: A Cursor is already closed.

這是因為我們前面說了在取數(shù)據(jù)的過程中需要保持數(shù)據(jù)庫連接，而 Mapper 方法通常在執(zhí)行完后連接就關閉了，因此 Cusor 也一并關閉了。

所以，解決這個問題的思路不復雜，保持數(shù)據(jù)庫連接打開即可。我們至少有三種方案可選。

方案一：SqlSessionFactory

我們可以用SqlSessionFactory來手工打開數(shù)據(jù)庫連接，將 Controller 方法修改如下：

@GetMapping("foo/scan/1/{limit}") public void scanFoo1(@PathVariable("limit") int limit) throws Exception { try (
        SqlSession sqlSession = sqlSessionFactory.openSession(); // 1 Cursorcursor = 
              sqlSession.getMapper(FooMapper.class).scan(limit)   // 2
    ) {
        cursor.forEach(foo -> { });
    }
}

上面的代碼中，1 處我們開啟了一個SqlSession（實際上也代表了一個數(shù)據(jù)庫連接），并保證它最后能關閉；2 處我們使用SqlSession來獲得Mapper對象。這樣才能保證得到的Cursor對象是打開狀態(tài)的。

方案二：TransactionTemplate

在 Spring 中，我們可以用TransactionTemplate來執(zhí)行一個數(shù)據(jù)庫事務，這個過程中數(shù)據(jù)庫連接同樣是打開的。代碼如下：

@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 (Cursorcursor = fooMapper.scan(limit)) {
            cursor.forEach(foo -> { });
        } catch (IOException e) {
            e.printStackTrace();
        } return null;
    });
}

上面的代碼中，1 處我們創(chuàng)建了一個TransactionTemplate對象（此處transactionManager是怎么來的不用多解釋，本文假設讀者對 Spring 數(shù)據(jù)庫事務的使用比較熟悉了），2 處執(zhí)行數(shù)據(jù)庫事務，而數(shù)據(jù)庫事務的內容則是調用 Mapper 對象的流式查詢。注意這里的 Mapper 對象無需通過SqlSession創(chuàng)建。

方案三：@Transactional 注解

這個本質上和方案二一樣，代碼如下：

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

它僅僅是在原來方法上面加了個@Transactional注解。這個方案看上去最簡潔，但請注意 Spring 框架當中注解使用的坑：只在外部調用時生效。在當前類中調用這個方法，依舊會報錯。

以上是三種實現(xiàn) MyBatis 流式查詢的方法。