de.uni_hildesheim.sse.monitoring.runtime.recordingStrategies

Class MultipleRecorderElement

java.lang.Object

de.uni_hildesheim.sse.monitoring.runtime.recordingStrategies.RecorderElement

de.uni_hildesheim.sse.monitoring.runtime.recordingStrategies.AbstractMultipleRecorderElement

de.uni_hildesheim.sse.monitoring.runtime.recordingStrategies.MultipleRecorderElement

All Implemented Interfaces:

IMonitoringGroup

public class MultipleRecorderElement
extends AbstractMultipleRecorderElement

Defines a recording element which represents multiple recorder elements by delegating to stored monitoring groups. This class has a different semantics than a ContributingRecorderElement because it passes the same recorded value to all represented recorder elements.

Since:

1.00

Version:

1.00

Author:

Holger Eichelberger

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	elementResources Consider the individual accountable resources of the stored elements in addition to those configured for this group (true) or this group only (false).

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MultipleRecorderElement(MonitoringGroupConfiguration conf, RecorderElement[] elements, boolean distributeValues, boolean elementResources) Creates a recorder element.

Method Summary

Modifier and Type	Method and Description
protected boolean	enableRecording(RecorderElement elt, ResourceType resource) Returns whether the given element should record the specified resource.
RecorderElement	getContributing(int index) Returns a contributing recording element, i.e. one of the elements assigned to individual variants in a variability configuration.
(package private) RecorderElement	getContributing(int index, RecorderElementFactory factory, int max) Returns the currently relevant recorder element (in case that multiple subelements are supported).
int	getContributingSize() Returns the number of contributing recording elements, i.e. the elements recording individual variants in a variability configuration.
boolean	hasDebugStates(DebugState state) Returns if this instance has the given state selected.
boolean	isVisible() Returns whether this element is a pseudo element and should not be visible to the user.

Methods inherited from class de.uni_hildesheim.sse.monitoring.runtime.recordingStrategies.AbstractMultipleRecorderElement

addNetBytes, copy, countAccountable, distributeIntValue, distributeLongValue, ensureSize, firstElement, getCpuTimeTicks, getElement, getElementCount, getFileIn, getFileOut, getIoRead, getIoWrite, getMemAllocated, getMemUse, getNetIn, getNetOut, getStartCpuTime, getStartSystemTime, getSystemTimeTicks, hasElement, memoryAllocated, memoryFreed, readIo, setCpuTimeTicks, setElement, startTimeRecording, stopTimeRecording, timeCorrection, updateMemoryFreedFromJvm, wasRecorded, writeIo

Methods inherited from class de.uni_hildesheim.sse.monitoring.runtime.recordingStrategies.RecorderElement

accountResource, checkConf, createForTest, getConfiguration, getGroupAccounting, getInstanceRecorderElement, getResources, getVarId, instanceRecorderElements, instanceRecorderIds, isIndirectAccounting, setVarId

Methods inherited from class java.lang.Object

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

Field Detail

elementResources

private boolean elementResources

Consider the individual accountable resources of the stored elements in addition to those configured for this group (true) or this group only (false).

Constructor Detail

MultipleRecorderElement

protected MultipleRecorderElement(MonitoringGroupConfiguration conf,
                                  RecorderElement[] elements,
                                  boolean distributeValues,
                                  boolean elementResources)

Creates a recorder element.

Parameters:

conf - the monitoring group configuration

elements - the set of elements to be stored

distributeValues - account the fraction of the values according to the accountable elements or the entire value (indirect)

elementResources - consider the individual accountable resources of the stored elements in addition to those configured for this group (true) or this group only (false)

Since:

1.00

Method Detail

hasDebugStates

public boolean hasDebugStates(DebugState state)

Returns if this instance has the given state selected.

Overrides:

hasDebugStates in class RecorderElement

Parameters:

state - the state to be tested

Returns:

true if the state is selected, false else

getContributing

RecorderElement getContributing(int index,
                                RecorderElementFactory factory,
                                int max)

Returns the currently relevant recorder element (in case that multiple subelements are supported).

Specified by:

getContributing in class RecorderElement

Parameters:

index - the index of the sub element

factory - a factory to create new elements if needed

max - the (current) number of maximum required subelements ( variabilities)

Returns:

the subelement or this instance

Since:

1.00

getContributing

public RecorderElement getContributing(int index)

Returns a contributing recording element, i.e. one of the elements assigned to individual variants in a variability configuration.

Specified by:

getContributing in class RecorderElement

Parameters:

index - the element to be returned

Returns:

the element assigned to the given index (always this)

Throws:

java.lang.ArrayIndexOutOfBoundsException - if index<0 || index>=getContributingSize()

Since:

1.00

getContributingSize

public int getContributingSize()

Returns the number of contributing recording elements, i.e. the elements recording individual variants in a variability configuration.

Specified by:

getContributingSize in class RecorderElement

Returns:

the number of contributing recording elements (always 0)

Since:

1.00

isVisible

public boolean isVisible()

Returns whether this element is a pseudo element and should not be visible to the user.

Overrides:

isVisible in class RecorderElement

Returns:

true if this element is visible, false else

Since:

1.00

enableRecording

protected boolean enableRecording(RecorderElement elt,
                                  ResourceType resource)

Returns whether the given element should record the specified resource.

Specified by:

enableRecording in class AbstractMultipleRecorderElement

Parameters:

elt - the element to be considered

resource - the resource to be tested

Returns:

true if recording should be done, false else

Since:

1.00