Enviar atributos de mensagem para uma fila do Amazon SQS - Amazon Simple Queue Service
Definir atributosEnviar uma mensagem com atributos

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Enviar atributos de mensagem para uma fila do Amazon SQS

É possível incluir metadados estruturados (como carimbos de data e hora, dados geoespaciais, assinaturas e identificadores) com mensagens usando os atributos de mensagem. Para obter mais informações, consulte Atributos de mensagem do Amazon SQS.

Antes de executar o código de exemplo, verifique se você configurou suas credenciais da AWS. Para mais informações, consulte Configurar as credenciais e a região da AWS para desenvolvimento no Guia do desenvolvedor do AWS SDK for Java 2.x.

Definir atributos

Para definir um atributo para uma mensagem, adicione o código a seguir que usa o tipo de dado MessageAttributeValue. Para obter mais informações, consulte Componentes de atributos de mensagem e Tipos de dados de atributos de mensagem.

O AWS SDK for Java calcula automaticamente as somas de verificação do corpo da mensagem e dos atributos da mensagem e as compara com os dados retornados pelo Amazon SQS. Para obter mais informações, consulte o Guia do desenvolvedor do AWS SDK for Java 2.x e Cálculo do resumo de mensagens MD5 para atributos de mensagem para outras linguagens de programação.

String

Este exemplo define um atributo String chamado Name com o valor Jane.

final Map<String, MessageAttributeValue> messageAttributes = new HashMap<>();
messageAttributes.put("Name", new MessageAttributeValue()
.withDataType("String")
.withStringValue("Jane"));
Number

Este exemplo define um atributo Number chamado AccurateWeight com o valor 230.000000000000000001.

final Map<String, MessageAttributeValue> messageAttributes = new HashMap<>();
messageAttributes.put("AccurateWeight", new MessageAttributeValue()
.withDataType("Number")
.withStringValue("230.000000000000000001"));
Binary

Este exemplo define um atributo Binary chamado ByteArray com o valor de uma matriz de 10 bytes não inicializada.

final Map<String, MessageAttributeValue> messageAttributes = new HashMap<>();
messageAttributes.put("ByteArray", new MessageAttributeValue()
.withDataType("Binary")
.withBinaryValue(ByteBuffer.wrap(new byte[10])));
String (custom)

Este exemplo define o atributo personalizado String.EmployeeId chamado EmployeeId com o valor ABC123456.

final Map<String, MessageAttributeValue> messageAttributes = new HashMap<>();
messageAttributes.put("EmployeeId", new MessageAttributeValue()
.withDataType("String.EmployeeId")
.withStringValue("ABC123456"));
Number (custom)

Este exemplo define o atributo personalizado Number.AccountId chamado AccountId com o valor 000123456.

final Map<String, MessageAttributeValue> messageAttributes = new HashMap<>();
messageAttributes.put("AccountId", new MessageAttributeValue()
.withDataType("Number.AccountId")
.withStringValue("000123456"));
nota

Como o tipo de dados base é Number, o método ReceiveMessage retorna 123456.

Binary (custom)

Este exemplo define um atributo personalizado Binary.JPEG chamado ApplicationIcon com o valor de uma matriz de 10 bytes não inicializada.

final Map<String, MessageAttributeValue> messageAttributes = new HashMap<>();
messageAttributes.put("ApplicationIcon", new MessageAttributeValue()
.withDataType("Binary.JPEG")
.withBinaryValue(ByteBuffer.wrap(new byte[10])));

Enviar uma mensagem com atributos

Este exemplo adiciona os atributos à SendMessageRequest antes de enviar a mensagem.

// Send a message with an attribute.
final SendMessageRequest sendMessageRequest = new SendMessageRequest();
sendMessageRequest.withMessageBody("This is my message text.");
sendMessageRequest.withQueueUrl(myQueueUrl);
sendMessageRequest.withMessageAttributes(messageAttributes);
sqs.sendMessage(sendMessageRequest);
Importante

Se você enviar uma mensagem para uma fila primeiro a entrar, primeiro a sair (FIFO), verifique se o método sendMessage é executado depois que você fornecer o ID do grupo de mensagens.

Se usar o método SendMessageBatch em vez de SendMessage, você deverá especificar os atributos da mensagem de cada mensagem no lote.