扩展可插入软件包提供了一个执行可移动/异构协议的类,并提供类似数组的方法 有懒惰评价,类似于 执行者助手然而, 可扩展性提供了额外的方法,能够同时处理同步和同步迭代,自动处理 同步召回,并返回/移动转发,在使用时对适当的清理至关重要 数据库交易.
软件包导出一个 ExtendedIterable 类,可以以基本耐用方式构建或可以构建
毫无辩驳,而且加以配给 iterate 方法,以返回延时器.
例如,我们可以创建 ExtendedIterable数字 :
import { ExtendedIterable } from '@harperdb/extended-iterable';
function performQuery() {
let results = new ExtendedIterable();
results.iterate = function() {
let txn = startTxn(); // we can start a transaction in some database, and be notified of when the iterable is completed below
let cursor = txn.doQuery();
return {
// implement an iterator
next() {
// iterate through a query or table
let entry = cursor.getNext();
if (entry)
return { value: entry };
else
return { done: true };
},
return () { // called when the iterator is done
txn.commit();
},
throw () {
txn.abort();
}
}
};
return results;
}
回来的 ExtendedIterable 完全可执行 :
let extendedIterable = performQuery();
for (let value of extendedIterable) {
// for each value
}
或者我们可以在返回的结果上使用所提供的迭接方法:
extendedIterable
.filter((value) => test(value))
.forEach((value) => {
// for each value that matched the filter
})
请注意: map 财务报告和审定财务报表 filter 也懒惰,他们只会被处死 只有在他们返回的 累赘或 forEach 它被召唤。 这个 map 财务报告和审定财务报表 filter 函数还支持基于async/promise的函数,如果调用函数同步执行(返回承诺),则可以创建async stractionable.
我们还可以通过偏移查询以跳过一定数量的条目,并通过下列方式限制条目的数量:
let sliced = extendedIterable.slice(10, 20); // skip first 10 and get next 10
如果您想要从结果中获得一个真实的数组 asArray 属性将作为数组返回结果.
重排中抓取错误
在一个阵列, map 财务报告和审定财务报表 filter 调用符立即被执行,但智能调用符则在调用符时被执行,因此如果调用符时发生错误,在尝试调用符时会抛出错误. 同样关键的是,当一个迭代完成后,光标会被关闭,因此默认情况下,如果迭代过程中发生出错,光标会被立即关闭. 然而,如果你想抓住在 map (和 flatMap(重复时的回调,你可以使用 mapError 方法来捕捉重复过程中发生的错误,并允许重复继续(不关闭光标)。 例如:
let mapped = extendedIterable.map(({ key, value }) => {
return thisMightThrowError(value);
}).mapError((error) => {
// rather than letting the error terminate the iteration, we can catch it here and return a value to continue iterating:
return 'error occurred';
})
for (let entry of mapped) {
...
}
A 类 mapError callback 可以返回一个值来继续重复,或者扔出一个错误来终止重复.
许可证
这个图书馆根据麻省理工学院许可证的规定获得许可.