Package org.wildfly.clustering.cache.infinispan.embedded.affinity

Class DefaultKeyAffinityService<K>

java.lang.Object

org.wildfly.clustering.cache.infinispan.embedded.affinity.DefaultKeyAffinityService<K>

Type Parameters:

K - the cache key type

All Implemented Interfaces:

Supplier<BlockingQueue<K>>, org.infinispan.affinity.KeyAffinityService<K>, org.infinispan.commons.api.Lifecycle

public class DefaultKeyAffinityService<K>
extends Object
implements org.infinispan.affinity.KeyAffinityService<K>, Supplier<BlockingQueue<K>>

A custom key affinity service implementation with the following distinct characteristics (as compared to KeyAffinityServiceImpl):

• getKeyForAddress(Address) will return a random key (instead of throwing an ISE) if the specified address does not own any segments.
• Uses a worker thread per address for which to generate keys.
• Minimal CPU utilization when key queues are full.
• Non-blocking topology change event handler.
• getKeyForAddress(Address) calls will not block during topology change events.

Author:

Paul Ferraro

Method Summary

Modifier and Type	Method	Description
BlockingQueue<K>	get()
K	getCollocatedKey(K otherKey)
K	getKeyForAddress(org.infinispan.remoting.transport.Address address)
boolean	isStarted()
void	setPollTimeout(Duration timeout)	Overrides the duration of time for which calls to getKeyForAddress(Address) will wait for an available pre-generated key, after which a random key will be returned.
void	setQueueSize(int size)	Overrides the maximum number of keys with affinity to a given member to pre-generate.
void	start()
void	stop()
CompletionStage<Void>	topologyChanged(org.infinispan.notifications.cachelistener.event.TopologyChangedEvent<?,?> event)

Methods inherited from class java.lang.Object

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

Method Details

setQueueSize

public void setQueueSize(int size)

Overrides the maximum number of keys with affinity to a given member to pre-generate.

Parameters:

size - a queue size threshold

setPollTimeout

public void setPollTimeout(Duration timeout)

Overrides the duration of time for which calls to getKeyForAddress(Address) will wait for an available pre-generated key, after which a random key will be returned.

Parameters:

timeout - a queue poll timeout

get

public BlockingQueue<K> get()

Specified by:

get in interface Supplier<K>

isStarted

public boolean isStarted()

Specified by:

isStarted in interface org.infinispan.affinity.KeyAffinityService<K>

start

public void start()

Specified by:

start in interface org.infinispan.commons.api.Lifecycle

stop

public void stop()

Specified by:

stop in interface org.infinispan.commons.api.Lifecycle

getCollocatedKey

public K getCollocatedKey(K otherKey)

Specified by:

getCollocatedKey in interface org.infinispan.affinity.KeyAffinityService<K>

getKeyForAddress

public K getKeyForAddress(org.infinispan.remoting.transport.Address address)

Specified by:

getKeyForAddress in interface org.infinispan.affinity.KeyAffinityService<K>

topologyChanged

public CompletionStage<Void> topologyChanged(org.infinispan.notifications.cachelistener.event.TopologyChangedEvent<?,?> event)