为 Amazon SQS 消息队列启用长轮询 - 适用于 Java 的 Amazon SDK 1.x
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

自2024年7月31日起, 适用于 Java 的 Amazon SDK 1.x已进入维护模式,并将于2025年12月31日end-of-support上线。我们建议您迁移到Amazon SDK for Java 2.x以继续接收新功能、可用性改进和安全更新。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

为 Amazon SQS 消息队列启用长轮询

Amazon SQS 默认使用短轮询,根据加权随机分布仅查询服务器的子集,以确定是否有任何消息可以包含在响应中。

长轮询可以减少在回复发送到 Amazon SQS 队列的 ReceiveMessage 请求时没有可返回的空响应数量,并消除虚假的空响应,从而降低使用 Amazon SQS 成本。

注意

您可以设置 1 到 20 秒的长轮询频率。

创建队列时启用长轮询

要在创建 Amazon SQS 队列时启用长轮询,请在调用 AmazonSQS 类createQueue的方法之前在CreateQueueRequest对象上设置ReceiveMessageWaitTimeSeconds属性。

导入

import com.amazonaws.services.sqs.AmazonSQS; import com.amazonaws.services.sqs.AmazonSQSClientBuilder; import com.amazonaws.services.sqs.model.AmazonSQSException; import com.amazonaws.services.sqs.model.CreateQueueRequest;

代码

final AmazonSQS sqs = AmazonSQSClientBuilder.defaultClient(); // Enable long polling when creating a queue CreateQueueRequest create_request = new CreateQueueRequest() .withQueueName(queue_name) .addAttributesEntry("ReceiveMessageWaitTimeSeconds", "20"); try { sqs.createQueue(create_request); } catch (AmazonSQSException e) { if (!e.getErrorCode().equals("QueueAlreadyExists")) { throw e; } }

请参阅上的完整示例 GitHub。

在现有队列上启用长轮询

除了在创建队列时启用长轮询外,您还可以通过在调用 AmazonSQS 类SetQueueAttributesRequestsetQueueAttributes之前的方法在现有队列ReceiveMessageWaitTimeSeconds上启用长轮询。

导入

import com.amazonaws.services.sqs.model.SetQueueAttributesRequest;

代码

SetQueueAttributesRequest set_attrs_request = new SetQueueAttributesRequest() .withQueueUrl(queue_url) .addAttributesEntry("ReceiveMessageWaitTimeSeconds", "20"); sqs.setQueueAttributes(set_attrs_request);

请参阅上的完整示例 GitHub。

在接收消息时启用长轮询

您可以在收到消息时启用长轮询功能,方法是在提供给 AmazonSQS 类ReceiveMessageRequestreceiveMessage的方法上设置等待时间(以秒为单位)。

注意

你应该确保 Amazon 客户端的请求超时大于最长轮询时间(20 秒),这样你的receiveMessage请求就不会在等待下一个投票事件时超时!

导入

import com.amazonaws.services.sqs.model.ReceiveMessageRequest;

代码

ReceiveMessageRequest receive_request = new ReceiveMessageRequest() .withQueueUrl(queue_url) .withWaitTimeSeconds(20); sqs.receiveMessage(receive_request);

请参阅上的完整示例 GitHub。

更多信息