de.invation.code.toval.misc.valuegeneration.ValueGenerator Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of TOVAL Show documentation

TOVAL comprises a set of java classes for common programming issues. It includes utils for arrays, lists, sets and collections for convenient handling and modification, but also support for mathematic definitions concerning logic (clauses + resolution) together with some algorithms for permutations, powersets and resolution. Additionally it contains a number of types for multisets, matrices with object keys and much more.

The newest version!

package de.invation.code.toval.misc.valuegeneration;

import de.invation.code.toval.validate.InconsistencyException;


/**
 * Interface for value generators.

 * A value generator produces values of a specific type and returns it by the method {@link #getNextValue()}.
 * Value generation is only permitted if the generator is in a valid state.

 * Once entered a valid state, the generator cannot enter an invalid state again.

 * If value generations are requested in invalid state, 
 * Exceptions of type {@link ValueGenerationException} are thrown.
 *
 * @param 
 */
public interface ValueGenerator {
	
	public E getNextValue() throws ValueGenerationException;
	
	public boolean isValid();
	
	@SuppressWarnings("rawtypes")
	public Class getValueClass() throws InconsistencyException;
	
	public boolean isEmpty();
	
	public ValueGenerator clone();
}