ServiceBusReceivedMessage (Azure SDK for Java Reference Documentation)

java.lang.Object
- com.azure.messaging.servicebus.ServiceBusReceivedMessage

```
public final class ServiceBusReceivedMessage
extends Object
```
The data structure encapsulating the message received from Service Bus. The message structure is discussed in detail in the product documentation.

See Also:

ServiceBusReceiverAsyncClient.receiveMessages(), ServiceBusReceiverClient.receiveMessages(int), Service Bus message payloads, AMQP 1.0 specification

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Map<String,Object>`	`getApplicationProperties()` Gets the set of free-form `ServiceBusReceivedMessage` properties which may be used for passing metadata associated with the `ServiceBusReceivedMessage` during Service Bus operations.
`com.azure.core.util.BinaryData`	`getBody()` Gets the payload wrapped by the `ServiceBusReceivedMessage`.
`String`	`getContentType()` Gets the content type of the message.
`String`	`getCorrelationId()` Gets a correlation identifier.
`String`	`getDeadLetterErrorDescription()` Gets the description for a message that has been dead-lettered.
`String`	`getDeadLetterReason()` Gets the reason a message was dead-lettered.
`String`	`getDeadLetterSource()` Gets the name of the queue or subscription that this message was enqueued on, before it was dead-lettered.
`long`	`getDeliveryCount()` Gets the number of the times this message was delivered to clients.
`long`	`getEnqueuedSequenceNumber()` Gets the enqueued sequence number assigned to a message by Service Bus.
`OffsetDateTime`	`getEnqueuedTime()` Gets the datetime at which this message was enqueued in Azure Service Bus.
`OffsetDateTime`	`getExpiresAt()` Gets the datetime at which this message will expire.
`OffsetDateTime`	`getLockedUntil()` Gets the datetime at which the lock of this message expires.
`String`	`getLockToken()` Gets the lock token for the current message.
`String`	`getMessageId()` Gets the identifier for the message.
`String`	`getPartitionKey()` Gets the partition key for sending a message to a partitioned entity.
`com.azure.core.amqp.models.AmqpAnnotatedMessage`	`getRawAmqpMessage()` The representation of message as defined by AMQP protocol.
`String`	`getReplyTo()` Gets the address of an entity to send replies to.
`String`	`getReplyToSessionId()` Gets or sets a session identifier augmenting the `ReplyTo` address.
`OffsetDateTime`	`getScheduledEnqueueTime()` Gets the scheduled enqueue time of this message.
`long`	`getSequenceNumber()` Gets the unique number assigned to a message by Service Bus.
`String`	`getSessionId()` Gets the session id of the message.
`String`	`getSubject()` Gets the subject for the message.
`Duration`	`getTimeToLive()` Gets the duration before this message expires.
`String`	`getTo()` Gets the "to" address.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - getApplicationProperties
```
public Map<String,Object> getApplicationProperties()
```
    Gets the set of free-form ServiceBusReceivedMessage properties which may be used for passing metadata associated with the ServiceBusReceivedMessage during Service Bus operations. A common use-case for properties() is to associate serialization hints for the ServiceBusReceivedMessage.getBody() as an aid to consumers who wish to deserialize the binary data.
    
    Returns:
    
    Application properties associated with this ServiceBusReceivedMessage.
    
    See Also:
    
    ServiceBusMessage.getApplicationProperties()
  - getBody
```
public com.azure.core.util.BinaryData getBody()
```
    Gets the payload wrapped by the ServiceBusReceivedMessage.
    The BinaryData wraps byte array and is an abstraction over many different ways it can be represented. It provides convenience APIs to serialize/deserialize the object.
    
    If the means for deserializing the raw data is not apparent to consumers, a common technique is to make use of ServiceBusReceivedMessage.getApplicationProperties() when creating the event, to associate serialization hints as an aid to consumers who wish to deserialize the binary data.
    
    Returns:
    
    Binary data representing the payload.
    
    See Also:
    
    ServiceBusMessage.getBody()
  - getContentType
```
public String getContentType()
```
    Gets the content type of the message.
    Optionally describes the payload of the message, with a descriptor following the format of RFC2045, Section 5, for example "application/json".
    
    Returns:
    
    The contentType of the ServiceBusReceivedMessage.
    
    See Also:
    
    ServiceBusMessage.getContentType()
  - getCorrelationId
```
public String getCorrelationId()
```
    Gets a correlation identifier.
    Allows an application to specify a context for the message for the purposes of correlation, for example reflecting the MessageId of a message that is being replied to.
    
    Returns:
    
    The correlation id of this message.
    
    See Also:
    
    ServiceBusMessage.getCorrelationId(), Message Routing and Correlation
  - getDeadLetterErrorDescription
```
public String getDeadLetterErrorDescription()
```
    Gets the description for a message that has been dead-lettered.
    
    Returns:
    
    The description for a message that has been dead-lettered; null otherwise.
    
    See Also:
    
    Dead-letter queues
  - getDeadLetterReason
```
public String getDeadLetterReason()
```
    Gets the reason a message was dead-lettered.
    
    Returns:
    
    The reason a message was dead-lettered; null otherwise.
    
    See Also:
    
    Dead-letter queues
  - getDeadLetterSource
```
public String getDeadLetterSource()
```
    Gets the name of the queue or subscription that this message was enqueued on, before it was dead-lettered.
    This value is only set in messages that have been dead-lettered and subsequently auto-forwarded from the dead-letter queue to another entity.
    
    Returns:
    
    The entity in which the message was dead-lettered; null otherwise.
    
    See Also:
    
    Dead-letter queues
  - getDeliveryCount
```
public long getDeliveryCount()
```
    Gets the number of the times this message was delivered to clients.
    The count is incremented when a message lock expires, or the message is explicitly abandoned by the receiver.
    
    Returns:
    
    delivery count of this message.
    
    See Also:
    
    Message transfers, locks, and settlement
  - getEnqueuedSequenceNumber
```
public long getEnqueuedSequenceNumber()
```
    Gets the enqueued sequence number assigned to a message by Service Bus.
    The sequence number is a unique 64-bit integer first assigned to a message as it is accepted at its original point of submission.
    
    Returns:
    
    The enqueued sequence number of this message
    
    See Also:
    
    Message Sequencing and Timestamps
  - getEnqueuedTime
```
public OffsetDateTime getEnqueuedTime()
```
    Gets the datetime at which this message was enqueued in Azure Service Bus.
    The UTC datetime at which the message has been accepted and stored in the entity. For scheduled messages, this reflects the time when the message was activated. This value can be used as an authoritative and neutral arrival time indicator when the receiver does not want to trust the sender's clock.
    
    Returns:
    
    The datetime at which the message was enqueued in Azure Service Bus.
    
    See Also:
    
    Message Sequencing and Timestamps
  - getExpiresAt
```
public OffsetDateTime getExpiresAt()
```
    Gets the datetime at which this message will expire.
    The value is the UTC datetime for when the message is scheduled for removal and will no longer available for retrieval from the entity. Expiry is controlled by the time-to-live property. This property is computed from enqueued time plus time-to-live.
    
    Returns:
    
    The OffsetDateTime at which this message expires.
    
    See Also:
    
    Message Expiration
  - getLockToken
```
public String getLockToken()
```
    Gets the lock token for the current message.
    The lock token is a reference to the lock that is being held by the broker in ServiceBusReceiveMode.PEEK_LOCK mode. Locks are used to explicitly settle messages as explained in the product documentation. The token can also be used to pin the lock permanently through the Deferral API and take the message out of the regular delivery state flow. This property is read-only.
    
    Returns:
    
    The lock-token for this message. null for messages retrieved via ServiceBusReceiveMode.RECEIVE_AND_DELETE mode.
    
    See Also:
    
    Message transfers, locks, and settlement
  - getLockedUntil
```
public OffsetDateTime getLockedUntil()
```
    Gets the datetime at which the lock of this message expires.
    For messages retrieved under a lock (peek-lock receive mode, not pre-settled) this property reflects the UTC datetime until which the message is held locked in the queue/subscription. When the lock expires, the delivery count is incremented and the message is again available for retrieval. This property is read-only.
    
    Returns:
    
    the datetime at which the lock of this message expires if the message is received using ServiceBusReceiveMode.PEEK_LOCK mode. Otherwise it returns null.
    
    See Also:
    
    Message transfers, locks, and settlement
  - getMessageId
```
public String getMessageId()
```
    Gets the identifier for the message.
    The message identifier is an application-defined value that uniquely identifies the message and its payload. The identifier is a free-form string and can reflect a GUID or an identifier derived from the application context. If enabled, the duplicate detection feature identifies and removes second and further submissions of messages with the same messageId.
    
    Returns:
    
    Id of the ServiceBusReceivedMessage.
    
    See Also:
    
    ServiceBusMessage.getMessageId()
  - getPartitionKey
```
public String getPartitionKey()
```
    Gets the partition key for sending a message to a partitioned entity.
    For partitioned entities, setting this value enables assigning related messages to the same internal partition, so that submission sequence order is correctly recorded. The partition is chosen by a hash function over this value and cannot be chosen directly. For session-aware entities, the sessionId property overrides this value.
    
    Returns:
    
    The partition key of this message.
    
    See Also:
    
    Partitioned entities, ServiceBusMessage.getPartitionKey()
  - getRawAmqpMessage
```
public com.azure.core.amqp.models.AmqpAnnotatedMessage getRawAmqpMessage()
```
    The representation of message as defined by AMQP protocol.
    
    Returns:
    
    the AmqpAnnotatedMessage representing AMQP message.
    
    See Also:
    
    Amqp Message Format.
  - getReplyTo
```
public String getReplyTo()
```
    Gets the address of an entity to send replies to.
    This optional and application-defined value is a standard way to express a reply path to the receiver of the message. When a sender expects a reply, it sets the value to the absolute or relative path of the queue or topic it expects the reply to be sent to.
    
    Returns:
    
    ReplyTo property value of this message
    
    See Also:
    
    Message Routing and Correlation
  - getReplyToSessionId
```
public String getReplyToSessionId()
```
    Gets or sets a session identifier augmenting the ReplyTo address.
    This value augments the ReplyTo information and specifies which SessionId should be set for the reply when sent to the reply entity.
    
    Returns:
    
    ReplyToSessionId property value of this message
    
    See Also:
    
    Message Routing and Correlation
  - getScheduledEnqueueTime
```
public OffsetDateTime getScheduledEnqueueTime()
```
    Gets the scheduled enqueue time of this message.
    This value is used for delayed message availability. The message is safely added to the queue, but is not considered active and therefore not retrievable until the scheduled enqueue time. Mind that the message may not be activated (enqueued) at the exact given datetime; the actual activation time depends on the queue's workload and its state.
    
    Returns:
    
    the datetime at which the message will be enqueued in Azure Service Bus
    
    See Also:
    
    Message Sequencing and Timestamps
  - getSequenceNumber
```
public long getSequenceNumber()
```
    Gets the unique number assigned to a message by Service Bus.
    The sequence number is a unique 64-bit integer assigned to a message as it is accepted and stored by the broker and functions as its true identifier. For partitioned entities, the topmost 16 bits reflect the partition identifier. Sequence numbers monotonically increase and are gapless. They roll over to 0 when the 48-64 bit range is exhausted. This property is read-only.
    
    Returns:
    
    sequence number of this message
    
    See Also:
    
    Message Sequencing and Timestamps
  - getSessionId
```
public String getSessionId()
```
    Gets the session id of the message.
    For session-aware entities, this application-defined value specifies the session affiliation of the message. Messages with the same session identifier are subject to summary locking and enable exact in-order processing and demultiplexing. For session-unaware entities, this value is ignored. See Message Sessions.
    
    Returns:
    
    The session id of the ServiceBusReceivedMessage.
    
    See Also:
    
    ServiceBusMessage.getSessionId()
  - getSubject
```
public String getSubject()
```
    Gets the subject for the message.
    This property enables the application to indicate the purpose of the message to the receiver in a standardized fashion, similar to an email subject line. The mapped AMQP property is "subject".
    
    Returns:
    
    The subject for the message.
    
    See Also:
    
    ServiceBusMessage.getSubject()
  - getTimeToLive
```
public Duration getTimeToLive()
```
    Gets the duration before this message expires.
    This value is the relative duration after which the message expires, starting from the datetime the message has been accepted and stored by the broker, as captured in ServiceBusReceivedMessage.getScheduledEnqueueTime(). When not set explicitly, the assumed value is the DefaultTimeToLive set for the respective queue or topic. A message-level TimeToLive value cannot be longer than the entity's DefaultTimeToLive setting and it is silently adjusted if it does.
    
    Returns:
    
    Time to live duration of this message
    
    See Also:
    
    Message Expiration
  - getTo
```
public String getTo()
```
    Gets the "to" address.
    This property is reserved for future use in routing scenarios and presently ignored by the broker itself. Applications can use this value in rule-driven auto-forward chaining scenarios to indicate the intended logical destination of the message.
    
    Returns:
    
    "To" property value of this message
    
    See Also:
    
    ServiceBusMessage.getTo()

Visit the Azure for Java Developers site for more Java documentation, including quick starts, tutorials, and code samples.

Class ServiceBusReceivedMessage

Method Summary

Methods inherited from class java.lang.Object

Method Detail

getApplicationProperties

getBody

getContentType

getCorrelationId

getDeadLetterErrorDescription

getDeadLetterReason

getDeadLetterSource

getDeliveryCount

getEnqueuedSequenceNumber

getEnqueuedTime

getExpiresAt

getLockToken

getLockedUntil

getMessageId

getPartitionKey

getRawAmqpMessage

getReplyTo

getReplyToSessionId

getScheduledEnqueueTime

getSequenceNumber

getSessionId

getSubject

getTimeToLive

getTo