org.apache.pulsar.client.impl

Class ConsumerBase<T>

java.lang.Object

org.apache.pulsar.client.impl.ConsumerBase<T>

All Implemented Interfaces:

Closeable, AutoCloseable, Consumer<T>

Direct Known Subclasses:

ConsumerImpl, MultiTopicsConsumerImpl

public abstract class ConsumerBase<T>
extends Object
implements Consumer<T>

Field Summary

Fields

Modifier and Type	Field and Description
protected PulsarClientImpl	client
protected ConsumerConfigurationData<T>	conf
protected ConsumerEventListener	consumerEventListener
protected String	consumerName
protected ConsumerInterceptors<T>	interceptors
protected MessageListener<T>	listener
protected ExecutorService	listenerExecutor
protected int	maxReceiverQueueSize
protected ConcurrentLinkedQueue<CompletableFuture<Message<T>>>	pendingReceives
protected Schema<T>	schema
protected CompletableFuture<Consumer<T>>	subscribeFuture
protected String	subscription
protected String	topic

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ConsumerBase(PulsarClientImpl client, String topic, ConsumerConfigurationData<T> conf, int receiverQueueSize, ExecutorService listenerExecutor, CompletableFuture<Consumer<T>> subscribeFuture, Schema<T> schema, ConsumerInterceptors interceptors)

Method Summary

Modifier and Type	Method and Description
void	acknowledge(Message<?> message)
void	acknowledge(MessageId messageId)
CompletableFuture<Void>	acknowledgeAsync(Message<?> message)
CompletableFuture<Void>	acknowledgeAsync(MessageId messageId)
void	acknowledgeCumulative(Message<?> message)
void	acknowledgeCumulative(MessageId messageId)
CompletableFuture<Void>	acknowledgeCumulativeAsync(Message<?> message)
CompletableFuture<Void>	acknowledgeCumulativeAsync(MessageId messageId)
protected Message<T>	beforeConsume(Message<T> message)
protected boolean	changeToReadyState()
void	close()
abstract CompletableFuture<Void>	closeAsync()
protected abstract CompletableFuture<Void>	doAcknowledge(MessageId messageId, PulsarApi.CommandAck.AckType ackType, Map<String,Long> properties)
protected org.apache.pulsar.client.impl.HandlerState.State	getAndUpdateState(UnaryOperator<org.apache.pulsar.client.impl.HandlerState.State> updater)
abstract int	getAvailablePermits()
PulsarClientImpl	getClient()
String	getConsumerName()
protected org.apache.pulsar.client.impl.HandlerState.State	getState()
String	getSubscription()
protected PulsarApi.CommandSubscribe.SubType	getSubType()
String	getTopic()
protected abstract Message<T>	internalReceive()
protected abstract Message<T>	internalReceive(int timeout, TimeUnit unit)
protected abstract CompletableFuture<Message<T>>	internalReceiveAsync()
abstract int	numMessagesInQueue()
protected void	onAcknowledge(MessageId messageId, Throwable exception)
protected void	onAcknowledgeCumulative(MessageId messageId, Throwable exception)
Message<T>	receive()
Message<T>	receive(int timeout, TimeUnit unit)
CompletableFuture<Message<T>>	receiveAsync()
protected abstract void	redeliverUnacknowledgedMessages(Set<MessageId> messageIds) Redelivers the given unacknowledged messages.
protected void	setMaxReceiverQueueSize(int newSize)
protected void	setState(org.apache.pulsar.client.impl.HandlerState.State s)
CompletableFuture<Consumer<T>>	subscribeFuture()
String	toString()
void	unsubscribe()
abstract CompletableFuture<Void>	unsubscribeAsync()

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.pulsar.client.api.Consumer

getStats, hasReachedEndOfTopic, isConnected, pause, redeliverUnacknowledgedMessages, resume, seek, seekAsync

Field Detail

subscription

protected final String subscription

conf

protected final ConsumerConfigurationData<T> conf

consumerName

protected final String consumerName

subscribeFuture

protected final CompletableFuture<Consumer<T>> subscribeFuture

listener

protected final MessageListener<T> listener

consumerEventListener

protected final ConsumerEventListener consumerEventListener

listenerExecutor

protected final ExecutorService listenerExecutor

pendingReceives

protected final ConcurrentLinkedQueue<CompletableFuture<Message<T>>> pendingReceives

maxReceiverQueueSize

protected int maxReceiverQueueSize

schema

protected Schema<T> schema

interceptors

protected final ConsumerInterceptors<T> interceptors

client

protected final PulsarClientImpl client

topic

protected final String topic

Constructor Detail

ConsumerBase

protected ConsumerBase(PulsarClientImpl client,
                       String topic,
                       ConsumerConfigurationData<T> conf,
                       int receiverQueueSize,
                       ExecutorService listenerExecutor,
                       CompletableFuture<Consumer<T>> subscribeFuture,
                       Schema<T> schema,
                       ConsumerInterceptors interceptors)

Method Detail

receive

public Message<T> receive()
                   throws PulsarClientException

Specified by:

receive in interface Consumer<T>

Throws:

PulsarClientException

receiveAsync

public CompletableFuture<Message<T>> receiveAsync()

Specified by:

receiveAsync in interface Consumer<T>

internalReceive

protected abstract Message<T> internalReceive()
                                       throws PulsarClientException

Throws:

PulsarClientException

internalReceiveAsync

protected abstract CompletableFuture<Message<T>> internalReceiveAsync()

receive

public Message<T> receive(int timeout,
                          TimeUnit unit)
                   throws PulsarClientException

Specified by:

receive in interface Consumer<T>

Throws:

PulsarClientException

internalReceive

protected abstract Message<T> internalReceive(int timeout,
                                              TimeUnit unit)
                                       throws PulsarClientException

Throws:

PulsarClientException

acknowledge

public void acknowledge(Message<?> message)
                 throws PulsarClientException

Specified by:

acknowledge in interface Consumer<T>

Throws:

PulsarClientException

acknowledge

public void acknowledge(MessageId messageId)
                 throws PulsarClientException

Specified by:

acknowledge in interface Consumer<T>

Throws:

PulsarClientException

acknowledgeCumulative

public void acknowledgeCumulative(Message<?> message)
                           throws PulsarClientException

Specified by:

acknowledgeCumulative in interface Consumer<T>

Throws:

PulsarClientException

acknowledgeCumulative

public void acknowledgeCumulative(MessageId messageId)
                           throws PulsarClientException

Specified by:

acknowledgeCumulative in interface Consumer<T>

Throws:

PulsarClientException

acknowledgeAsync

public CompletableFuture<Void> acknowledgeAsync(Message<?> message)

Specified by:

acknowledgeAsync in interface Consumer<T>

acknowledgeCumulativeAsync

public CompletableFuture<Void> acknowledgeCumulativeAsync(Message<?> message)

Specified by:

acknowledgeCumulativeAsync in interface Consumer<T>

acknowledgeAsync

public CompletableFuture<Void> acknowledgeAsync(MessageId messageId)

Specified by:

acknowledgeAsync in interface Consumer<T>

acknowledgeCumulativeAsync

public CompletableFuture<Void> acknowledgeCumulativeAsync(MessageId messageId)

Specified by:

acknowledgeCumulativeAsync in interface Consumer<T>

doAcknowledge

protected abstract CompletableFuture<Void> doAcknowledge(MessageId messageId,
                                                         PulsarApi.CommandAck.AckType ackType,
                                                         Map<String,Long> properties)

unsubscribe

public void unsubscribe()
                 throws PulsarClientException

Specified by:

unsubscribe in interface Consumer<T>

Throws:

PulsarClientException

unsubscribeAsync

public abstract CompletableFuture<Void> unsubscribeAsync()

Specified by:

unsubscribeAsync in interface Consumer<T>

close

public void close()
           throws PulsarClientException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Consumer<T>

Throws:

PulsarClientException

closeAsync

public abstract CompletableFuture<Void> closeAsync()

Specified by:

closeAsync in interface Consumer<T>

getSubType

protected PulsarApi.CommandSubscribe.SubType getSubType()

getAvailablePermits

public abstract int getAvailablePermits()

numMessagesInQueue

public abstract int numMessagesInQueue()

subscribeFuture

public CompletableFuture<Consumer<T>> subscribeFuture()

getTopic

public String getTopic()

Specified by:

getTopic in interface Consumer<T>

getSubscription

public String getSubscription()

Specified by:

getSubscription in interface Consumer<T>

getConsumerName

public String getConsumerName()

Specified by:

getConsumerName in interface Consumer<T>

redeliverUnacknowledgedMessages

protected abstract void redeliverUnacknowledgedMessages(Set<MessageId> messageIds)

Redelivers the given unacknowledged messages. In Failover mode, the request is ignored if the consumer is not active for the given topic. In Shared mode, the consumers messages to be redelivered are distributed across all the connected consumers. This is a non blocking call and doesn't throw an exception. In case the connection breaks, the messages are redelivered after reconnect.

toString

public String toString()

Overrides:

toString in class Object

setMaxReceiverQueueSize

protected void setMaxReceiverQueueSize(int newSize)

beforeConsume

protected Message<T> beforeConsume(Message<T> message)

onAcknowledge

protected void onAcknowledge(MessageId messageId,
                             Throwable exception)

onAcknowledgeCumulative

protected void onAcknowledgeCumulative(MessageId messageId,
                                       Throwable exception)

changeToReadyState

protected boolean changeToReadyState()

getState

protected org.apache.pulsar.client.impl.HandlerState.State getState()

setState

protected void setState(org.apache.pulsar.client.impl.HandlerState.State s)

getAndUpdateState

protected org.apache.pulsar.client.impl.HandlerState.State getAndUpdateState(UnaryOperator<org.apache.pulsar.client.impl.HandlerState.State> updater)

getClient

public PulsarClientImpl getClient()