com.github.f4b6a3.uuid.factory

Class RandomUuidCreator

java.lang.Object

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

com.github.f4b6a3.uuid.factory.RandomUuidCreator

public class RandomUuidCreator
extends AbstractUuidCreator

Factory that creates random UUIDs 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 inherited from class com.github.f4b6a3.uuid.factory.abst.AbstractUuidCreator

NIL_UUID, RFC4122_VARIANT_BITS, RFC4122_VERSION_BITS, version

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 fester 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, valid

Methods inherited from class java.lang.Object

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

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.

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 with SHA1PRNG algorithm. For other faster pseudo-random generators, see XorshiftRandom and its variations. Random.

Parameters:

random - a random generator

Returns:

RandomUuidCreator

withFastRandomGenerator

public RandomUuidCreator withFastRandomGenerator()

Replaces the default random generator with a fester one. Xorshift128PlusRandom

Returns:

RandomUuidCreator