X DevAPI 用户指南 / 第 9 章 使用结果集 /
9.4 一次获取所有数据项
除了第 9.3 节“使用数据集”fetchOne()
中
解释的 using 模式,它使应用程序能够一个接一个地使用数据项,X DevAPI 还提供了一个 using 模式,它将数据集的所有数据项作为列表传递到应用程序。不同的 X DevAPI 实现针对列表的编程语言使用适当的数据类型。因为使用了不同的数据类型,所以支持语言的本机构造来访问列表元素。以下示例假定架构存在并且员工表存在于.
fetchAll()
test
myTable
var myResult = myTable.select(['name', 'age']).
where('name like :name').bind('name','L%').
execute();
var myRows = myResult.fetchAll();
for (index in myRows){
print (myRows[index].name + " is " + myRows[index].age + " years old.");
}
当混合fetchOne()
和
fetchAll()
读取一个数据集时,请记住每次调用fetchOne()
或
fetchAll()
使用返回的数据项。消耗的物品不能再次请求。例如,如果应用程序调用fetchOne()
以获取数据集的第一个数据项,则后续调用将
fetchAll()
返回倒数第二个数据项。第一项不是 返回的数据项列表的一部分fetchAll()
。同样,在
fetchAll()
先前调用数据集后再次调用它时,第二次调用返回一个空集合。
fetchAll()
在将整个列表传递给应用程序之前
,强制连接器在内存中构建所有项目的列表。列表的生命周期独立于生成它的数据集的生命周期。
一旦发出查询并且在收到来自服务器的任何回复之前,异步查询执行将控制权返回给调用者。调用fetchAll()
读取异步查询执行产生的数据项可能会阻塞调用者。fetchAll()
在从服务器读取结果完成之前无法将控制返回给调用者。