Represents a message that is received from the event bus in a handler.
Messages have a Message.body, which can be null, and also Message.headers, which can be empty.
If the message was sent specifying a reply handler it will also have a Message.replyAddress. In that case the message can be replied to using that reply address, or, more simply by just using Message.reply.
If you want to notify the sender that processing failed, then Message.fail can be called.
Constructor and description |
---|
Message
(java.lang.Object delegate) |
Type | Name and description |
---|---|
java.lang.String |
address() The address the message was sent to @return |
T |
body() The body of the message. |
void |
fail(int failureCode, java.lang.String message) Signal to the sender that processing of this message failed. |
java.lang.Object |
getDelegate() |
MultiMap |
headers() Multi-map of message headers. |
void |
reply(java.lang.Object message) Reply to this message. |
void |
reply(java.lang.Object message, io.vertx.core.Handler<io.vertx.core.AsyncResult<Message<R>>> replyHandler) The same as reply(R message) but you can specify handler for the reply - i.e.
|
void |
reply(java.lang.Object message, java.util.Map<java.lang.String, java.lang.Object> options) Link Message.reply but allows you to specify delivery options for the reply. |
void |
reply(java.lang.Object message, java.util.Map<java.lang.String, java.lang.Object> options, io.vertx.core.Handler<io.vertx.core.AsyncResult<Message<R>>> replyHandler) The same as reply(R message, DeliveryOptions) but you can specify handler for the reply - i.e.
|
java.lang.String |
replyAddress() The reply address. |
Methods inherited from class | Name |
---|---|
class java.lang.Object |
java.lang.Object#wait(long, int), java.lang.Object#wait(long), java.lang.Object#wait(), java.lang.Object#equals(java.lang.Object), java.lang.Object#toString(), java.lang.Object#hashCode(), java.lang.Object#getClass(), java.lang.Object#notify(), java.lang.Object#notifyAll() |
The address the message was sent to
The body of the message. Can be null.
Signal to the sender that processing of this message failed.
If the message was sent specifying a result handler the handler will be called with a failure corresponding to the failure code and message specified here.
failureCode
- A failure code to pass back to the sendermessage
- A message to pass back to the senderMulti-map of message headers. Can be empty
Reply to this message.
If the message was sent specifying a reply handler, that handler will be called when it has received a reply. If the message wasn't sent specifying a receipt handler this method does nothing.
message
- the message to reply with. The same as reply(R message)
but you can specify handler for the reply - i.e.
to receive the reply to the reply.
message
- the message to reply with.replyHandler
- the reply handler for the reply.Link Message.reply but allows you to specify delivery options for the reply.
message
- the reply messageoptions
- the delivery options (see DeliveryOptions) The same as reply(R message, DeliveryOptions)
but you can specify handler for the reply - i.e.
to receive the reply to the reply.
message
- the reply messageoptions
- the delivery options (see DeliveryOptions)replyHandler
- the reply handler for the reply.The reply address. Can be null.