org.lable.oss.uniqueid.zookeeper

Class SynchronizedUniqueIDGeneratorFactory

java.lang.Object

org.lable.oss.uniqueid.zookeeper.SynchronizedUniqueIDGeneratorFactory

public class SynchronizedUniqueIDGeneratorFactory
extends Object

Create an IDGenerator capable of generating unique identifiers in a distributed environment with multiple services generating them. To do this, the GeneratorIdentityHolder it uses acquires a temporary claim on a generator ID negotiated via a ZooKeeper quorum.

Because claimed generator IDs are automatically returned to the pool after a set time (ExpiringResourceClaim.DEFAULT_CLAIM_HOLD), there is no guarantee that IDs generated by the same IDGenerator instance share the same generator ID.

Constructor Summary

Constructors

Constructor and Description
SynchronizedUniqueIDGeneratorFactory()

Method Summary

Modifier and Type	Method and Description
static IDGenerator	generatorFor(org.lable.oss.dynamicconfig.zookeeper.MonitoringZookeeperConnection zooKeeperConnection, String znode, Clock clock, Mode mode) Get the synchronized ID generator instance.
static IDGenerator	generatorFor(org.lable.oss.dynamicconfig.zookeeper.MonitoringZookeeperConnection zooKeeperConnection, String znode, Mode mode) Get the synchronized ID generator instance.
static IDGenerator	generatorFor(SynchronizedGeneratorIdentity synchronizedGeneratorIdentity, Clock clock, Mode mode) Get the synchronized ID generator instance.

Methods inherited from class java.lang.Object

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

Constructor Detail

SynchronizedUniqueIDGeneratorFactory

public SynchronizedUniqueIDGeneratorFactory()

Method Detail

generatorFor

public static IDGenerator generatorFor(org.lable.oss.dynamicconfig.zookeeper.MonitoringZookeeperConnection zooKeeperConnection,
                                       String znode,
                                       Clock clock,
                                       Mode mode)
                                throws IOException

Get the synchronized ID generator instance.

Parameters:

zooKeeperConnection - Connection to the ZooKeeper quorum.

znode - Base-path of the resource pool in ZooKeeper.

clock - Clock implementation.

mode - Generator mode.

Returns:

An instance of this class.

Throws:

IOException - Thrown when something went wrong trying to find the cluster ID or trying to claim a generator ID.

generatorFor

public static IDGenerator generatorFor(org.lable.oss.dynamicconfig.zookeeper.MonitoringZookeeperConnection zooKeeperConnection,
                                       String znode,
                                       Mode mode)
                                throws IOException

Get the synchronized ID generator instance.

Parameters:

zooKeeperConnection - Connection to the ZooKeeper quorum.

znode - Base-path of the resource pool in ZooKeeper.

mode - Generator mode.

Returns:

An instance of this class.

Throws:

IOException - Thrown when something went wrong trying to find the cluster ID or trying to claim a generator ID.

generatorFor

public static IDGenerator generatorFor(SynchronizedGeneratorIdentity synchronizedGeneratorIdentity,
                                       Clock clock,
                                       Mode mode)
                                throws IOException

Get the synchronized ID generator instance.

Parameters:

synchronizedGeneratorIdentity - An instance of SynchronizedGeneratorIdentity to (re)use for acquiring the generator ID.

clock - Clock implementation.

mode - Generator mode.

Returns:

An instance of this class.

Throws:

IOException - Thrown when something went wrong trying to find the cluster ID or trying to claim a generator ID.