org.apache.pulsar.broker.service.persistent

Class PersistentDispatcherMultipleConsumers

java.lang.Object

org.apache.pulsar.broker.service.AbstractBaseDispatcher

org.apache.pulsar.broker.service.AbstractDispatcherMultipleConsumers

org.apache.pulsar.broker.service.persistent.PersistentDispatcherMultipleConsumers

All Implemented Interfaces:

AsyncCallbacks.ReadEntriesCallback, Dispatcher

Direct Known Subclasses:

PersistentStickyKeyDispatcherMultipleConsumers

public class PersistentDispatcherMultipleConsumers
extends AbstractDispatcherMultipleConsumers
implements Dispatcher, AsyncCallbacks.ReadEntriesCallback

Field Summary

Fields

Modifier and Type	Field and Description
protected ManagedCursor	cursor
protected Optional<DispatchRateLimiter>	dispatchRateLimiter
protected com.google.common.collect.Range<PositionImpl>	lastIndividualDeletedRangeFromCursorRecovery
protected String	name
protected RedeliveryTracker	redeliveryTracker
protected ServiceConfiguration	serviceConfig
protected PersistentTopic	topic
protected static AtomicIntegerFieldUpdater<PersistentDispatcherMultipleConsumers>	TOTAL_AVAILABLE_PERMITS_UPDATER
protected int	totalAvailablePermits

Fields inherited from class org.apache.pulsar.broker.service.AbstractDispatcherMultipleConsumers

consumerList, consumerSet, currentConsumerRoundRobinIndex, FALSE, IS_CLOSED_UPDATER, TRUE

Fields inherited from class org.apache.pulsar.broker.service.AbstractBaseDispatcher

NONE_KEY, subscription

Constructor Summary

Constructors

Constructor and Description
PersistentDispatcherMultipleConsumers(PersistentTopic topic, ManagedCursor cursor, Subscription subscription)

Method Summary

Modifier and Type	Method and Description
void	addConsumer(Consumer consumer)
void	addMessageToReplay(long ledgerId, long entryId)
void	addUnAckedMessages(int numberOfMessages)
protected Set<? extends Position>	asyncReplayEntries(Set<? extends Position> positions)
protected Set<? extends Position>	asyncReplayEntriesInOrder(Set<? extends Position> positions)
void	blockDispatcherOnUnackedMsgs()
boolean	canUnsubscribe(Consumer consumer)
void	clearDelayedMessages()
CompletableFuture<Void>	close() mark dispatcher closed to stop new incoming requests and disconnect all consumers
void	consumerFlow(Consumer consumer, int additionalNumberOfMessages) Indicates that this consumer is now ready to receive more messages
void	cursorIsReset()
CompletableFuture<Void>	disconnectActiveConsumers(boolean isResetCursor) Disconnect active consumers
CompletableFuture<Void>	disconnectAllConsumers(boolean isResetCursor) disconnect all consumers
CopyOnWriteArrayList<Consumer>	getConsumers()
protected Set<PositionImpl>	getMessagesToReplayNow(int maxMessagesToRead)
String	getName()
long	getNumberOfDelayedMessages()
Optional<DispatchRateLimiter>	getRateLimiter()
RedeliveryTracker	getRedeliveryTracker()
PersistentTopic	getTopic()
int	getTotalUnackedMessages()
org.apache.pulsar.common.api.proto.PulsarApi.CommandSubscribe.SubType	getType()
void	initializeDispatchRateLimiterIfNeeded(Optional<org.apache.pulsar.common.policies.data.Policies> policies)
protected boolean	isAtleastOneConsumerAvailable() returns true only if AbstractDispatcherMultipleConsumers.consumerList has atleast one unblocked consumer and have available permits
boolean	isBlockedDispatcherOnUnackedMsgs()
boolean	isConsumerAvailable(Consumer consumer)
boolean	isConsumerConnected()
void	readEntriesComplete(List<Entry> entries, Object ctx)
void	readEntriesFailed(ManagedLedgerException exception, Object ctx)
void	readMoreEntries()
void	redeliverUnacknowledgedMessages(Consumer consumer)
void	redeliverUnacknowledgedMessages(Consumer consumer, List<PositionImpl> positions)
void	removeConsumer(Consumer consumer)
void	reset() mark dispatcher open to serve new incoming requests
void	resetCloseFuture()
protected void	sendMessagesToConsumers(org.apache.pulsar.broker.service.persistent.PersistentDispatcherMultipleConsumers.ReadType readType, List<Entry> entries)
boolean	trackDelayedDelivery(long ledgerId, long entryId, org.apache.pulsar.common.api.proto.PulsarApi.MessageMetadata msgMetadata) Check with dispatcher if the message should be added to the delayed delivery tracker.
void	unBlockDispatcherOnUnackedMsgs()
void	updateRateLimiter(org.apache.pulsar.common.policies.data.DispatchRate dispatchRate)

Methods inherited from class org.apache.pulsar.broker.service.AbstractDispatcherMultipleConsumers

getNextConsumer, getRandomConsumer, isClosed

Methods inherited from class org.apache.pulsar.broker.service.AbstractBaseDispatcher

filterEntriesForConsumer, peekStickyKey

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.pulsar.broker.service.Dispatcher

disconnectAllConsumers, isClosed, markDeletePositionMoveForward

Field Detail

topic

protected final PersistentTopic topic

cursor

protected final ManagedCursor cursor

lastIndividualDeletedRangeFromCursorRecovery

protected volatile com.google.common.collect.Range<PositionImpl> lastIndividualDeletedRangeFromCursorRecovery

redeliveryTracker

protected final RedeliveryTracker redeliveryTracker

name

protected final String name

TOTAL_AVAILABLE_PERMITS_UPDATER

protected static final AtomicIntegerFieldUpdater<PersistentDispatcherMultipleConsumers> TOTAL_AVAILABLE_PERMITS_UPDATER

totalAvailablePermits

protected volatile int totalAvailablePermits

serviceConfig

protected final ServiceConfiguration serviceConfig

dispatchRateLimiter

protected Optional<DispatchRateLimiter> dispatchRateLimiter

Constructor Detail

PersistentDispatcherMultipleConsumers

public PersistentDispatcherMultipleConsumers(PersistentTopic topic,
                                             ManagedCursor cursor,
                                             Subscription subscription)

Method Detail

addConsumer

public void addConsumer(Consumer consumer)
                 throws BrokerServiceException

Specified by:

addConsumer in interface Dispatcher

Throws:

BrokerServiceException

removeConsumer

public void removeConsumer(Consumer consumer)
                    throws BrokerServiceException

Specified by:

removeConsumer in interface Dispatcher

Throws:

BrokerServiceException

consumerFlow

public void consumerFlow(Consumer consumer,
                         int additionalNumberOfMessages)

Description copied from interface: Dispatcher

Indicates that this consumer is now ready to receive more messages

Specified by:

consumerFlow in interface Dispatcher

readMoreEntries

public void readMoreEntries()

asyncReplayEntries

protected Set<? extends Position> asyncReplayEntries(Set<? extends Position> positions)

asyncReplayEntriesInOrder

protected Set<? extends Position> asyncReplayEntriesInOrder(Set<? extends Position> positions)

isConsumerConnected

public boolean isConsumerConnected()

Specified by:

isConsumerConnected in interface Dispatcher

Overrides:

isConsumerConnected in class AbstractDispatcherMultipleConsumers

getConsumers

public CopyOnWriteArrayList<Consumer> getConsumers()

Specified by:

getConsumers in interface Dispatcher

Overrides:

getConsumers in class AbstractDispatcherMultipleConsumers

canUnsubscribe

public boolean canUnsubscribe(Consumer consumer)

Specified by:

canUnsubscribe in interface Dispatcher

Overrides:

canUnsubscribe in class AbstractDispatcherMultipleConsumers

close

public CompletableFuture<Void> close()

Description copied from interface: Dispatcher

mark dispatcher closed to stop new incoming requests and disconnect all consumers

Specified by:

close in interface Dispatcher

Returns:

disconnectAllConsumers

public CompletableFuture<Void> disconnectAllConsumers(boolean isResetCursor)

Description copied from interface: Dispatcher

disconnect all consumers

Specified by:

disconnectAllConsumers in interface Dispatcher

Returns:

disconnectActiveConsumers

public CompletableFuture<Void> disconnectActiveConsumers(boolean isResetCursor)

Description copied from interface: Dispatcher

Disconnect active consumers

Specified by:

disconnectActiveConsumers in interface Dispatcher

resetCloseFuture

public void resetCloseFuture()

Specified by:

resetCloseFuture in interface Dispatcher

Overrides:

resetCloseFuture in class AbstractBaseDispatcher

reset

public void reset()

Description copied from interface: Dispatcher

mark dispatcher open to serve new incoming requests

Specified by:

reset in interface Dispatcher

getType

public org.apache.pulsar.common.api.proto.PulsarApi.CommandSubscribe.SubType getType()

Specified by:

getType in interface Dispatcher

Overrides:

getType in class AbstractDispatcherMultipleConsumers

readEntriesComplete

public void readEntriesComplete(List<Entry> entries,
                                Object ctx)

Specified by:

readEntriesComplete in interface AsyncCallbacks.ReadEntriesCallback

sendMessagesToConsumers

protected void sendMessagesToConsumers(org.apache.pulsar.broker.service.persistent.PersistentDispatcherMultipleConsumers.ReadType readType,
                                       List<Entry> entries)

readEntriesFailed

public void readEntriesFailed(ManagedLedgerException exception,
                              Object ctx)

Specified by:

readEntriesFailed in interface AsyncCallbacks.ReadEntriesCallback

isAtleastOneConsumerAvailable

protected boolean isAtleastOneConsumerAvailable()

returns true only if AbstractDispatcherMultipleConsumers.consumerList has atleast one unblocked consumer and have available permits

Returns:

isConsumerAvailable

public boolean isConsumerAvailable(Consumer consumer)

Specified by:

isConsumerAvailable in class AbstractDispatcherMultipleConsumers

redeliverUnacknowledgedMessages

public void redeliverUnacknowledgedMessages(Consumer consumer)

Specified by:

redeliverUnacknowledgedMessages in interface Dispatcher

redeliverUnacknowledgedMessages

public void redeliverUnacknowledgedMessages(Consumer consumer,
                                            List<PositionImpl> positions)

Specified by:

redeliverUnacknowledgedMessages in interface Dispatcher

addUnAckedMessages

public void addUnAckedMessages(int numberOfMessages)

Specified by:

addUnAckedMessages in interface Dispatcher

isBlockedDispatcherOnUnackedMsgs

public boolean isBlockedDispatcherOnUnackedMsgs()

blockDispatcherOnUnackedMsgs

public void blockDispatcherOnUnackedMsgs()

unBlockDispatcherOnUnackedMsgs

public void unBlockDispatcherOnUnackedMsgs()

getTotalUnackedMessages

public int getTotalUnackedMessages()

getName

public String getName()

getRedeliveryTracker

public RedeliveryTracker getRedeliveryTracker()

Specified by:

getRedeliveryTracker in interface Dispatcher

getRateLimiter

public Optional<DispatchRateLimiter> getRateLimiter()

Specified by:

getRateLimiter in interface Dispatcher

updateRateLimiter

public void updateRateLimiter(org.apache.pulsar.common.policies.data.DispatchRate dispatchRate)

Specified by:

updateRateLimiter in interface Dispatcher

initializeDispatchRateLimiterIfNeeded

public void initializeDispatchRateLimiterIfNeeded(Optional<org.apache.pulsar.common.policies.data.Policies> policies)

Specified by:

initializeDispatchRateLimiterIfNeeded in interface Dispatcher

trackDelayedDelivery

public boolean trackDelayedDelivery(long ledgerId,
                                    long entryId,
                                    org.apache.pulsar.common.api.proto.PulsarApi.MessageMetadata msgMetadata)

Description copied from interface: Dispatcher

Check with dispatcher if the message should be added to the delayed delivery tracker. Return true if the message should be delayed and ignored at this point.

Specified by:

trackDelayedDelivery in interface Dispatcher

getMessagesToReplayNow

protected Set<PositionImpl> getMessagesToReplayNow(int maxMessagesToRead)

getNumberOfDelayedMessages

public long getNumberOfDelayedMessages()

Specified by:

getNumberOfDelayedMessages in interface Dispatcher

clearDelayedMessages

public void clearDelayedMessages()

Specified by:

clearDelayedMessages in interface Dispatcher

cursorIsReset

public void cursorIsReset()

Specified by:

cursorIsReset in interface Dispatcher

addMessageToReplay

public void addMessageToReplay(long ledgerId,
                               long entryId)

Overrides:

addMessageToReplay in class AbstractBaseDispatcher

getTopic

public PersistentTopic getTopic()