traverseiterator 方法
通过 invokefunction 或 invokescript 中返回的 session
和 Iterator id
来获取 Iterator 的具体值。
此方法是查询 Iterator 类型数据的方法,不会对区块链数据产生影响。
此方法由插件提供,需要安装 RpcServer 插件才可以调用。
要使用此方法,
RpcServer
插件的config.json
文件中SessionEnabled
字段的值必须为true
,并且需要先调用 invokefunction 或 invokescript 获取到Iterator id
和session
。
参数说明
-
session:缓存区 id。
-
iterator id:Iterator 数据存储 id。
-
count:每次返回的值数量,不能超过
RpcServer
插件的config.json
文件中MaxIteratorResultItems
字段的值。
session 是 invokefunction 或 invokescript 返回值中的
session
;iterator id 是 invokefunction 或 invokescript 返回值中stack
中的id
;session 和 iterator id 的有效期是RpcServer
插件的config.json
文件中SessionExpirationTime
字段设置的值,单位为秒。
调用示例
请求正文:
响应正文:
响应说明:
返回结果是遍历 Iterator 中前 count
个数据,继续请求会从第 count + 1
个开始继续遍历。