de.uni_hildesheim.sse.monitoring.runtime.recordingStrategies

Class AbstractRecorderStrategy

java.lang.Object

de.uni_hildesheim.sse.monitoring.runtime.recordingStrategies.AbstractRecorderStrategy

All Implemented Interfaces:

RecorderStrategy

Direct Known Subclasses:

AbstractEventRecorderStrategy, DefaultRecorderStrategy

public abstract class AbstractRecorderStrategy
extends java.lang.Object
implements RecorderStrategy

Defines a basic recorder strategy implementing common parts.

Since:

1.00

Version:

1.00

Author:

Holger Eichelberger

Field Summary

Fields

Modifier and Type	Field and Description
private StrategyStorage	storage Stores the strategy storage.

Fields inherited from interface de.uni_hildesheim.sse.monitoring.runtime.recordingStrategies.RecorderStrategy

REGISTER_END, REGISTER_FORCE

Constructor Summary

Constructors

Constructor and Description
AbstractRecorderStrategy(StrategyStorage storage) Creates a new recorder strategy.

Method Summary

Modifier and Type	Method and Description
void	enableVariabilityDetection(boolean enable) Enables or disables automatic variability detection.
protected RecorderElement	getRecorderElement(java.lang.String id) Returns the recorder element for the given recording group id.
RecorderElementMap	getRecorderElements() Returns the set of recorder elements used by this strategy.
java.lang.String	getRecorderId(java.lang.String className) Maps a class name to its recorder id (called in this interface usually recId).
StrategyStorage	getStorage() Returns the attached storage.
char	getVariabilitySeparatorChar() Returns the char used for separating the variability id and its current value (in configurations).
boolean	isVariabilityDetectionEnabled() Returns if automatic variability detection is enabled.
void	registerForRecording(java.lang.String className, java.lang.String recId, MonitoringGroupConfiguration conf, MonitoringGroupSettings settings) Registers a given class for recording.

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.uni_hildesheim.sse.monitoring.runtime.recordingStrategies.RecorderStrategy

assignAllTo, clearTemporaryData, endSystem, enter, enterConfiguration, exit, finishRecording, memoryAllocated, memoryFreedByRecId, notifyProgramRecordCreation, notifyTimer, notifyValueChange, printCurrentState, printStatistics, readIo, register, startRecording, stopTimeRecording, writeIo

Field Detail

storage

private StrategyStorage storage

Stores the strategy storage.

Constructor Detail

AbstractRecorderStrategy

public AbstractRecorderStrategy(StrategyStorage storage)

Creates a new recorder strategy.

Parameters:

storage - the storage object

Since:

1.00

Method Detail

getRecorderElements

public RecorderElementMap getRecorderElements()

Returns the set of recorder elements used by this strategy.

Returns:

the recorder elements (map)

Since:

1.00

getRecorderId

public java.lang.String getRecorderId(java.lang.String className)

Maps a class name to its recorder id (called in this interface usually recId).

Specified by:

getRecorderId in interface RecorderStrategy

Parameters:

className - the class name to be mapped

Returns:

the recorder id of className

Since:

1.00

getVariabilitySeparatorChar

public char getVariabilitySeparatorChar()

Returns the char used for separating the variability id and its current value (in configurations).

Specified by:

getVariabilitySeparatorChar in interface RecorderStrategy

Returns:

the separator char

Since:

1.00

registerForRecording

public void registerForRecording(java.lang.String className,
                                 java.lang.String recId,
                                 MonitoringGroupConfiguration conf,
                                 MonitoringGroupSettings settings)

Registers a given class for recording. Optional, a (group) id might be specified to which the measurements are assigned to. Ids are unique strings without inherent semantics. If not given, the className is used for grouping and assigning measurements (implicit 1-groups).

Specified by:

registerForRecording in interface RecorderStrategy

Parameters:

className - the name of the class measurements should be registered for

recId - an optional group identification (may be empty or null)

conf - additional configuration for the monitoring group derived from settings

settings - the monitoring group settings including all configuration information (reference should not be stored, will be freed explicitly)

Since:

1.00

enableVariabilityDetection

public void enableVariabilityDetection(boolean enable)

Enables or disables automatic variability detection.

Specified by:

enableVariabilityDetection in interface RecorderStrategy

Parameters:

enable - true if variability detection should be enabled, false else

Since:

1.00

isVariabilityDetectionEnabled

public boolean isVariabilityDetectionEnabled()

Returns if automatic variability detection is enabled.

Specified by:

isVariabilityDetectionEnabled in interface RecorderStrategy

Returns:

true if variability detection should be enabled, false else

Since:

1.00

getRecorderElement

protected final RecorderElement getRecorderElement(java.lang.String id)

Returns the recorder element for the given recording group id.

Parameters:

id - the group identification

Returns:

the recorder element or null

Since:

1.00

getStorage

public StrategyStorage getStorage()

Returns the attached storage.

Specified by:

getStorage in interface RecorderStrategy

Returns:

the attached storage

Since:

1.00