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_TIMEOUT), 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(SynchronizedGeneratorIdentity synchronizedGeneratorIdentity) Get the synchronized ID generator instance.
static IDGenerator	generatorFor(ZooKeeperConnection zooKeeperConnection, String znode) 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(ZooKeeperConnection zooKeeperConnection,
                                       String znode)
                                throws IOException

Get the synchronized ID generator instance.

Parameters:

zooKeeperConnection - Connection to the ZooKeeper quorum.

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

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)
                                throws IOException

Get the synchronized ID generator instance.

Parameters:

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

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.