de.rwth.i2.attestor.stateSpaceGeneration

Class StateSpaceGeneratorBuilder

java.lang.Object

de.rwth.i2.attestor.stateSpaceGeneration.StateSpaceGeneratorBuilder

public class StateSpaceGeneratorBuilder
extends Object

This class provides methodExecution to safely initialize a StateSpaceGenerator.

Author:

Christoph

Field Summary

Fields

Modifier and Type	Field and Description
protected StateSpaceGenerator	generator Internal instance of the StateSpaceGenerator under construction by this builder
protected List<ProgramState>	initialStates The initial state passed to the state space generation

Method Summary

Modifier and Type	Method and Description
StateSpaceGeneratorBuilder	addInitialState(ProgramState initialState)
StateSpaceGeneratorBuilder	addInitialStates(List<ProgramState> initialStates)
StateSpaceGenerator	build() Attempts to construct a new StateSpaceGenerator.
StateSpaceGeneratorBuilder	setAbortStrategy(AbortStrategy abortStrategy)
StateSpaceGeneratorBuilder	setAlwaysCanonicalize(boolean alwaysCanonicalize)
StateSpaceGeneratorBuilder	setCanonizationStrategy(StateCanonicalizationStrategy canonicalizationStrategy)
StateSpaceGeneratorBuilder	setFinalStateStrategy(FinalStateStrategy finalStateStrategy)
StateSpaceGeneratorBuilder	setInitialStateSpace(StateSpace initialStateSpace) Optional method to determine a (possibly non-empty) initial state space used for state space generation.
StateSpaceGeneratorBuilder	setMaterializationStrategy(MaterializationStrategy materializationStrategy)
StateSpaceGeneratorBuilder	setPostProcessingStrategy(PostProcessingStrategy postProcessingStrategy)
StateSpaceGeneratorBuilder	setProgram(Program program)
StateSpaceGeneratorBuilder	setStateCounter(StateSpaceGenerator.TotalStatesCounter stateCounter)
StateSpaceGeneratorBuilder	setStateExplorationStrategy(StateExplorationStrategy strategy)
StateSpaceGeneratorBuilder	setStateLabelingStrategy(StateLabelingStrategy stateLabelingStrategy)
StateSpaceGeneratorBuilder	setStateRectificationStrategy(StateRectificationStrategy stateRectificationStrategy)
StateSpaceGeneratorBuilder	setStateRefinementStrategy(StateRefinementStrategy stateRefinementStrategy)
StateSpaceGeneratorBuilder	setStateSpaceSupplier(StateSpaceSupplier stateSpaceSupplier)

Methods inherited from class java.lang.Object

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

Field Detail

initialStates

protected final List<ProgramState> initialStates

The initial state passed to the state space generation

generator

protected final StateSpaceGenerator generator

Internal instance of the StateSpaceGenerator under construction by this builder

Method Detail

build

public StateSpaceGenerator build()

Attempts to construct a new StateSpaceGenerator. If the initialization is incomplete or invalid calling this method causes an IllegalStateException.

Returns:

StateSpaceGenerator initialized by the previously called methodExecution of this builder

addInitialState

public StateSpaceGeneratorBuilder addInitialState(ProgramState initialState)

Parameters:

initialState - The initial state from which all reachable states are computed by the state space generation.

Returns:

The builder.

addInitialStates

public StateSpaceGeneratorBuilder addInitialStates(List<ProgramState> initialStates)

Parameters:

initialStates - The initial states from which all reachable states are computed by the state space generation.

Returns:

The builder.

setProgram

public StateSpaceGeneratorBuilder setProgram(Program program)

Parameters:

program - The program that is executed to generate the state space.

Returns:

The builder.

setMaterializationStrategy

public StateSpaceGeneratorBuilder setMaterializationStrategy(MaterializationStrategy materializationStrategy)

Parameters:

materializationStrategy - The strategy used for materialization.

Returns:

The builder.

setCanonizationStrategy

public StateSpaceGeneratorBuilder setCanonizationStrategy(StateCanonicalizationStrategy canonicalizationStrategy)

Parameters:

canonicalizationStrategy - The strategy used for canonicalization.

Returns:

The builder.

setStateRectificationStrategy

public StateSpaceGeneratorBuilder setStateRectificationStrategy(StateRectificationStrategy stateRectificationStrategy)

setAbortStrategy

public StateSpaceGeneratorBuilder setAbortStrategy(AbortStrategy abortStrategy)

Parameters:

abortStrategy - The strategy used for aborting the state space generation.

Returns:

The builder.

setStateLabelingStrategy

public StateSpaceGeneratorBuilder setStateLabelingStrategy(StateLabelingStrategy stateLabelingStrategy)

Parameters:

stateLabelingStrategy - The strategy used to label states with atomic propositions.

Returns:

The builder.

setStateRefinementStrategy

public StateSpaceGeneratorBuilder setStateRefinementStrategy(StateRefinementStrategy stateRefinementStrategy)

Parameters:

stateRefinementStrategy - The strategy to refine states before continuing the symbolic execution.

Returns:

The builder.

setStateCounter

public StateSpaceGeneratorBuilder setStateCounter(StateSpaceGenerator.TotalStatesCounter stateCounter)

Parameters:

stateCounter - The global counter for the total number of states generated so far.

Returns:

The builder.

setStateExplorationStrategy

public StateSpaceGeneratorBuilder setStateExplorationStrategy(StateExplorationStrategy strategy)

Parameters:

strategy - A strategy that determines how successors of a given state are explored.

Returns:

The builder.

setStateSpaceSupplier

public StateSpaceGeneratorBuilder setStateSpaceSupplier(StateSpaceSupplier stateSpaceSupplier)

Parameters:

stateSpaceSupplier - The function determining which instances of state spaces are generated

Returns:

The builder.

setPostProcessingStrategy

public StateSpaceGeneratorBuilder setPostProcessingStrategy(PostProcessingStrategy postProcessingStrategy)

Parameters:

postProcessingStrategy - A strategy to optimize the state space after state space generation terminated. This strategy is applied for each generated state space, including procedure calls.

Returns:

The builder.

setInitialStateSpace

public StateSpaceGeneratorBuilder setInitialStateSpace(StateSpace initialStateSpace)

Optional method to determine a (possibly non-empty) initial state space used for state space generation.

Parameters:

initialStateSpace - The state space to use instead of a fresh one.

Returns:

The builder.

setFinalStateStrategy

public StateSpaceGeneratorBuilder setFinalStateStrategy(FinalStateStrategy finalStateStrategy)

setAlwaysCanonicalize

public StateSpaceGeneratorBuilder setAlwaysCanonicalize(boolean alwaysCanonicalize)