基本概念
流式查询指的是查询成功后不是返回一个集合而是返回一个迭代器,应用每次从迭代器取一条查询结果。流式查询的好处是能够降低内存使用。
如果没有流式查询,我们想要从数据库取 1000 万条记录而又没有足够的内存时,就不得不分页查询,而分页查询效率取决于表设计,如果设计的不好,就无法执行高效的分页查询。因此流式查询是一个数据库访问框架必须具备的功能。
流式查询的过程当中,数据库连接是保持打开状态的,因此要注意的是:执行一个流式查询后,数据库访问框架就不负责关闭数据库连接了,需要应用在取完数据后自己关闭。
MyBatis 流式查询接口
MyBatis 提供了一个叫 org.apache.ibatis.cursor.Cursor 的接口类用于流式查询,这个接口继承了 java.io.Closeable 和 java.lang.Iterable 接口,由此可知:
- Cursor 是可关闭的;
- Cursor 是可遍历的。
除此之外,Cursor 还提供了三个方法: - isOpen(): 用于在取数据之前判断 Cursor 对象是否是打开状态。只有当打开时 Cursor 才能取数据;
- isConsumed(): 用于判断查询结果是否全部取完。
- getCurrentIndex():返回已经获取了多少条数据。
示例:
@RestController
@Api(tags = "XcLogController")
@RequestMapping("/xc_log")
@Slf4j
public class XcLogController {
@Resource
private XcLogMapper xcLogMapper;
@ApiOperation("流式查询")
@RequestMapping(value = "/streamQuery", method = RequestMethod.GET)
@Transactional
public List<XcLog> streamQuery(XcLog xcLog) {
log.info("/xc_log/streamQuery");
// return xcLogMapper.streamQuery(xcLog);
try (Cursor<XcLog> cursor = xcLogMapper.streamQuery(xcLog)) {
cursor.forEach(t -> {
// log.info(t.toString());
});
} catch (IOException e) {
e.printStackTrace();
}
return null;
}
}
public interface XcLogMapper {
Cursor<XcLog> streamQuery(XcLog xcLog);
}
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.xc.xcspringboot.mapper.xcLog.XcLogMapper">
<resultMap id="XcLogResultMap" type="com.xc.xcspringboot.model.xcLog.XcLog">
<result column="id" property="id"/>
<result column="create_time" property="createTime"/>
<result column="update_time" property="updateTime"/>
<result column="is_delete" property="isDelete"/>
</resultMap>
<select id="streamQuery" resultMap="XcLogResultMap" resultSetType="FORWARD_ONLY" fetchSize="100">
select *
from xc_log
</select>
</mapper>
resultSetType="FORWARD_ONLY"
我们在访问数据库的时候,在读取返回结果的时候,可能要前后移动指针,比如我们先计算有多少条信息,这是我们就需要把指针移到最后来计算,然后再把指针移到最前面,逐条读取,有时我们只需要逐条读取就可以了。还有就是有只我们只需要读取数据,为了不破坏数据,我们可采用只读模式,有时我们需要望数据库里添加记录,这是我们就要采用可更新数据库的模式。
对于DB层,三种查询模式的参数如下所示
ResultSet.TYPE_FORWORD_ONLY 结果集的游标只能向下滚动。
ResultSet. TYPE_SCROLL_INSENSITIVE 结果集的游标可以上下移动,当数据库变化时,当前结果集不变。
ResultSet.TYPE_SCROLL_SENSITIVE 返回可滚动的结果集,当数据库变化时,当前结果集同步改变。