Once a connection to the STOMP server has been made, client receives a StompClientConnection, that let send and receive STOMP frames.
Constructor and description |
---|
StompClientConnection
(java.lang.Object delegate) |
Type | Name and description |
---|---|
StompClientConnection |
abort(java.lang.String id) Aborts a transaction. |
StompClientConnection |
abort(java.lang.String id, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Aborts a transaction. |
StompClientConnection |
abort(java.lang.String id, java.util.Map<java.lang.String, java.lang.String> headers) Aborts a transaction. |
StompClientConnection |
abort(java.lang.String id, java.util.Map<java.lang.String, java.lang.String> headers, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Aborts a transaction. |
StompClientConnection |
ack(java.lang.String id) Sends an acknowledgement for a specific message. |
StompClientConnection |
ack(java.lang.String id, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Sends an acknowledgement for a specific message. |
StompClientConnection |
ack(java.lang.String id, java.lang.String txId) Sends an acknowledgement for the given frame. |
StompClientConnection |
ack(java.lang.String id, java.lang.String txId, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Sends an acknowledgement for the given frame. |
StompClientConnection |
beginTX(java.lang.String id, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Begins a transaction. |
StompClientConnection |
beginTX(java.lang.String id) Begins a transaction. |
StompClientConnection |
beginTX(java.lang.String id, java.util.Map<java.lang.String, java.lang.String> headers) Begins a transaction. |
StompClientConnection |
beginTX(java.lang.String id, java.util.Map<java.lang.String, java.lang.String> headers, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Begins a transaction. |
void |
close() Closes the connection without sending the DISCONNECT frame. |
StompClientConnection |
closeHandler(io.vertx.core.Handler<StompClientConnection> handler) Sets a handler notified when the STOMP connection is closed. |
StompClientConnection |
commit(java.lang.String id) Commits a transaction. |
StompClientConnection |
commit(java.lang.String id, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Commits a transaction. |
StompClientConnection |
commit(java.lang.String id, java.util.Map<java.lang.String, java.lang.String> headers) Commits a transaction. |
StompClientConnection |
commit(java.lang.String id, java.util.Map<java.lang.String, java.lang.String> headers, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Commits a transaction. |
StompClientConnection |
connectionDroppedHandler(io.vertx.core.Handler<StompClientConnection> handler) Sets a handler notified when the server does not respond to a ping request in time. |
StompClientConnection |
disconnect() Disconnects the client. |
StompClientConnection |
disconnect(io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Disconnects the client. |
StompClientConnection |
disconnect(java.util.Map<java.lang.String, java.lang.Object> frame) Disconnects the client. |
StompClientConnection |
disconnect(java.util.Map<java.lang.String, java.lang.Object> frame, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Disconnects the client. |
StompClientConnection |
errorHandler(io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> handler) Sets a handler notified when an ERROR frame is received by the client. |
java.lang.Object |
getDelegate() |
StompClientConnection |
nack(java.lang.String id) Sends a non-acknowledgement for the given message. |
StompClientConnection |
nack(java.lang.String id, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Sends a non-acknowledgement for the given message. |
StompClientConnection |
nack(java.lang.String id, java.lang.String txId) Sends a non-acknowledgement for the given frame. |
StompClientConnection |
nack(java.lang.String id, java.lang.String txId, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Sends a non-acknowledgement for the given frame. |
StompClientConnection |
pingHandler(io.vertx.core.Handler<StompClientConnection> handler) Sets a handler that let customize the behavior when a ping needs to be sent to the server. |
StompClientConnection |
receivedFrameHandler(io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> handler) Configures a received handler that get notified when a STOMP frame is received by the client. |
StompClientConnection |
send(java.util.Map<java.lang.String, java.lang.String> headers, Buffer body) Sends a SEND frame to the server. |
StompClientConnection |
send(java.util.Map<java.lang.String, java.lang.String> headers, Buffer body, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Sends a SEND frame to the server. |
StompClientConnection |
send(java.lang.String destination, Buffer body) Sends a SEND frame to the server to the given destination. |
StompClientConnection |
send(java.lang.String destination, Buffer body, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Sends a SEND frame to the server to the given destination. |
StompClientConnection |
send(java.util.Map<java.lang.String, java.lang.Object> frame = [:]) Sends the given frame to the server. |
StompClientConnection |
send(java.util.Map<java.lang.String, java.lang.Object> frame = [:], io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Sends the given frame to the server. |
StompClientConnection |
send(java.lang.String destination, java.util.Map<java.lang.String, java.lang.String> headers, Buffer body) Sends a SEND frame to the server to the given destination. |
StompClientConnection |
send(java.lang.String destination, java.util.Map<java.lang.String, java.lang.String> headers, Buffer body, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Sends a SEND frame to the server to the given destination. |
java.lang.String |
server()
|
java.lang.String |
session()
|
java.lang.String |
subscribe(java.lang.String destination, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> handler) Subscribes to the given destination. |
java.lang.String |
subscribe(java.lang.String destination, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> handler, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Subscribes to the given destination. |
java.lang.String |
subscribe(java.lang.String destination, java.util.Map<java.lang.String, java.lang.String> headers, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> handler) Subscribes to the given destination. |
java.lang.String |
subscribe(java.lang.String destination, java.util.Map<java.lang.String, java.lang.String> headers, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> handler, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Subscribes to the given destination. |
StompClientConnection |
unsubscribe(java.lang.String destination) Un-subscribes from the given destination. |
StompClientConnection |
unsubscribe(java.lang.String destination, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Un-subscribes from the given destination. |
StompClientConnection |
unsubscribe(java.lang.String destination, java.util.Map<java.lang.String, java.lang.String> headers) Un-subscribes from the given destination. |
StompClientConnection |
unsubscribe(java.lang.String destination, java.util.Map<java.lang.String, java.lang.String> headers, io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> receiptHandler) Un-subscribes from the given destination. |
java.lang.String |
version()
|
StompClientConnection |
writingFrameHandler(io.vertx.core.Handler<java.util.Map<java.lang.String, java.lang.Object>> handler) Configures a handler notified when a frame is going to be written on the wire. |
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() |
Aborts a transaction.
id
- the transaction id, must not be null
Aborts a transaction.
id
- the transaction id, must not be null
receiptHandler
- the handler invoked when the RECEIPT
frame associated with the transaction cancellation has been processed by the server. The handler receives the sent frame (ABORT
).Aborts a transaction. @{code id} parameter
id
- the transaction id, must not be null
headers
- additional headers to send to the server. The transaction
header is replaced by the value passed in theAborts a transaction. @{code id} parameter
id
- the transaction id, must not be null
headers
- additional headers to send to the server. The transaction
header is replaced by the value passed in thereceiptHandler
- the handler invoked when the RECEIPT
frame associated with the transaction cancellation has been processed by the server. The handler receives the sent frame (ABORT
). Sends an acknowledgement for a specific message. It means that the message has been handled and processed by the
client. The id
parameter is the message id received in the frame.
id
- the message id of the message to acknowledge Sends an acknowledgement for a specific message. It means that the message has been handled and processed by the
client. The id
parameter is the message id received in the frame.
id
- the message id of the message to acknowledgereceiptHandler
- the handler invoked when the RECEIPT
frame associated with the acknowledgment has been processed by the server. The handler receives the sent frame (ACK
).Sends an acknowledgement for the given frame. It means that the frame has been handled and processed by the client. The sent acknowledgement is part of the transaction identified by the given id.
id
- the message id of the message to acknowledgetxId
- the transaction idSends an acknowledgement for the given frame. It means that the frame has been handled and processed by the client. The sent acknowledgement is part of the transaction identified by the given id.
id
- the message id of the message to acknowledgetxId
- the transaction idreceiptHandler
- the handler invoked when the RECEIPT
frame associated with the acknowledgment has been processed by the server. The handler receives the sent frame (ACK
).Begins a transaction.
id
- the transaction id, must not be null
receiptHandler
- the handler invoked when the RECEIPT
frame associated with the transaction begin has been processed by the server. The handler receives the sent frame (BEGIN
).Begins a transaction.
id
- the transaction id, must not be null
Begins a transaction. @{code id} parameter
id
- the transaction id, must not be null
headers
- additional headers to send to the server. The transaction
header is replaced by the value passed in theBegins a transaction. @{code id} parameter
id
- the transaction id, must not be null
headers
- additional headers to send to the server. The transaction
header is replaced by the value passed in thereceiptHandler
- the handler invoked when the RECEIPT
frame associated with the transaction begin has been processed by the server. The handler receives the sent frame (BEGIN
). Closes the connection without sending the DISCONNECT
frame.
Sets a handler notified when the STOMP connection is closed.
handler
- the handlerCommits a transaction.
id
- the transaction id, must not be null
Commits a transaction.
id
- the transaction id, must not be null
receiptHandler
- the handler invoked when the RECEIPT
frame associated with the transaction commit has been processed by the server. The handler receives the sent frame (COMMIT
).Commits a transaction. @{code id} parameter
id
- the transaction id, must not be null
headers
- additional headers to send to the server. The transaction
header is replaced by the value passed in theCommits a transaction. @{code id} parameter
id
- the transaction id, must not be null
headers
- additional headers to send to the server. The transaction
header is replaced by the value passed in thereceiptHandler
- the handler invoked when the RECEIPT
frame associated with the transaction commit has been processed by the server. The handler receives the sent frame (COMMIT
). Sets a handler notified when the server does not respond to a ping
request in time. In other
words, this handler is invoked when the heartbeat has detected a connection failure with the server.
The handler can decide to reconnect to the server.
handler
- the handler Disconnects the client. Unlike the StompClientConnection.close method, this method send the DISCONNECT
frame to the
server.
Disconnects the client. Unlike the StompClientConnection.close method, this method send the DISCONNECT
frame to the
server.
receiptHandler
- the handler invoked when the RECEIPT
frame associated with the disconnection has been processed by the server. The handler receives the sent frame (DISCONNECT
). Disconnects the client. Unlike the StompClientConnection.close method, this method send the DISCONNECT
frame to the
server. This method lets you customize the DISCONNECT
frame.
frame
- the DISCONNECT
frame. (see Frame) Disconnects the client. Unlike the StompClientConnection.close method, this method send the DISCONNECT
frame to the
server. This method lets you customize the DISCONNECT
frame.
frame
- the DISCONNECT
frame. (see Frame)receiptHandler
- the handler invoked when the RECEIPT
frame associated with the disconnection has been processed by the server. The handler receives the sent frame (DISCONNECT
). Sets a handler notified when an ERROR
frame is received by the client. The handler receives the ERROR
frame and a reference on the StompClientConnection.
handler
- the handler Sends a non-acknowledgement for the given message. It means that the message has not been handled by the client.
The id
parameter is the message id received in the frame.
id
- the message id of the message to acknowledge Sends a non-acknowledgement for the given message. It means that the message has not been handled by the client.
The id
parameter is the message id received in the frame.
id
- the message id of the message to acknowledgereceiptHandler
- the handler invoked when the RECEIPT
frame associated with the non-acknowledgment has been processed by the server. The handler receives the sent frame (NACK
).Sends a non-acknowledgement for the given frame. It means that the frame has not been handled by the client. The sent non-acknowledgement is part of the transaction identified by the given id.
id
- the message id of the message to acknowledgetxId
- the transaction idSends a non-acknowledgement for the given frame. It means that the frame has not been handled by the client. The sent non-acknowledgement is part of the transaction identified by the given id.
id
- the message id of the message to acknowledgetxId
- the transaction idreceiptHandler
- the handler invoked when the RECEIPT
frame associated with the non-acknowledgment has been processed by the server. The handler receives the sent frame (NACK
).Sets a handler that let customize the behavior when a ping needs to be sent to the server. Be aware that changing the default behavior may break the compliance with the STOMP specification.
handler
- the handlerConfigures a received handler that get notified when a STOMP frame is received by the client. This handler can be used for logging, debugging or ad-hoc behavior. The frame can still be modified by the handler.
Unlike StompClient.receivedFrameHandler, the given handler won't receive the CONNECTED
frame. If a received frame handler is set on the StompClient, it will be used by all
clients connection, so calling this method is useless, except if you want to use a different handler.
handler
- the handler Sends a SEND
frame to the server.
headers
- the headers, must not be null
body
- the body, may be null
Sends a SEND
frame to the server.
headers
- the headers, must not be null
body
- the body, may be null
receiptHandler
- the handler invoked when the RECEIPT
frame associated with the sent frame has been received. The handler receives the sent frame. Sends a SEND
frame to the server to the given destination. The message does not have any other header.
destination
- the destination, must not be null
body
- the body, may be null
Sends a SEND
frame to the server to the given destination. The message does not have any other header.
destination
- the destination, must not be null
body
- the body, may be null
receiptHandler
- the handler invoked when the RECEIPT
frame associated with the sent frame has been received. The handler receives the sent frame.Sends the given frame to the server.
frame
- the frame (see Frame)Sends the given frame to the server.
frame
- the frame (see Frame)receiptHandler
- the handler invoked when the RECEIPT
frame associated with the sent frame has been received. The handler receives the sent frame. Sends a SEND
frame to the server to the given destination.
destination
- the destination, must not be null
headers
- the header. The destination
header is replaced by the value given to the destination
parameterbody
- the body, may be null
Sends a SEND
frame to the server to the given destination.
destination
- the destination, must not be null
headers
- the header. The destination
header is replaced by the value given to the destination
parameterbody
- the body, may be null
receiptHandler
- the handler invoked when the RECEIPT
frame associated with the sent frame has been received. The handler receives the sent frame.
Subscribes to the given destination. This destination is used as subscription id.
destination
- the destination, must not be null
handler
- the handler invoked when a message is received on the given destination. Must not be null
.Subscribes to the given destination. This destination is used as subscription id.
destination
- the destination, must not be null
handler
- the handler invoked when a message is received on the given destination. Must not be null
.receiptHandler
- the handler invoked when the RECEIPT
frame associated with the subscription has been received. The handler receives the sent frame (SUBSCRIBE
).Subscribes to the given destination.
destination
- the destination, must not be null
.headers
- the headers to configure the subscription. It may contain the ack
header to configure the acknowledgment policy. If the given set of headers contains the id
header, this value is used as subscription id.handler
- the handler invoked when a message is received on the given destination. Must not be null
.Subscribes to the given destination.
destination
- the destination, must not be null
headers
- the headers to configure the subscription. It may contain the ack
header to configure the acknowledgment policy. If the given set of headers contains the id
header, this value is used as subscription id.handler
- the handler invoked when a message is received on the given destination. Must not be null
.receiptHandler
- the handler invoked when the RECEIPT
frame associated with the subscription has been received. The handler receives the sent frame (SUBSCRIBE
). Un-subscribes from the given destination. This method only works if the subscription did not specifies a
subscription id (using the id
header).
destination
- the destination Un-subscribes from the given destination. This method only works if the subscription did not specifies a
subscription id (using the id
header).
destination
- the destinationreceiptHandler
- the handler invoked when the RECEIPT
frame associated with the un-subscription has been received. The handler receives the sent frame (UNSUBSCRIBE
). Un-subscribes from the given destination. This method computes the subscription id as follows. If the given
headers contains the id
header, the header value is used. Otherwise the destination is used.
destination
- the destinationheaders
- the headers Un-subscribes from the given destination. This method computes the subscription id as follows. If the given
headers contains the id
header, the header value is used. Otherwise the destination is used.
destination
- the destinationheaders
- the headersreceiptHandler
- the handler invoked when the RECEIPT
frame associated with the un-subscription has been received. The handler receives the sent frame (UNSUBSCRIBE
).
Configures a handler notified when a frame is going to be written on the wire. This handler can be used from logging, debugging. The handler can modify the received frame. If a writing frame handler is set on the StompClient, it will be used by all clients connection, so calling this method is useless, except if you want to use a different handler.
handler
- the handler