de.uka.ipd.sdq.beagle.analysis.averaging

Class MeasurementResultAnalyserAverage

java.lang.Object

de.uka.ipd.sdq.beagle.analysis.averaging.MeasurementResultAnalyserAverage

All Implemented Interfaces:

MeasurementResultAnalyser, BlackboardStorer<HashMap<MeasurableSeffElement,Integer>>

public class MeasurementResultAnalyserAverage
extends Object
implements MeasurementResultAnalyser, BlackboardStorer<HashMap<MeasurableSeffElement,Integer>>

This implementation of MeasurementResultAnalyser will contribute with static created ProposedExpressions. It will take all SeffElements and use respectively all their MeasurementResults on the Blackboard and calculate thereby an expression that fits best to the average expectancy value. Its implementation of canContribute(ReadOnlyMeasurementResultAnalyserBlackboardView) checks if there are any MeasurementResults for a SeffElement, that have not been flown into the average proposed Expression so far.

Constructor Summary

Constructors

Constructor and Description
MeasurementResultAnalyserAverage()

Method Summary

Modifier and Type	Method and Description
boolean	canContribute(ReadOnlyMeasurementResultAnalyserBlackboardView blackboard) Determines whether this analyser can potentially contribute knowledge in the moment.
void	contribute(MeasurementResultAnalyserBlackboardView blackboard) Contributes this analyser’s knowledge to the passed blackboard.

Methods inherited from class java.lang.Object

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

Constructor Detail

MeasurementResultAnalyserAverage

public MeasurementResultAnalyserAverage()

Method Detail

canContribute

public boolean canContribute(ReadOnlyMeasurementResultAnalyserBlackboardView blackboard)

Description copied from interface: MeasurementResultAnalyser

Determines whether this analyser can potentially contribute knowledge in the moment. If true is returned, the analyser can potentially contribute, but might still be unable to generate meaningful results when being executed. If false is returned, calling MeasurementResultAnalyser.contribute(de.uka.ipd.sdq.beagle.core.analysis.MeasurementResultAnalyserBlackboardView) will not yield any new results. Calling this method has no implications on whether or when MeasurementResultAnalyser.contribute(de.uka.ipd.sdq.beagle.core.analysis.MeasurementResultAnalyserBlackboardView) will be called. Passing a blackboard that was last modified by this analyser’s MeasurementResultAnalyser.contribute(de.uka.ipd.sdq.beagle.core.analysis.MeasurementResultAnalyserBlackboardView) must always result in false .

This method must behave entirely stateless, meaning that its result do not depend on any prior calls to any method but only on the passed blackboard. Furthermore, calls with equal blackboard contents must always result in the same value.

Specified by:

canContribute in interface MeasurementResultAnalyser

Parameters:

blackboard - The current blackboard.

Returns:

true only if MeasurementResultAnalyser.contribute(de.uka.ipd.sdq.beagle.core.analysis.MeasurementResultAnalyserBlackboardView) may be called.

contribute

public void contribute(MeasurementResultAnalyserBlackboardView blackboard)

Description copied from interface: MeasurementResultAnalyser

Contributes this analyser’s knowledge to the passed blackboard.

Calling this method with a blackboard for which MeasurementResultAnalyser.canContribute(de.uka.ipd.sdq.beagle.core.analysis.ReadOnlyMeasurementResultAnalyserBlackboardView) returns false results in undefined behaviour. This method must

• behave entirely stateless, meaning that its result do not depend on any prior calls to any method (especially not MeasurementResultAnalyser.canContribute(de.uka.ipd.sdq.beagle.core.analysis.ReadOnlyMeasurementResultAnalyserBlackboardView)) but only on the passed blackboard.
• store all its results on the passed blackboard.
• assure that if MeasurementResultAnalyser.canContribute(de.uka.ipd.sdq.beagle.core.analysis.ReadOnlyMeasurementResultAnalyserBlackboardView) is called with the blackboard like its left by this method, it will return false.

Implementing BlackboardStorer and using Blackboard.writeFor(Class, java.io.Serializable) is, if needed, the recommended way to achieve the behaviour described above.

Specified by:

contribute in interface MeasurementResultAnalyser

Parameters:

blackboard - The current blackboard.