關于MyBatis的知識點總結了個思維導圖分享給大家
基本概念
流式查詢指的是查詢成功后不是回傳一個集合而是回傳一個迭代器,應用每次從迭代器取一條查詢結果,流式查詢的好處是能夠降低記憶體使用,
如果沒有流式查詢,我們想要從資料庫取 1000 萬條記錄而又沒有足夠的記憶體時,就不得不分頁查詢,而分頁查詢效率取決于表設計,如果設計的不好,就無法執行高效的分頁查詢,因此流式查詢是一個資料庫訪問框架必須具備的功能,
流式查詢的程序當中,資料庫連接是保持打開狀態的,因此要注意的是:執行一個流式查詢后,資料庫訪問框架就不負責關閉資料庫連接了,需要應用在取完資料后自己關閉,
MyBatis 流式查詢介面
MyBatis 提供了一個叫 org.apache.ibatis.cursor.Cursor 的介面類用于流式查詢,這個介面繼承了 java.io.Closeable 和 java.lang.Iterable 介面,由此可知:
-
Cursor 是可關閉的;
-
Cursor 是可遍歷的,
除此之外,Cursor 還提供了三個方法:
-
isOpen():用于在取資料之前判斷 Cursor 物件是否是打開狀態,只有當打開時 Cursor 才能取資料;
-
isConsumed():用于判斷查詢結果是否全部取完,
-
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 也一并關閉了,
所以,解決這個問題的思路不復雜,保持資料庫連接打開即可,我們至少有三種方案可選,
方案一: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 流式查詢的方法,
轉載請註明出處,本文鏈接:https://www.uj5u.com/houduan/241719.html
標籤:Java
