标签：检索 cursor 数据库 流式 查询 Cursor limit Mybatis
# 前提概要
> **流式查询指的是查询成功后不是返回一个集合而是返回一个迭代器，应用每次从迭代器取一条查询结果。流式查询的好处是能够降低内存使用。**
> **如果没有流式查询，我们想要从数据库取1000万条记录而又没有足够的内存时，就不得不分页查询，而分页查询效率取决于表设计，如果设计的不好，就无法执行高效的分页查询。因此流式查询是一个数据库访问框架必须具备的功能**。
> **注意：流式查询的过程当中，数据库连接是保持打开状态的，因此要注意的是：执行一个流式查询后，数据库访问框架就不负责关闭数据库连接了，需要应用在取完数据后自己关闭**。
# 流式查询接口
> **MyBatis提供了一个叫`org.apache.ibatis.cursor.Cursor`的接口类用于流式查询，这个接口继承了`java.io.Closeable`和`java.lang.Iterable`接口，由此可知**：
- **Cursor是可关闭的，实际上当关闭Cursor时，也一并将数据库连接关闭了**；
- **Cursor是可遍历的**。
除此之外，Cursor还提供了三个方法：
- **isOpen()：用于在取数据之前判断Cursor对象是否是打开状态。只有当打开时Cursor才能取数据；**
- **isConsumed()：用于判断查询结果是否全部取完；**
- **getCurrentIndex()：返回已经获取了多少条数据。**
**因为Cursor实现了迭代器接口，因此在实际使用当中，从Cursor取数据非常简单：**
```java
try(Cursor cursor = mapper.querySomeData()) {
cursor.forEach(rowObject -> {
// ...
});
}
```
> **使用 try-resource 方式可以令 Cursor 自动关闭**。
但构建 Cursor 的过程不简单
我们举个实际例子。下面是一个 Mapper 类：
```java
@Mapper
public interface FooMapper {
@Select("select * from foo limit #{limit}")
Cursor
scan(@Param("limit") int limit);
}
```
> **方法 scan() 是一个非常简单的查询。我们在定义这个方法时，指定返回值为 Cursor 类型，MyBatis 就明白这个查询方法是一个流式查询**。
然后我们再写一个 SpringMVC Controller 方法来调用 Mapper（无关的代码已经省略）:
```java
@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 处是获取 Cursor 对象并保证它能最后关闭；2 处则是从 cursor 中取数据**。
上面的代码看上去没什么问题，但是执行scanFoo0(int)时会报错：
````
java.lang.IllegalStateException: A Cursor is already closed.
````
- 这是因为我们前面说了在取数据的过程中需要保持数据库连接，而 Mapper 方法通常在执行完后连接就关闭了，因此Cursor也一并关闭了。
- 所以，解决这个问题的思路不复杂，保持数据库连接打开即可。我们至少有三种方案可选。
## 方案一：SqlSessionFactory
我们可以用 SqlSessionFactory 来手工打开数据库连接，将 Controller 方法修改如下：
```java
@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 来执行一个数据库事务，这个过程中数据库连接同样是打开的。代码如下：
```java
@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 创建。
## 方案三：[@Transactional](https://my.oschina.net/u/3770144) 注解
这个本质上和方案二一样，代码如下：
```java
@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](https://my.oschina.net/u/3770144) 注解。这个方案看上去最简洁，但请注意 Spring 框架当中注解使用的坑：只在外部调用时生效。在当前类中调用这个方法，依旧会报错。
标签：检索,cursor,数据库,流式,查询,Cursor,limit,Mybatis
来源： https://blog.51cto.com/alex4dream/2949988
本站声明：
1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享；
2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关；
3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关；
4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除；
5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。
