com.hazelcast.core

Interface IdGenerator

All Superinterfaces:

DistributedObject

All Known Implementing Classes:

ClientIdGeneratorProxy, IdGeneratorProxy

public interface IdGenerator
extends DistributedObject

The IdGenerator is responsible for creating unique id's (a long) in a cluster. In theory a IAtomicLong.incrementAndGet() could be used to provide the same functionality. The big difference is that the incrementAndGet requires one or more remote calls for every invocation and therefor is a performance and scalability bottleneck. The IdGenerator uses an IAtomicLong under the hood, but instead of doing remote call for every call to newId(), it does it less frequently. It checks out a chunk, e.g. 1..1000 and as long as it has not yet consumed all the id's in its chunk, then no remote call is done. It can be that id's generated by different cluster members get out of order because each member will get its own chunk. It could be that member 1 has chunk 1..1000 and member 2 has 1001..2000. So therefor member 2 will automatically have id's that are out of order with the id's generated by member 1.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	init(long id) Try to initialize this IdGenerator instance with given id.
long	newId() Generates and returns cluster-wide unique id.

Methods inherited from interface com.hazelcast.core.DistributedObject

destroy, getId, getName, getPartitionKey, getServiceName

Method Detail

init

boolean init(long id)

Try to initialize this IdGenerator instance with given id. The first generated id will be 1 bigger than id.

Returns:

true if initialization succeeded. If id is smaller than 0, then false is returned.

newId

long newId()

Generates and returns cluster-wide unique id. Generated ids are guaranteed to be unique for the entire cluster as long as the cluster is live. If the cluster restarts then id generation will start from 0.

Returns:

cluster-wide new unique id