com.openpojo.random

Class RandomFactory

java.lang.Object

com.openpojo.random.RandomFactory

public class RandomFactory
extends java.lang.Object

This factory is responsible for generating the random values using the registered RandomGenerator(s).
This Factory will automatically detect cyclic dependency and return null for the second time around.

Simple Example
If you have an Employee class that has the following constructor:

 
 public Employee(final String fullName, final Employee manager) {
   ...
 }
 
 

And you created the random generator as follows:

 
 public Object doGenerate(Class<?> type) {
     return new Employee(RandomFactory.getRandomValue(String.class),
                          (Employee) RandomFactory.getRandomValue(Employee.class));
 }
 
 

This would potentially cause a stack over-flow since there is a cyclic dependency of Employee on itself. So to prevent stack over-flow (which would occur by trying to create a manager for every manager), this Factory has built in protection (using GeneratedRandomValues) to prevent such a thing by recording for a current recursive call if it's seen this type before, if so, it will return null the second time around.

Author:

oshoukry

Constructor Summary

Constructors

Constructor and Description
RandomFactory()

Method Summary

Modifier and Type	Method and Description
static void	addRandomGenerator(RandomGenerator generator) Add a random generator to the list of available generators.
static <T> T	getRandomValue(java.lang.Class<T> type) This method generates a random value of the requested type. If the requested type isn't registered in the factory, an RandomGeneratorException will be thrown.
static java.lang.Object	getRandomValue(Parameterizable parameterizable)

Methods inherited from class java.lang.Object

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

Constructor Detail

RandomFactory

public RandomFactory()

Method Detail

addRandomGenerator

public static void addRandomGenerator(RandomGenerator generator)

Add a random generator to the list of available generators. The latest random generator registered wins.

Parameters:

generator - The generator to add.

getRandomValue

public static <T> T getRandomValue(java.lang.Class<T> type)

This method generates a random value of the requested type.
If the requested type isn't registered in the factory, an RandomGeneratorException will be thrown.

Type Parameters:

T - The class type to generate an object for.

Parameters:

type - The type to get a random value of.

Returns:

Randomly created value.

getRandomValue

public static java.lang.Object getRandomValue(Parameterizable parameterizable)