public interface StompClientConnection
StompClientConnection
, that let
send and receive STOMP frames.Modifier and Type | Method and Description |
---|---|
StompClientConnection |
abort(String id)
Aborts a transaction.
|
StompClientConnection |
abort(String id,
Handler<Frame> receiptHandler)
Aborts a transaction.
|
StompClientConnection |
abort(String id,
Map<String,String> headers)
Aborts a transaction.
|
StompClientConnection |
abort(String id,
Map<String,String> headers,
Handler<Frame> receiptHandler)
Aborts a transaction.
|
StompClientConnection |
ack(String id)
Sends an acknowledgement for a specific message.
|
StompClientConnection |
ack(String id,
Handler<Frame> receiptHandler)
Sends an acknowledgement for a specific message.
|
StompClientConnection |
ack(String id,
String txId)
Sends an acknowledgement for the given frame.
|
StompClientConnection |
ack(String id,
String txId,
Handler<Frame> receiptHandler)
Sends an acknowledgement for the given frame.
|
StompClientConnection |
beginTX(String id)
Begins a transaction.
|
StompClientConnection |
beginTX(String id,
Handler<Frame> receiptHandler)
Begins a transaction.
|
StompClientConnection |
beginTX(String id,
Map<String,String> headers)
Begins a transaction.
|
StompClientConnection |
beginTX(String id,
Map<String,String> headers,
Handler<Frame> receiptHandler)
Begins a transaction.
|
void |
close()
Closes the connection without sending the
DISCONNECT frame. |
StompClientConnection |
closeHandler(Handler<StompClientConnection> handler)
Sets a handler notified when the STOMP connection is closed.
|
StompClientConnection |
commit(String id)
Commits a transaction.
|
StompClientConnection |
commit(String id,
Handler<Frame> receiptHandler)
Commits a transaction.
|
StompClientConnection |
commit(String id,
Map<String,String> headers)
Commits a transaction.
|
StompClientConnection |
commit(String id,
Map<String,String> headers,
Handler<Frame> receiptHandler)
Commits a transaction.
|
StompClientConnection |
connectionDroppedHandler(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(Frame frame)
Disconnects the client.
|
StompClientConnection |
disconnect(Frame frame,
Handler<Frame> receiptHandler)
Disconnects the client.
|
StompClientConnection |
disconnect(Handler<Frame> receiptHandler)
Disconnects the client.
|
StompClientConnection |
errorHandler(Handler<Frame> handler)
Sets a handler notified when an
ERROR frame is received by the client. |
StompClientConnection |
exceptionHandler(Handler<Throwable> exceptionHandler)
Configures the exception handler notified upon TCP-level errors.
|
boolean |
isConnected()
Returns whether or not the `CONNECTED` frame has been receive meaning that the Stomp connection is established.
|
StompClientConnection |
nack(String id)
Sends a non-acknowledgement for the given message.
|
StompClientConnection |
nack(String id,
Handler<Frame> receiptHandler)
Sends a non-acknowledgement for the given message.
|
StompClientConnection |
nack(String id,
String txId)
Sends a non-acknowledgement for the given frame.
|
StompClientConnection |
nack(String id,
String txId,
Handler<Frame> receiptHandler)
Sends a non-acknowledgement for the given frame.
|
StompClientConnection |
pingHandler(Handler<StompClientConnection> handler)
Sets a handler that let customize the behavior when a ping needs to be sent to the server.
|
StompClientConnection |
receivedFrameHandler(Handler<Frame> handler)
Configures a received handler that get notified when a STOMP frame is received by the client.
|
StompClientConnection |
send(Frame frame)
Sends the given frame to the server.
|
StompClientConnection |
send(Frame frame,
Handler<Frame> receiptHandler)
Sends the given frame to the server.
|
StompClientConnection |
send(Map<String,String> headers,
Buffer body)
Sends a
SEND frame to the server. |
StompClientConnection |
send(Map<String,String> headers,
Buffer body,
Handler<Frame> receiptHandler)
Sends a
SEND frame to the server. |
StompClientConnection |
send(String destination,
Buffer body)
Sends a
SEND frame to the server to the given destination. |
StompClientConnection |
send(String destination,
Buffer body,
Handler<Frame> receiptHandler)
Sends a
SEND frame to the server to the given destination. |
StompClientConnection |
send(String destination,
Map<String,String> headers,
Buffer body)
Sends a
SEND frame to the server to the given destination. |
StompClientConnection |
send(String destination,
Map<String,String> headers,
Buffer body,
Handler<Frame> receiptHandler)
Sends a
SEND frame to the server to the given destination. |
String |
server() |
String |
session() |
String |
subscribe(String destination,
Handler<Frame> handler)
Subscribes to the given destination.
|
String |
subscribe(String destination,
Handler<Frame> handler,
Handler<Frame> receiptHandler)
Subscribes to the given destination.
|
String |
subscribe(String destination,
Map<String,String> headers,
Handler<Frame> handler)
Subscribes to the given destination.
|
String |
subscribe(String destination,
Map<String,String> headers,
Handler<Frame> handler,
Handler<Frame> receiptHandler)
Subscribes to the given destination.
|
StompClientConnection |
unsubscribe(String destination)
Un-subscribes from the given destination.
|
StompClientConnection |
unsubscribe(String destination,
Handler<Frame> receiptHandler)
Un-subscribes from the given destination.
|
StompClientConnection |
unsubscribe(String destination,
Map<String,String> headers)
Un-subscribes from the given destination.
|
StompClientConnection |
unsubscribe(String destination,
Map<String,String> headers,
Handler<Frame> receiptHandler)
Un-subscribes from the given destination.
|
String |
version() |
StompClientConnection |
writingFrameHandler(Handler<Frame> handler)
Configures a handler notified when a frame is going to be written on the wire.
|
String session()
String version()
void close()
DISCONNECT
frame.disconnect()
,
disconnect(Handler)
String server()
StompClientConnection send(Map<String,String> headers, Buffer body)
SEND
frame to the server.headers
- the headers, must not be null
body
- the body, may be null
StompClientConnection
StompClientConnection send(Map<String,String> headers, Buffer body, Handler<Frame> receiptHandler)
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.StompClientConnection
StompClientConnection send(String destination, Buffer body)
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
StompClientConnection
StompClientConnection send(String destination, Buffer body, Handler<Frame> receiptHandler)
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.StompClientConnection
StompClientConnection send(Frame frame)
frame
- the frameStompClientConnection
StompClientConnection send(Frame frame, Handler<Frame> receiptHandler)
frame
- the framereceiptHandler
- the handler invoked when the RECEIPT
frame associated with the
sent frame has been received. The handler receives the sent frame.StompClientConnection
StompClientConnection send(String destination, Map<String,String> headers, Buffer body)
SEND
frame to the server to the given destination.destination
- the destination, must not be null
body
- the body, may be null
headers
- the header. The destination
header is replaced by the value given to the destination
parameterStompClientConnection
StompClientConnection send(String destination, Map<String,String> headers, Buffer body, Handler<Frame> receiptHandler)
SEND
frame to the server to the given destination.destination
- the destination, must not be null
body
- the body, may be null
headers
- the header. The destination
header is replaced by the value given to the destination
parameterreceiptHandler
- the handler invoked when the RECEIPT
frame associated with the
sent frame has been received. The handler receives the sent frame.StompClientConnection
String subscribe(String destination, Handler<Frame> handler)
destination
- the destination, must not be null
handler
- the handler invoked when a message is received on the given destination. Must not be null
.String subscribe(String destination, Handler<Frame> handler, Handler<Frame> receiptHandler)
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
).String subscribe(String destination, Map<String,String> headers, Handler<Frame> handler)
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
.String subscribe(String destination, Map<String,String> headers, Handler<Frame> handler, Handler<Frame> receiptHandler)
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
).StompClientConnection unsubscribe(String destination)
id
header).destination
- the destinationStompClientConnection
StompClientConnection unsubscribe(String destination, Handler<Frame> receiptHandler)
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
).StompClientConnection
StompClientConnection unsubscribe(String destination, Map<String,String> headers)
id
header, the header value is used. Otherwise the destination is used.destination
- the destinationheaders
- the headersStompClientConnection
StompClientConnection unsubscribe(String destination, Map<String,String> headers, Handler<Frame> receiptHandler)
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
).StompClientConnection
StompClientConnection errorHandler(Handler<Frame> handler)
ERROR
frame is received by the client. The handler receives the ERROR
frame and a reference on the StompClientConnection
.handler
- the handlerStompClientConnection
StompClientConnection closeHandler(Handler<StompClientConnection> handler)
handler
- the handlerStompClientConnection
StompClientConnection connectionDroppedHandler(Handler<StompClientConnection> handler)
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 handlerStompClientConnection
receiving the dropped connection.StompClientConnection pingHandler(Handler<StompClientConnection> handler)
handler
- the handlerStompClientConnection
StompClientConnection beginTX(String id, Handler<Frame> receiptHandler)
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
).StompClientConnection
StompClientConnection beginTX(String id)
id
- the transaction id, must not be null
StompClientConnection
StompClientConnection beginTX(String id, Map<String,String> headers)
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 the @{code id} parameterStompClientConnection
StompClientConnection beginTX(String id, Map<String,String> headers, Handler<Frame> receiptHandler)
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 the @{code id} parameterreceiptHandler
- 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
).StompClientConnection
StompClientConnection commit(String id)
id
- the transaction id, must not be null
StompClientConnection
StompClientConnection commit(String id, Handler<Frame> receiptHandler)
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
).StompClientConnection
StompClientConnection commit(String id, Map<String,String> headers)
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 the @{code id} parameterStompClientConnection
StompClientConnection commit(String id, Map<String,String> headers, Handler<Frame> receiptHandler)
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 the @{code id} parameterreceiptHandler
- 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
).StompClientConnection
StompClientConnection abort(String id)
id
- the transaction id, must not be null
StompClientConnection
StompClientConnection abort(String id, Handler<Frame> receiptHandler)
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
).StompClientConnection
StompClientConnection abort(String id, Map<String,String> headers)
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 the @{code id} parameterStompClientConnection
StompClientConnection abort(String id, Map<String,String> headers, Handler<Frame> receiptHandler)
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 the @{code id} parameterreceiptHandler
- 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
).StompClientConnection
StompClientConnection disconnect()
close()
method, this method send the DISCONNECT
frame to the
server.StompClientConnection
StompClientConnection disconnect(Handler<Frame> receiptHandler)
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
).StompClientConnection
StompClientConnection disconnect(Frame frame)
close()
method, this method send the DISCONNECT
frame to the
server. This method lets you customize the DISCONNECT
frame.frame
- the DISCONNECT
frame.StompClientConnection
StompClientConnection disconnect(Frame frame, Handler<Frame> receiptHandler)
close()
method, this method send the DISCONNECT
frame to the
server. This method lets you customize the DISCONNECT
frame.frame
- the DISCONNECT
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
).StompClientConnection
StompClientConnection ack(String id)
id
parameter is the message id received in the frame.id
- the message id of the message to acknowledgeStompClientConnection
StompClientConnection ack(String id, Handler<Frame> receiptHandler)
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
).StompClientConnection
StompClientConnection nack(String id)
id
parameter is the message id received in the frame.id
- the message id of the message to acknowledgeStompClientConnection
StompClientConnection nack(String id, Handler<Frame> receiptHandler)
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
).StompClientConnection
StompClientConnection ack(String id, String txId)
id
- the message id of the message to acknowledgetxId
- the transaction idStompClientConnection
StompClientConnection ack(String id, String txId, Handler<Frame> receiptHandler)
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
).StompClientConnection
StompClientConnection nack(String id, String txId)
id
- the message id of the message to acknowledgetxId
- the transaction idStompClientConnection
StompClientConnection nack(String id, String txId, Handler<Frame> receiptHandler)
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
).StompClientConnection
StompClientConnection receivedFrameHandler(Handler<Frame> handler)
Unlike StompClient.receivedFrameHandler(Handler)
, 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 handlerStompClientConnection
StompClientConnection writingFrameHandler(Handler<Frame> handler)
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 handlerStompClientConnection
StompClientConnection exceptionHandler(Handler<Throwable> exceptionHandler)
exceptionHandler
- the handlerStompClientConnection
boolean isConnected()
true
if the connection is established, false
otherwiseCopyright © 2023 Eclipse. All rights reserved.