Package io.github.pr0methean.betterrandom.seed

Class LegacyRandomSeeder

java.lang.Object

io.github.pr0methean.betterrandom.util.Looper

io.github.pr0methean.betterrandom.seed.RandomSeeder

io.github.pr0methean.betterrandom.seed.LegacyRandomSeeder

All Implemented Interfaces:

Serializable

public final class LegacyRandomSeeder
extends RandomSeeder

A RandomSeeder that can reseed any instance of Random.

Author:

Chris Hennick

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class io.github.pr0methean.betterrandom.seed.RandomSeeder

RandomSeeder.DefaultThreadFactory

Field Summary

Fields inherited from class io.github.pr0methean.betterrandom.seed.RandomSeeder

byteArrayPrngs, DEFAULT_STOP_IF_EMPTY_FOR_NANOS, FIRST_POLL_INTERVAL, REPEAT_POLL_INTERVAL, seedGenerator, stopIfEmptyForNanos, waitForEntropyDrain, waitWhileEmpty

Fields inherited from class io.github.pr0methean.betterrandom.util.Looper

DEFAULT_THREAD_FACTORY, factory, lock, thread, threadLock

Constructor Summary

Constructors

Constructor	Description
LegacyRandomSeeder(SeedGenerator seedGenerator)	Creates an instance using a RandomSeeder.DefaultThreadFactory.
LegacyRandomSeeder(SeedGenerator seedGenerator, ThreadFactory threadFactory)	Creates an instance whose thread will terminate if no PRNGs have been associated with it for 5 seconds.
LegacyRandomSeeder(SeedGenerator seedGenerator, ThreadFactory threadFactory, long stopIfEmptyForNanos)	Creates an instance.

Method Summary

Modifier and Type	Method	Description
void	addLegacyRandoms(Collection<? extends Random> randoms)	Adds Random instances.
void	addLegacyRandoms(Random... randoms)	Adds Random instances.
protected void	clear()	Removes all PRNGs from this seeder.
boolean	contains(Object random)	Checks whether the given PRNG is currently registered with this RandomSeeder.
protected void	initTransientFields()	Initializes the transient instance fields for this class.
boolean	isEmpty()	Returns true if no Random instances are registered with this LegacyRandomSeeder.
protected boolean	iterate()	The task that will be iterated until it returns false.
void	removeLegacyRandoms(Collection<?> randoms)	Removes instances of Random and/or ByteArrayReseedableRandom.
void	removeLegacyRandoms(Random... randoms)	Removes Random instances.
String	toString()

Methods inherited from class io.github.pr0methean.betterrandom.seed.RandomSeeder

add, add, equals, getSeedGenerator, hashCode, remove, remove, reseedByteArrayReseedableRandoms, reseedWithLong, shutDown, stillEmptyAfterWaiting, stopIfEmpty, unregisterWithAll, waitForEntropyDrainOrUpdateFlag, wakeUp

Methods inherited from class io.github.pr0methean.betterrandom.util.Looper

interrupt, isRunning, start

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

LegacyRandomSeeder

public LegacyRandomSeeder(SeedGenerator seedGenerator,
                          ThreadFactory threadFactory)

Creates an instance whose thread will terminate if no PRNGs have been associated with it for 5 seconds.

Parameters:

seedGenerator - the seed generator

threadFactory - the ThreadFactory that will create this seeder's thread

LegacyRandomSeeder

public LegacyRandomSeeder(SeedGenerator seedGenerator,
                          ThreadFactory threadFactory,
                          long stopIfEmptyForNanos)

Creates an instance.

Parameters:

seedGenerator - the seed generator

threadFactory - the ThreadFactory that will create this seeder's thread

stopIfEmptyForNanos - time in nanoseconds after which this thread will terminate if no PRNGs are attached

LegacyRandomSeeder

public LegacyRandomSeeder(SeedGenerator seedGenerator)

Creates an instance using a RandomSeeder.DefaultThreadFactory.

Parameters:

seedGenerator - the seed generator

Method Detail

initTransientFields

protected void initTransientFields()

Description copied from class: RandomSeeder

Initializes the transient instance fields for this class. Called by constructors and during deserialization.

Overrides:

initTransientFields in class RandomSeeder

removeLegacyRandoms

public void removeLegacyRandoms(Random... randoms)

Removes Random instances.

Parameters:

randoms - the instances to remove

removeLegacyRandoms

public void removeLegacyRandoms(Collection<?> randoms)

Removes instances of Random and/or ByteArrayReseedableRandom.

Parameters:

randoms - the instances to remove

addLegacyRandoms

public void addLegacyRandoms(Random... randoms)

Adds Random instances.

Parameters:

randoms - the PRNGs to start reseeding

addLegacyRandoms

public void addLegacyRandoms(Collection<? extends Random> randoms)

Adds Random instances.

Parameters:

randoms - the PRNGs to start reseeding

contains

public boolean contains(Object random)

Description copied from class: RandomSeeder

Checks whether the given PRNG is currently registered with this RandomSeeder.

Overrides:

contains in class RandomSeeder

Parameters:

random - the PRNG to check the status of

Returns:

true if registered; false if not

iterate

protected boolean iterate()

Description copied from class: Looper

The task that will be iterated until it returns false. Cannot be abstract for serialization reasons, but must be overridden in subclasses if they are instantiated without a target Runnable.

Overrides:

iterate in class RandomSeeder

Returns:

true if this thread should iterate again.

isEmpty

public boolean isEmpty()

Description copied from class: RandomSeeder

Returns true if no Random instances are registered with this LegacyRandomSeeder.

Overrides:

isEmpty in class RandomSeeder

Returns:

true if no Random instances are registered with this LegacyRandomSeeder.

clear

protected void clear()

Description copied from class: RandomSeeder

Removes all PRNGs from this seeder.

Overrides:

clear in class RandomSeeder

toString

public String toString()

Overrides:

toString in class Object