de.uka.ipd.sdq.beagle.core

Class AnalysisController

java.lang.Object

de.uka.ipd.sdq.beagle.core.AnalysisController

public class AnalysisController
extends Object

Conducts a complete analysis of elements on a blackboard. Controls the MeasurementController, ResultAnalysers and the FinalJudge to measure and analyse parametric dependencies.

The Analysis

During the analysis, the controller will ask participants whether they can contribute (except for the FinalJudge, which must always be able to judge). The participants may only make these assumptions of the control flow:

• There is always only the MeasurementController, only the FinalJudge or only one ProposedExpressionAnalyser (or none of the previous) running. They may use parallelisation as they wish but are self-responsible for synchronisation.
• A ProposedExpressionAnalyser will only be called if its ProposedExpressionAnalyser.canContribute(de.uka.ipd.sdq.beagle.core.analysis.ReadOnlyProposedExpressionAnalyserBlackboardView) method returns true. The MeasurementController will only be called if its canMeasure method returns true.
• When picking the next participant, the MeasurementController will be always be called next if its canMeasure method returns true.
• Any ProposedExpressionAnalyser whose canContribute method returns true will be called.
• The FinalJudge will only be called if no ProposedExpressionAnalyser can contribute.

See Also:

MeasurementController, Blackboard

Constructor Summary

Constructors

Constructor and Description
AnalysisController(Blackboard blackboard, Set<MeasurementTool> measurementTools, Set<MeasurementResultAnalyser> measurementResultAnalysers, Set<ProposedExpressionAnalyser> proposedExpressionAnalysers) Creates a controller to analyse all elements written on blackboard.

Method Summary

Modifier and Type	Method and Description
AnalysisState	getAnalysisState() Returns the current state of the analysis.
void	performAnalysis() Runs the complete analysis, including measurements, result analysis and the final judging.
void	setAnalysisState(AnalysisState analysisState) Sets the current state of the analysis to analysisState.

Methods inherited from class java.lang.Object

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

Constructor Detail

AnalysisController

public AnalysisController(Blackboard blackboard,
                          Set<MeasurementTool> measurementTools,
                          Set<MeasurementResultAnalyser> measurementResultAnalysers,
                          Set<ProposedExpressionAnalyser> proposedExpressionAnalysers)

Creates a controller to analyse all elements written on blackboard.

Parameters:

blackboard - A blackboard having everything to be analysed written on it. Must not be null.

measurementTools - The MeasurementTools to use. Must not be null and must not contain null.

measurementResultAnalysers - The MeasurementResultAnalysers to use. Must not be null and must not contain null.

proposedExpressionAnalysers - The ProposedExpressionAnalysers to use. Must not be null and must not contain null.

Method Detail

performAnalysis

public void performAnalysis()

Runs the complete analysis, including measurements, result analysis and the final judging. See the class description for more details on the analysis process.

getAnalysisState

public AnalysisState getAnalysisState()

Returns the current state of the analysis.

Returns:

The current state of the analysis.

setAnalysisState

public void setAnalysisState(AnalysisState analysisState)

Sets the current state of the analysis to analysisState. The analysis must be started before this method is called. Otherwise an IllegalStateException will be thrown.

Parameters:

analysisState - The state the analysis will be in after this method has been called.