public interface MessageConsumer<T> extends ReadStream<Message<T>>
EventBus address that can
be read from.
The EventBus.consumer(String) or EventBus.localConsumer(String)
creates a new consumer, the returned consumer is not yet registered against the event bus. Registration
is effective after the handler(io.vertx.core.Handler) method is invoked.
The consumer is unregistered from the event bus using the unregister() method or by calling the
handler(io.vertx.core.Handler) with a null value..
| Modifier and Type | Method and Description |
|---|---|
String |
address() |
ReadStream<T> |
bodyStream() |
void |
completionHandler(Handler<AsyncResult<Void>> completionHandler)
Optional method which can be called to indicate when the registration has been propagated across the cluster.
|
MessageConsumer<T> |
endHandler(Handler<Void> endHandler)
Set an end handler.
|
MessageConsumer<T> |
exceptionHandler(Handler<Throwable> handler)
Set an exception handler on the read stream.
|
MessageConsumer<T> |
fetch(long amount)
Fetch the specified
amount of elements. |
int |
getMaxBufferedMessages() |
MessageConsumer<T> |
handler(Handler<Message<T>> handler)
Set a data handler.
|
boolean |
isRegistered() |
MessageConsumer<T> |
pause()
Pause the
ReadStream, it sets the buffer in fetch mode and clears the actual demand. |
MessageConsumer<T> |
resume()
Resume reading, and sets the buffer in
flowing mode. |
MessageConsumer<T> |
setMaxBufferedMessages(int maxBufferedMessages)
Set the number of messages this registration will buffer when this stream is paused.
|
Future<Void> |
unregister()
Unregisters the handler which created this registration
|
void |
unregister(Handler<AsyncResult<Void>> completionHandler)
Unregisters the handler which created this registration
|
pipe, pipeTo, pipeToMessageConsumer<T> exceptionHandler(Handler<Throwable> handler)
ReadStreamexceptionHandler in interface ReadStream<Message<T>>exceptionHandler in interface StreamBasehandler - the exception handlerMessageConsumer<T> handler(Handler<Message<T>> handler)
ReadStreamhandler in interface ReadStream<Message<T>>MessageConsumer<T> pause()
ReadStreamReadStream, it sets the buffer in fetch mode and clears the actual demand.
While it's paused, no data will be sent to the data handler.
pause in interface ReadStream<Message<T>>MessageConsumer<T> resume()
ReadStreamflowing mode.
If the ReadStream has been paused, reading will recommence on it.resume in interface ReadStream<Message<T>>MessageConsumer<T> fetch(long amount)
ReadStreamamount of elements. If the ReadStream has been paused, reading will
recommence with the specified amount of items, otherwise the specified amount will
be added to the current stream demand.fetch in interface ReadStream<Message<T>>MessageConsumer<T> endHandler(Handler<Void> endHandler)
ReadStreamendHandler in interface ReadStream<Message<T>>ReadStream<T> bodyStream()
boolean isRegistered()
String address()
MessageConsumer<T> setMaxBufferedMessages(int maxBufferedMessages)
1000.
When a new value is set, buffered messages may be discarded to reach the new value. The most recent messages will be kept.
maxBufferedMessages - the maximum number of messages that can be bufferedint getMaxBufferedMessages()
void completionHandler(Handler<AsyncResult<Void>> completionHandler)
completionHandler - the completion handlervoid unregister(Handler<AsyncResult<Void>> completionHandler)
completionHandler - the handler called when the unregister is done. For example in a cluster when all nodes of the
event bus have been unregistered.Copyright © 2021 Eclipse. All rights reserved.