io.nats.client

Interface AsyncSubscription

All Superinterfaces:

AutoCloseable, Subscription

public interface AsyncSubscription
extends Subscription

A client uses an AsyncSubscription object to receive messages from a subject. It runs asynchronously (on an Executor), receives one Message at a time, and invokes a user-defined callback method to process each Message.

Method Summary

Modifier and Type	Method and Description
void	setMessageHandler(MessageHandler cb)
void	start() Starts asynchronous message delivery to this subscription

Methods inherited from interface io.nats.client.Subscription

autoUnsubscribe, close, getDropped, getMaxPendingBytes, getMaxPendingMsgs, getQueue, getQueuedMessageCount, getSubject, isValid, setMaxPendingBytes, setMaxPendingMsgs, setPendingLimits, unsubscribe

Method Detail

start

void start()

Starts asynchronous message delivery to this subscription

Throws:

IllegalStateException - if the subscription is invalid/closed. Reasons for this could include reaching the subscription's autoUnsubscribe limit, calling Subscription.unsubscribe(), or closing the Connection.

setMessageHandler

void setMessageHandler(MessageHandler cb)

Parameters:

cb - the message handler to set for this subscription. When new messages arrive for this subscription, the MessageHandler.onMessage(Message) method will be invoked.

See Also:

MessageHandler.onMessage(Message)