Retrieve multiple messages from SQS

Question

I have multiple messages in SQS. The following code always returns only one, even if there are dozens visible (not in flight). setMaxNumberOfMessages I thought would allow multiple to be consumed at once .. have i misunderstood this?

 CreateQueueRequest createQueueRequest = new CreateQueueRequest().withQueueName(queueName);  String queueUrl = sqs.createQueue(createQueueRequest).getQueueUrl();  ReceiveMessageRequest receiveMessageRequest = new ReceiveMessageRequest(queueUrl);  receiveMessageRequest.setMaxNumberOfMessages(10);  List<Message> messages = sqs.receiveMessage(receiveMessageRequest).getMessages();  for (Message message : messages) {       // i'm a message from SQS  } 

I've also tried using withMaxNumberOfMessages without any such luck:

 receiveMessageRequest.withMaxNumberOfMessages(10); 

How do I know there are messages in the queue? More than 1?

 Set<String> attrs = new HashSet<String>();  attrs.add("ApproximateNumberOfMessages");  CreateQueueRequest createQueueRequest = new CreateQueueRequest().withQueueName(queueName);  GetQueueAttributesRequest a = new GetQueueAttributesRequest().withQueueUrl(sqs.createQueue(createQueueRequest).getQueueUrl()).withAttributeNames(attrs);  Map<String,String> result = sqs.getQueueAttributes(a).getAttributes();  int num = Integer.parseInt(result.get("ApproximateNumberOfMessages")); 

The above always is run prior and gives me an int that is >1

Thanks for your input

Answer 1

AWS API Reference Guide: Query/QueryReceiveMessage

Due to the distributed nature of the queue, a weighted random set of machines is sampled on a ReceiveMessage call. That means only the messages on the sampled machines are returned. If the number of messages in the queue is small (less than 1000), it is likely you will get fewer messages than you requested per ReceiveMessage call. If the number of messages in the queue is extremely small, you might not receive any messages in a particular ReceiveMessage response; in which case you should repeat the request.

and

MaxNumberOfMessages: Maximum number of messages to return. SQS never returns more messages than this value but might return fewer.

Answer 2

There is a comprehensive explanation for this (arguably rather idiosyncratic) behaviour in the SQS reference documentation.

SQS stores copies of messages on multiple servers and receive message requests are made to these servers with one of two possible strategies,

• Short Polling : The default behaviour, only a subset of the servers (based on a weighted random distribution) are queried.
• Long Polling : Enabled by setting the WaitTimeSeconds attribute to a non-zero value, all of the servers are queried.

In practice, for my limited tests, I always seem to get one message with short polling just as you did.