org.tools4j.nobark.queue

Class ConflationQueueBuilderImpl<K,V>

java.lang.Object

org.tools4j.nobark.queue.ConflationQueueBuilderImpl<K,V>

Type Parameters:

K - the conflation key type

V - the value type

All Implemented Interfaces:

ConflationQueueBuilder<K,V>

Direct Known Subclasses:

ConflationQueueBuilderImpl.DeclaredKeysBuilder, ConflationQueueBuilderImpl.DefaultBuilder, ConflationQueueBuilderImpl.EnumKeyBuilder

class ConflationQueueBuilderImpl<K,V>
extends java.lang.Object
implements ConflationQueueBuilder<K,V>

Package local builder implementation as returned by the static methods of ConflationQueueBuilder.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static interface	ConflationQueueBuilderImpl.CqFactory<K,V> Builder-internal factory for different types of conflation queues.
(package private) static class	ConflationQueueBuilderImpl.DeclaredKeysBuilder<K,V> Builder for the case that conflation keys are declared.
(package private) static class	ConflationQueueBuilderImpl.DefaultBuilder<K,V> Default builder for the case that no conflation keys are declared.
(package private) static class	ConflationQueueBuilderImpl.EnumKeyBuilder<K extends java.lang.Enum<K>,V> Builder for enum conflation key types.
(package private) class	ConflationQueueBuilderImpl.EvictConflationQueueBuilder Builder for EvictConflationQueue.
(package private) class	ConflationQueueBuilderImpl.MergeConflationQueueBuilder Builder for MergeConflationQueue.

Nested classes/interfaces inherited from interface org.tools4j.nobark.queue.ConflationQueueBuilder

ConflationQueueBuilder.ExchangeConflationQueueBuilder<K,V>

Method Summary

Modifier and Type	Method and Description
ConflationQueue<K,V>	build(java.util.function.Supplier<? extends java.util.Queue<java.lang.Object>> queueFactory) Builds and returns a new conflation queue instance using the given queue factory for the backing queue.
ConflationQueueBuilder<K,V>	withAppenderListener(java.util.function.Supplier<? extends AppenderListener<? super K,? super V>> listenerSupplier) Register a listener as created by the specified supplier when creating queue appenders.
ConflationQueueBuilder.ExchangeConflationQueueBuilder<K,V>	withExchangeValueSupport() Switch builder mode to create a conflation queue that allows exchanging of elements between the consumer and the producer, that is, the builder will now create a ExchangeConflationQueue.
ConflationQueueBuilder.ExchangeConflationQueueBuilder<K,V>	withMerging(Merger<? super K,V> merger) Switch builder mode to create a conflation queue that supports merging of old and new values when conflation occurs, that is, the builder will now create a MergeConflationQueue.
ConflationQueueBuilder<K,V>	withPollerListener(java.util.function.Supplier<? extends PollerListener<? super K,? super V>> listenerSupplier) Register a listener as created by the specified supplier when creating queue pollers.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.tools4j.nobark.queue.ConflationQueueBuilder

builder, builder, declareAllConflationKeys, declareAllConflationKeys, declareAllConflationKeys, forEnumConflationKey, forEnumConflationKey

Method Detail

withAppenderListener

public ConflationQueueBuilder<K,V> withAppenderListener(java.util.function.Supplier<? extends AppenderListener<? super K,? super V>> listenerSupplier)

Description copied from interface: ConflationQueueBuilder

Register a listener as created by the specified supplier when creating queue appenders. The created listeners must be thread safe for multi-producer queues, e.g. consider using AppenderListener.threadLocalSupplier(Supplier).

Specified by:

withAppenderListener in interface ConflationQueueBuilder<K,V>

Parameters:

listenerSupplier - a listener supplier acting as listener factory

Returns:

the builder

withPollerListener

public ConflationQueueBuilder<K,V> withPollerListener(java.util.function.Supplier<? extends PollerListener<? super K,? super V>> listenerSupplier)

Description copied from interface: ConflationQueueBuilder

Register a listener as created by the specified supplier when creating queue pollers. The created listeners must be thread safe for multi-consumer queues, e.g. consider using PollerListener.threadLocalSupplier(Supplier).

Specified by:

withPollerListener in interface ConflationQueueBuilder<K,V>

Parameters:

listenerSupplier - a listener supplier acting as listener factory

Returns:

the builder

withExchangeValueSupport

public ConflationQueueBuilder.ExchangeConflationQueueBuilder<K,V> withExchangeValueSupport()

Description copied from interface: ConflationQueueBuilder

Switch builder mode to create a conflation queue that allows exchanging of elements between the consumer and the producer, that is, the builder will now create a ExchangeConflationQueue.

Specified by:

withExchangeValueSupport in interface ConflationQueueBuilder<K,V>

Returns:

a builder for an ExchangeConflationQueue, more specifically an EvictConflationQueue

See Also:

ExchangeConflationQueue, EvictConflationQueue, ConflationQueueBuilder.withMerging(Merger)

withMerging

public ConflationQueueBuilder.ExchangeConflationQueueBuilder<K,V> withMerging(Merger<? super K,V> merger)

Description copied from interface: ConflationQueueBuilder

Switch builder mode to create a conflation queue that supports merging of old and new values when conflation occurs, that is, the builder will now create a MergeConflationQueue.

Specified by:

withMerging in interface ConflationQueueBuilder<K,V>

Parameters:

merger - merge strategy to use when conflation occurs

Returns:

a builder for an ExchangeConflationQueue, more specifically a MergeConflationQueue

See Also:

ExchangeConflationQueue, MergeConflationQueue, ConflationQueueBuilder.withExchangeValueSupport()

build

public ConflationQueue<K,V> build(java.util.function.Supplier<? extends java.util.Queue<java.lang.Object>> queueFactory)

Description copied from interface: ConflationQueueBuilder

Builds and returns a new conflation queue instance using the given queue factory for the backing queue. The backing queue determines whether single or multiple producers and consumers are supported.

Specified by:

build in interface ConflationQueueBuilder<K,V>

Parameters:

queueFactory - the factory to create the backing queue

Returns:

a new conflation queue instance