gov.nasa.jpf.vm.choice

Class RandomIntIntervalGenerator

java.lang.Object

gov.nasa.jpf.vm.ChoiceGeneratorBase<java.lang.Integer>

gov.nasa.jpf.vm.choice.RandomIntIntervalGenerator

All Implemented Interfaces:

ChoiceGenerator<java.lang.Integer>, IntChoiceGenerator, java.lang.Cloneable

public class RandomIntIntervalGenerator
extends ChoiceGeneratorBase<java.lang.Integer>
implements IntChoiceGenerator

a IntChoiceGenerator that randomly chooses a configured number of values from a specified range this is usually configured through app properties <2do> this is too redundant to RandomOrderIntCG - replace

Field Summary

Fields

Modifier and Type	Field and Description
protected int	count
protected int	max
protected int	min
protected int	nChoices
protected int	next
protected java.util.Random	random
protected int	range
protected long	seed

Fields inherited from class gov.nasa.jpf.vm.ChoiceGeneratorBase

attr, id, idRef, insn, isCascaded, isDone, MARKER, prev, stateId, ti

Constructor Summary

Constructors

Constructor and Description
RandomIntIntervalGenerator(Config conf, java.lang.String id)
RandomIntIntervalGenerator(java.lang.String id, int min, int max, int nChoices)
RandomIntIntervalGenerator(java.lang.String id, int min, int max, int nChoices, long seed)

Method Summary

Modifier and Type	Method and Description
void	advance() advance to the next choice.
java.lang.Integer	getChoice(int idx) explicit choice enumeration.
java.lang.Class<java.lang.Integer>	getChoiceType()
java.lang.Integer	getNextChoice()
int	getProcessedNumberOfChoices()
int	getTotalNumberOfChoices()
boolean	hasMoreChoices()
ChoiceGenerator<java.lang.Integer>	randomize() turn the order of choices random (if it isn't already).
void	reset() this has to reset the CG to its initial state, which includes resetting 'isDone'
java.lang.String	toString()

Methods inherited from class gov.nasa.jpf.vm.ChoiceGeneratorBase

addAttr, advance, attrIterator, attrIterator, clone, deepClone, getAll, getAllChoices, getAllOfType, getAttr, getAttr, getCascade, getCascadedParent, getId, getIdRef, getInsn, getNextAttr, getNumberOfParents, getPreviousChoiceGenerator, getPreviousChoiceGeneratorOfType, getProcessedChoices, getSourceLocation, getStateId, getThreadInfo, getUnprocessedChoices, hasAttr, hasAttr, hasAttrValue, init, isCascaded, isDone, isProcessed, isSchedulingPoint, removeAttr, reorder, replaceAttr, select, setAttr, setCascaded, setContext, setCurrent, setDone, setId, setIdRef, setInsn, setPreviousChoiceGenerator, setStateId, setThreadInfo, supportsReordering, useRandomization

Methods inherited from class java.lang.Object

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

Methods inherited from interface gov.nasa.jpf.vm.ChoiceGenerator

addAttr, advance, attrIterator, attrIterator, clone, deepClone, getAll, getAllChoices, getAllOfType, getAttr, getAttr, getCascade, getCascadedParent, getId, getIdRef, getInsn, getNextAttr, getNumberOfParents, getPreviousChoiceGenerator, getPreviousChoiceGeneratorOfType, getProcessedChoices, getSourceLocation, getStateId, getThreadInfo, getUnprocessedChoices, hasAttr, hasAttr, isCascaded, isDone, isProcessed, isSchedulingPoint, removeAttr, reorder, replaceAttr, select, setAttr, setCascaded, setContext, setCurrent, setDone, setId, setIdRef, setInsn, setPreviousChoiceGenerator, setStateId, setThreadInfo, supportsReordering

Field Detail

min

protected int min

max

protected int max

nChoices

protected int nChoices

seed

protected long seed

random

protected java.util.Random random

range

protected int range

next

protected int next

count

protected int count

Constructor Detail

RandomIntIntervalGenerator

public RandomIntIntervalGenerator(java.lang.String id,
                                  int min,
                                  int max,
                                  int nChoices)

RandomIntIntervalGenerator

public RandomIntIntervalGenerator(java.lang.String id,
                                  int min,
                                  int max,
                                  int nChoices,
                                  long seed)

RandomIntIntervalGenerator

public RandomIntIntervalGenerator(Config conf,
                                  java.lang.String id)

Method Detail

getChoice

public java.lang.Integer getChoice(int idx)

Description copied from class: ChoiceGeneratorBase

explicit choice enumeration. Override if supported

Specified by:

getChoice in interface ChoiceGenerator<java.lang.Integer>

Overrides:

getChoice in class ChoiceGeneratorBase<java.lang.Integer>

Returns:

choice value or null if not supported

reset

public void reset()

Description copied from interface: ChoiceGenerator

this has to reset the CG to its initial state, which includes resetting 'isDone'

Specified by:

reset in interface ChoiceGenerator<java.lang.Integer>

hasMoreChoices

public boolean hasMoreChoices()

Specified by:

hasMoreChoices in interface ChoiceGenerator<java.lang.Integer>

advance

public void advance()

Description copied from interface: ChoiceGenerator

advance to the next choice. This is the only method that really advances our enumeration

Specified by:

advance in interface ChoiceGenerator<java.lang.Integer>

getNextChoice

public java.lang.Integer getNextChoice()

Specified by:

getNextChoice in interface ChoiceGenerator<java.lang.Integer>

getTotalNumberOfChoices

public int getTotalNumberOfChoices()

Specified by:

getTotalNumberOfChoices in interface ChoiceGenerator<java.lang.Integer>

getProcessedNumberOfChoices

public int getProcessedNumberOfChoices()

Specified by:

getProcessedNumberOfChoices in interface ChoiceGenerator<java.lang.Integer>

toString

public java.lang.String toString()

Overrides:

toString in class ChoiceGeneratorBase<java.lang.Integer>

getChoiceType

public java.lang.Class<java.lang.Integer> getChoiceType()

Specified by:

getChoiceType in interface ChoiceGenerator<java.lang.Integer>

randomize

public ChoiceGenerator<java.lang.Integer> randomize()

Description copied from interface: ChoiceGenerator

turn the order of choices random (if it isn't already). Only drawback of this generic method (which might be a decorator factory) is that our type layer (e.g. IntChoiceGenerator) has to guarantee type safety. But hey - this is the first case where we can use covariant return types! NOTES: - this method may alter this ChoiceGenerator and return that or return a new "decorated" version. - random data can be read from the "Random random" field in this class.

Specified by:

randomize in interface ChoiceGenerator<java.lang.Integer>

Overrides:

randomize in class ChoiceGeneratorBase<java.lang.Integer>