receiveMessage()
从Queue中接收message
方法参数ReceiveMessageRequest
queueName : String : required
tagName : String : optional
指定接收请求对应的Tag 如果此值未设置,即从Queue的默认Tag接收
maxReceiveMessageNumber : int : optional
接收到的message的最大数量
当Queue中有message可读时,请求会立即返回。因此实际收到的message的数量总是小于等于此数值
如果在请求中未设置此参数,将使用Queue的参数
Queue中默认值:100
合法范围: [1, 100]
maxReceiveMessageWaitSeconds : int : optional
如果在请求中未设置此参数,将使用Queue的参数
Queue中默认值:0
合法范围: [0, 20]
attributeName : String : optional
attributeValue : MessageAttribute : optional
attributeName与attributeValue配合使用,可以在接收message时按message附带的自定义属性进行过滤(message的自定义属性在sendMessage()
时定义)
如果没有设定这两个参数,表示接收全部message
如果指定attributeName的同时,将attributeValue中的字段type设为"empty",表示接收所有包含attributeName(大小写敏感)属性的message
否则,只有那些attributeName,attributeValue.type,attributeValue.value同时匹配的message才会被接收
(MessageAttribute类型的具体字段请参见sendMessage()
)
注: 用户在createTag()
时也可类似地指定过滤条件。二者的区别请参见FAQ。
方法返回List< ReceiveMessageResponse >
返回的message列表。其中ReceiveMessageResponse具体包括:
messageID : String
message标识符,与sendMessage的返回值相对应
receiptHandle : String
接收句柄,用以改变收到的message的不可见时间或删除message
接收到的message在使用后未即时删除,将重新变为可读并被再次接收。此时,两次接收到的messageID相同,但receiptHandle不同
messageBody : String
消息体
attributes : Map< String, String >
message的meta属性,包含以下内容中的某些项
注 8~12项为死信列队独有
- senderId:发送此条message的用户的developerId
- messageLength:messageBody的长度
- md5OfBody:messageBody的MD5校验和
- sendTimestamp:message到达EMQ server的时间戳
- receiveTimestamp:此次接收,message离开EMQ server的时间戳
- firstReceiveTimestamp:此message第一次接收时,message离开EMQ server的时间戳
- receiveCount:标识此message一共被接收到的次数,包含本次接收。如果此值经常大于0,且非用户刻意,则应考虑加大invisibilitySeconds
- sourceQueueName:源Queue的名称
- sourceTag:消息在源Queue中被以该Tag接收后,达到重新驱动的条件死亡
- deadTimestamp:消息在源Queue中被宣布死亡(不会再从源Queue中被相应的Tag接收)的时间
- originalMessageID:消息原始的MessageID,即在源Queue中的MessageID
- originalReceiveCount:消息在原始的Queue中被receive过的次数
- topic:即Message的topic属性,详见TopicQueue
- priority: 消息的优先级,详见PriorityQueue
messageAttributes : Map< String, MessageAttribute >
sendMessage时附带的用户自定义属性,具体含义可参见sendMessage()