com.github.f4b6a3.uuid.factory

Class RandomUuidCreator

java.lang.Object

com.github.f4b6a3.uuid.factory.abst.AbstractUuidCreator

com.github.f4b6a3.uuid.factory.RandomUuidCreator

All Implemented Interfaces:

NoArgumentsUuidCreator

public class RandomUuidCreator
extends AbstractUuidCreator
implements NoArgumentsUuidCreator

Factory that creates random-based UUIDs. RFC-4122 version: 4. The default random generator is SecureRandom, but it can be replaced by any random generator that extends Random. Some fast random generators are provided along with this project, for example, Xorshift128PlusRandom, which is default RNG for some web browsers.

Field Summary

Fields

Modifier and Type	Field and Description
protected Random	random

Fields inherited from class com.github.f4b6a3.uuid.factory.abst.AbstractUuidCreator

version, versionBits

Constructor Summary

Constructors

Constructor and Description
RandomUuidCreator()

Method Summary

Modifier and Type	Method and Description
UUID	create() Return a UUID with random value. ### RFC-4122 - 4.4.
RandomUuidCreator	withFastRandomGenerator() Replaces the default random generator with a faster one.
RandomUuidCreator	withRandomGenerator(Random random) Replace the default random generator, in a fluent way, to another that extends Random.

Methods inherited from class com.github.f4b6a3.uuid.factory.abst.AbstractUuidCreator

getVariantBits, getVersion, getVersionBits, setVariantBits, setVersionBits

Methods inherited from class java.lang.Object

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

Field Detail

random

protected Random random

Constructor Detail

RandomUuidCreator

public RandomUuidCreator()

Method Detail

create

public UUID create()

Return a UUID with random value. ### RFC-4122 - 4.4. Algorithms for Creating a UUID from Truly Random or Pseudo-Random Numbers (1) Set the two most significant bits (bits 6 and 7) of the clock_seq_hi_and_reserved to zero and one, respectively. (2) Set the four most significant bits (bits 12 through 15) of the time_hi_and_version field to the 4-bit version number from Section 4.1.3. (3) Set all the other bits to randomly (or pseudo-randomly) chosen values.

Specified by:

create in interface NoArgumentsUuidCreator

Returns:

a random UUID

withRandomGenerator

public RandomUuidCreator withRandomGenerator(Random random)

Replace the default random generator, in a fluent way, to another that extends Random. The default random generator is SecureRandom. For other faster pseudo-random generators, see XorshiftRandom and its variations. See Random.

Parameters:

random - a random generator

Returns:

RandomUuidCreator

withFastRandomGenerator

public RandomUuidCreator withFastRandomGenerator()

Replaces the default random generator with a faster one. The host fingerprint is used to generate a seed for the random number generator. See Xorshift128PlusRandom and FingerprintUtil.getFingerprint()

Returns:

RandomUuidCreator