org.apache.pulsar.broker.service

Class AbstractDispatcherSingleActiveConsumer

java.lang.Object

org.apache.pulsar.broker.service.AbstractBaseDispatcher

org.apache.pulsar.broker.service.AbstractDispatcherSingleActiveConsumer

All Implemented Interfaces:

Dispatcher

Direct Known Subclasses:

NonPersistentDispatcherSingleActiveConsumer, PersistentDispatcherSingleActiveConsumer

public abstract class AbstractDispatcherSingleActiveConsumer
extends AbstractBaseDispatcher

Field Summary

Fields

Modifier and Type	Field and Description
protected static AtomicReferenceFieldUpdater<AbstractDispatcherSingleActiveConsumer,Consumer>	ACTIVE_CONSUMER_UPDATER
protected CompletableFuture<Void>	closeFuture
protected CopyOnWriteArrayList<Consumer>	consumers
protected static int	FALSE
protected static AtomicIntegerFieldUpdater<AbstractDispatcherSingleActiveConsumer>	IS_CLOSED_UPDATER
protected boolean	isKeyHashRangeFiltered
protected int	partitionIndex
protected StickyKeyConsumerSelector	stickyKeyConsumerSelector
protected org.apache.pulsar.common.api.proto.PulsarApi.CommandSubscribe.SubType	subscriptionType
protected String	topicName
protected static int	TRUE

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

NONE_KEY, subscription

Constructor Summary

Constructors

Constructor and Description
AbstractDispatcherSingleActiveConsumer(org.apache.pulsar.common.api.proto.PulsarApi.CommandSubscribe.SubType subscriptionType, int partitionIndex, String topicName, Subscription subscription)

Method Summary

Modifier and Type	Method and Description
void	addConsumer(Consumer consumer)
protected abstract void	cancelPendingRead()
boolean	canUnsubscribe(Consumer consumer) Handle unsubscribe command from the client API For failover subscription, if consumer is connected consumer, we can unsubscribe.
CompletableFuture<Void>	close() mark dispatcher closed to stop new incoming requests and disconnect all consumers
CompletableFuture<Void>	disconnectActiveConsumers(boolean isResetCursor) Disconnect active consumers
CompletableFuture<Void>	disconnectAllConsumers(boolean isResetCursor) Disconnect all consumers on this dispatcher (server side close).
Consumer	getActiveConsumer()
List<Consumer>	getConsumers()
org.apache.pulsar.common.api.proto.PulsarApi.CommandSubscribe.SubType	getType()
boolean	isClosed()
boolean	isConsumerConnected()
protected abstract boolean	isConsumersExceededOnSubscription()
protected void	notifyActiveConsumerChanged(Consumer activeConsumer)
protected boolean	pickAndScheduleActiveConsumer() Pick active consumer for a topic for PulsarApi.CommandSubscribe.SubType.Failover subscription.
protected abstract void	readMoreEntries(Consumer consumer)
void	removeConsumer(Consumer consumer)
void	reset() mark dispatcher open to serve new incoming requests
void	resetCloseFuture()
protected abstract void	scheduleReadOnActiveConsumer()

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

addMessageToReplay, 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

addUnAckedMessages, clearDelayedMessages, consumerFlow, cursorIsReset, disconnectAllConsumers, getNumberOfDelayedMessages, getRateLimiter, getRedeliveryTracker, initializeDispatchRateLimiterIfNeeded, markDeletePositionMoveForward, redeliverUnacknowledgedMessages, redeliverUnacknowledgedMessages, trackDelayedDelivery, updateRateLimiter

Field Detail

topicName

protected final String topicName

ACTIVE_CONSUMER_UPDATER

protected static final AtomicReferenceFieldUpdater<AbstractDispatcherSingleActiveConsumer,Consumer> ACTIVE_CONSUMER_UPDATER

consumers

protected final CopyOnWriteArrayList<Consumer> consumers

stickyKeyConsumerSelector

protected StickyKeyConsumerSelector stickyKeyConsumerSelector

isKeyHashRangeFiltered

protected boolean isKeyHashRangeFiltered

closeFuture

protected CompletableFuture<Void> closeFuture

partitionIndex

protected final int partitionIndex

subscriptionType

protected final org.apache.pulsar.common.api.proto.PulsarApi.CommandSubscribe.SubType subscriptionType

FALSE

protected static final int FALSE

See Also:

Constant Field Values

TRUE

protected static final int TRUE

See Also:

Constant Field Values

IS_CLOSED_UPDATER

protected static final AtomicIntegerFieldUpdater<AbstractDispatcherSingleActiveConsumer> IS_CLOSED_UPDATER

Constructor Detail

AbstractDispatcherSingleActiveConsumer

public AbstractDispatcherSingleActiveConsumer(org.apache.pulsar.common.api.proto.PulsarApi.CommandSubscribe.SubType subscriptionType,
                                              int partitionIndex,
                                              String topicName,
                                              Subscription subscription)

Method Detail

scheduleReadOnActiveConsumer

protected abstract void scheduleReadOnActiveConsumer()

readMoreEntries

protected abstract void readMoreEntries(Consumer consumer)

cancelPendingRead

protected abstract void cancelPendingRead()

isConsumersExceededOnSubscription

protected abstract boolean isConsumersExceededOnSubscription()

notifyActiveConsumerChanged

protected void notifyActiveConsumerChanged(Consumer activeConsumer)

pickAndScheduleActiveConsumer

protected boolean pickAndScheduleActiveConsumer()

Pick active consumer for a topic for PulsarApi.CommandSubscribe.SubType.Failover subscription. If it's a non-partitioned topic then it'll pick consumer based on order they subscribe to the topic. If is's a partitioned topic, first sort consumers based on their priority level and consumer name then distributed partitions evenly across consumers with highest priority level.

Returns:

the true consumer if the consumer is changed, otherwise false.

addConsumer

public void addConsumer(Consumer consumer)
                 throws BrokerServiceException

Throws:

BrokerServiceException

removeConsumer

public void removeConsumer(Consumer consumer)
                    throws BrokerServiceException

Throws:

BrokerServiceException

canUnsubscribe

public boolean canUnsubscribe(Consumer consumer)

Handle unsubscribe command from the client API For failover subscription, if consumer is connected consumer, we can unsubscribe.

Parameters:

consumer - Calling consumer object

close

public CompletableFuture<Void> close()

Description copied from interface: Dispatcher

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

Returns:

isClosed

public boolean isClosed()

disconnectAllConsumers

public CompletableFuture<Void> disconnectAllConsumers(boolean isResetCursor)

Disconnect all consumers on this dispatcher (server side close). This triggers channelInactive on the inbound handler which calls dispatcher.removeConsumer(), where the closeFuture is completed

Returns:

disconnectActiveConsumers

public CompletableFuture<Void> disconnectActiveConsumers(boolean isResetCursor)

Description copied from interface: Dispatcher

Disconnect active consumers

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

getType

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

getActiveConsumer

public Consumer getActiveConsumer()

getConsumers

public List<Consumer> getConsumers()

isConsumerConnected

public boolean isConsumerConnected()