队列。接口。豫
yuyan · 12 行 · 2511 字节 · UTF-8
1 2 3 4 5 6 7 8 9 10 11 12
寻观「标准库」之「语言核心」之「内建类型」之书。
「:文言:向获授之队列投一书。正文为 JSON 文(至多一二八 KB,即一二八零零零字节),延迟为零至四万三千二百秒(零谓不延);败则抛豫言之异。汉语:参数依次为队列绑定名、消息体 JSON 文字、延迟秒数。消息体是任意 JSON 值(文字不超过 128 KB,即 128000 字节),延迟须在 0 至 43200 之间(0 表示不延迟);违规、超限或平台拒绝时抛出豫言异常。:」
「发送队列消息」乃化「字符串」而化「字符串」而化「整数」而「有」也。
「:文言:一次投至多百书,各书为 {"body":…,"delaySeconds":整数(可省)},诸体合计至多二五六 KB(二五六零零零字节);败则抛豫言之异。汉语:参数依次为队列绑定名、JSON 数组文字;每项是 {"body":任意 JSON,"delaySeconds":0 至 43200 的整数(可省)};1 至 100 项,各体不超过 128000 字节、合计不超过 256000 字节;违规、超限或平台拒绝时抛出豫言异常。:」
「批量发送队列消息」乃化「字符串」而化「字符串」而「有」也。
「:文言:惟当前事为队列(读取入站事件种类为 queue)方可用;返当前批次之 JSON 文 {"queue":名,"messages":[{"id":文,"attempts":整数,"timestamp":毫秒整数,"body":JSON 值}…]}。汉语:只在当前事件是队列事件时可用;返回当前批次的 JSON 文字,messages 的顺序与序号(从 0 起)就是确认和重试所用的序号;其他事件或消息体不是 JSON 值时抛出豫言异常。:」
「读取队列批次」乃化「有」而「字符串」也。
「:文言:确认当前批次第序号书(自零起)已处毕;序号越界则抛豫言之异。汉语:显式确认当前批次中第 序号 条消息(从 0 起)已处理完毕,本次事件里不再重试它;序号越界或当前事件不是队列事件时抛出豫言异常。:」
「确认队列消息」乃化「整数」而「有」也。
「:文言:使第序号书于延迟之后重投;延迟零谓平台之默认,至多四万三千二百秒。汉语:请求第 序号 条消息重新投递;第二个参数是延迟秒数,0 表示平台默认延迟,须在 0 至 43200 之间;序号越界或当前事件不是队列事件时抛出豫言异常。:」
「重试队列消息」乃化「整数」而化「整数」而「有」也。