Package org.lable.oss.uniqueid.etcd

Class SynchronizedGeneratorIdentity

java.lang.Object

org.lable.oss.uniqueid.etcd.SynchronizedGeneratorIdentity

All Implemented Interfaces:

Closeable, AutoCloseable, GeneratorIdentityHolder

public class SynchronizedGeneratorIdentity
extends Object
implements GeneratorIdentityHolder

Constructor Summary

Constructors

Constructor	Description
SynchronizedGeneratorIdentity(io.etcd.jetcd.Client client, List<Integer> clusterIds, Supplier<Duration> claimDurationSupplier, Supplier<Duration> acquisitionTimeoutSupplier)

Method Summary

Modifier and Type	Method	Description
static SynchronizedGeneratorIdentity	basedOn(String endpoints, String namespace, Long claimDuration)	Create a new SynchronizedGeneratorIdentity instance.
static SynchronizedGeneratorIdentity	basedOn(String endpoints, String namespace, Supplier<Duration> claimDurationSupplier, Supplier<Duration> acquisitionTimeoutSupplier)	Create a new SynchronizedGeneratorIdentity instance.
void	close()
int	getClusterId()
int	getGeneratorId()
void	relinquishResourceClaim()

Methods inherited from class java.lang.Object

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

Constructor Detail

SynchronizedGeneratorIdentity

public SynchronizedGeneratorIdentity(io.etcd.jetcd.Client client,
                                     List<Integer> clusterIds,
                                     Supplier<Duration> claimDurationSupplier,
                                     Supplier<Duration> acquisitionTimeoutSupplier)

Method Detail

basedOn

public static SynchronizedGeneratorIdentity basedOn(String endpoints,
                                                    String namespace,
                                                    Supplier<Duration> claimDurationSupplier,
                                                    Supplier<Duration> acquisitionTimeoutSupplier)
                                             throws IOException

Create a new SynchronizedGeneratorIdentity instance.

By using a Supplier instead of static longs for the claim duration and the acquisition timeout, these values can be dynamically reconfigured at runtime.

Parameters:

endpoints - Addresses of the Etcd cluster (comma-separated).

namespace - Namespace of the unique-id keys in Etcd.

claimDurationSupplier - Provides the amount of time a claim to a generator-ID should be held.

acquisitionTimeoutSupplier - Provides the amount of time the process of acquiring a generator-ID may take. May be null to indicate that the process may wait indefinitely.

Returns:

A SynchronizedGeneratorIdentity instance.

Throws:

IOException

basedOn

public static SynchronizedGeneratorIdentity basedOn(String endpoints,
                                                    String namespace,
                                                    Long claimDuration)
                                             throws IOException

Create a new SynchronizedGeneratorIdentity instance.

Parameters:

endpoints - Addresses of the Etcd cluster (comma-separated).

namespace - Namespace of the unique-id keys in Etcd.

claimDuration - How long a claim to a generator-ID should be held, in milliseconds.

Returns:

A SynchronizedGeneratorIdentity instance.

Throws:

IOException

getClusterId

public int getClusterId()
                 throws GeneratorException

Specified by:

getClusterId in interface GeneratorIdentityHolder

Throws:

GeneratorException

getGeneratorId

public int getGeneratorId()
                   throws GeneratorException

Specified by:

getGeneratorId in interface GeneratorIdentityHolder

Throws:

GeneratorException

relinquishResourceClaim

public void relinquishResourceClaim()

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException