Package org.apache.pulsar.broker.service

Class HashRangeExclusiveStickyKeyConsumerSelector

java.lang.Object

org.apache.pulsar.broker.service.HashRangeExclusiveStickyKeyConsumerSelector

All Implemented Interfaces:

StickyKeyConsumerSelector

public class HashRangeExclusiveStickyKeyConsumerSelector
extends Object
implements StickyKeyConsumerSelector

This is a sticky-key consumer selector based user provided range. User is responsible for making sure provided range for all consumers cover the rangeSize else there'll be chance that a key fall in a `whole` that not handled by any consumer.

Field Summary

Fields inherited from interface org.apache.pulsar.broker.service.StickyKeyConsumerSelector

DEFAULT_RANGE_SIZE, STICKY_KEY_HASH_NOT_SET

Constructor Summary

Constructors

Constructor	Description
HashRangeExclusiveStickyKeyConsumerSelector()
HashRangeExclusiveStickyKeyConsumerSelector(int rangeSize)

Method Summary

Modifier and Type	Method	Description
CompletableFuture<Optional<ImpactedConsumersResult>>	addConsumer(Consumer consumer)	Add a new consumer.
ConsumerHashAssignmentsSnapshot	getConsumerHashAssignmentsSnapshot()	Get the current mappings of hash range to consumer.
org.apache.pulsar.client.api.Range	getKeyHashRange()	Get the full range of hash values used by this selector.
Optional<ImpactedConsumersResult>	removeConsumer(Consumer consumer)	Remove the consumer.
Consumer	select(int hash)	Select a consumer by hash.

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.StickyKeyConsumerSelector

getConsumerKeyHashRanges, makeStickyKeyHash, select

Constructor Details

HashRangeExclusiveStickyKeyConsumerSelector

public HashRangeExclusiveStickyKeyConsumerSelector()

HashRangeExclusiveStickyKeyConsumerSelector

public HashRangeExclusiveStickyKeyConsumerSelector(int rangeSize)

Method Details

addConsumer

public CompletableFuture<Optional<ImpactedConsumersResult>> addConsumer(Consumer consumer)

Description copied from interface: StickyKeyConsumerSelector

Add a new consumer.

Specified by:

addConsumer in interface StickyKeyConsumerSelector

Parameters:

consumer - the new consumer to be added

Returns:

a CompletableFuture that completes with the result of impacted consumers. The result contains information about the existing consumers whose hash ranges were affected by the addition of the new consumer.

removeConsumer

public Optional<ImpactedConsumersResult> removeConsumer(Consumer consumer)

Description copied from interface: StickyKeyConsumerSelector

Remove the consumer.

Specified by:

removeConsumer in interface StickyKeyConsumerSelector

Parameters:

consumer - the consumer to be removed

Returns:

the result of impacted consumers. The result contains information about the existing consumers whose hash ranges were affected by the removal of the consumer.

getConsumerHashAssignmentsSnapshot

public ConsumerHashAssignmentsSnapshot getConsumerHashAssignmentsSnapshot()

Description copied from interface: StickyKeyConsumerSelector

Get the current mappings of hash range to consumer.

Specified by:

getConsumerHashAssignmentsSnapshot in interface StickyKeyConsumerSelector

Returns:

a snapshot of the consumer hash assignments

select

public Consumer select(int hash)

Description copied from interface: StickyKeyConsumerSelector

Select a consumer by hash.

Specified by:

select in interface StickyKeyConsumerSelector

Parameters:

hash - the hash corresponding to the sticky key

Returns:

the selected consumer

getKeyHashRange

public org.apache.pulsar.client.api.Range getKeyHashRange()

Description copied from interface: StickyKeyConsumerSelector

Get the full range of hash values used by this selector. The upper bound is exclusive.

Specified by:

getKeyHashRange in interface StickyKeyConsumerSelector

Returns:

the full range of hash values