gr.uoa.di.madgik.execution.plan.element
Class ParameterProcessingPlanElement

java.lang.Object
  gr.uoa.di.madgik.execution.plan.element.PlanElementBase
      gr.uoa.di.madgik.execution.plan.element.ParameterProcessingPlanElement

All Implemented Interfaces:

IPlanElement, Serializable, Observer

public class ParameterProcessingPlanElement
extends PlanElementBase
implements Serializable

This class acts as a processing step that takes place outside any other IPlanElement. The IParameter that are used to retrieve inputs or store outputs in other IPlanElements are usually used for on the fly processing of the inputs and outputs. Some values however may be needed more than once for multiple element. Some parameters may also have complex definitions and there may be an interest in simplifying the definition of a IPlanElement. This element is simply a placeholder for a number of IInputParameters. During execution, the Parameters are iterated and for each one IInputParameter.GetParameterValue(ExecutionHandle) is called. The return values are not used, so to be of value, each parameter registered with this element should be of filtering type with ParameterFilterBase extending filters that can store their outputs.

Author:

gpapanikos

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class gr.uoa.di.madgik.execution.plan.element.PlanElementBase

PlanElementBase.ClockType

Nested classes/interfaces inherited from interface gr.uoa.di.madgik.execution.plan.element.IPlanElement

IPlanElement.PlanElementType

Field Summary

List<IInputParameter>

Parameters The Parameters that are to be evaluated

Constructor Summary

ParameterProcessingPlanElement()

Method Summary

protected void	ExecuteExtender(ExecutionHandle Handle) Execute extender.
void	FromXML(Element XML) Populate the element from its xml serialization as returned by IPlanElement.ToXML()
void	FromXML(String XML) Populate the element from its xml serialization as returned by IPlanElement.ToXML()
List<ContingencyTrigger>	GetContingencyTriggers() Gets the contingency triggers.
protected org.slf4j.Logger	GetExtenderLogger() Gets the extender logger.
String	GetID() Gets the id.
Set<String>	GetModifiedVariableNames() Gets the modified variable names of the element and of the elements contained.
String	GetName() Gets the name.
Set<String>	GetNeededVariableNames() Gets the needed variable names of the element and of the elements contained.
IPlanElement.PlanElementType	GetPlanElementType() Gets the plan element type.
IPlanElement	Locate(String ID) Locate the plan element with the provided id.
Set<IPlanElement>	LocateActionElements() Retrieves the Action elements under this elements
void	SetContingencyResourcePick(ExecutionHandle Handle, String Pick) Sets the picked resource in case the IContingencyReaction.ReactionType#Pick reaction is supported
void	SetName(String Name) Sets the name.
IContingencyReaction.ReactionType[]	SupportedContingencyTriggers() Retrieves the supported contingency triggers.
boolean	SupportsContingencyTriggers() Checks if the element supports contingency triggers.
String	ToXML() Serialize to xml the element and all its contained elements
void	Validate() Validate the element and any sub element it contains
void	ValidatePreExecution(ExecutionHandle Handle) Validate the element and any sub element it contains before it is executed

Methods inherited from class gr.uoa.di.madgik.execution.plan.element.PlanElementBase

CheckStatus, Execute, ExecuteWithStateAwareness, GetPerformanceEvent, RegisterToRunningActionElementsRestriction, ResetClocks, StartClock, StopClock, UnregisterToRunningActionElementsRestriction, update

Methods inherited from class java.lang.Object

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

Field Detail

Parameters

public List<IInputParameter> Parameters

The Parameters that are to be evaluated

Constructor Detail

ParameterProcessingPlanElement

public ParameterProcessingPlanElement()

Method Detail

GetPlanElementType

public IPlanElement.PlanElementType GetPlanElementType()

Description copied from interface: IPlanElement

Gets the plan element type.

Specified by:

GetPlanElementType in interface IPlanElement

Returns:

the plan element type

Validate

public void Validate()
              throws ExecutionValidationException

Description copied from interface: IPlanElement

Validate the element and any sub element it contains

Specified by:

Validate in interface IPlanElement

Throws:

ExecutionValidationException - A validation error occurred

ValidatePreExecution

public void ValidatePreExecution(ExecutionHandle Handle)
                          throws ExecutionValidationException

Description copied from interface: IPlanElement

Validate the element and any sub element it contains before it is executed

Specified by:

ValidatePreExecution in interface IPlanElement

Parameters:

Handle - the execution handle

Throws:

ExecutionValidationException - A validation error occurred

GetExtenderLogger

protected org.slf4j.Logger GetExtenderLogger()

Description copied from class: PlanElementBase

Gets the extender logger.

Specified by:

GetExtenderLogger in class PlanElementBase

Returns:

the logger

ToXML

public String ToXML()
             throws ExecutionSerializationException

Description copied from interface: IPlanElement

Serialize to xml the element and all its contained elements

Specified by:

ToXML in interface IPlanElement

Returns:

the serialization

Throws:

ExecutionSerializationException - A serialization error occurred

FromXML

public void FromXML(String XML)
             throws ExecutionSerializationException

Description copied from interface: IPlanElement

Populate the element from its xml serialization as returned by IPlanElement.ToXML()

Specified by:

FromXML in interface IPlanElement

Parameters:

XML - the xML serialization

Throws:

ExecutionSerializationException - A serialization error occurred

FromXML

public void FromXML(Element XML)
             throws ExecutionSerializationException

Description copied from interface: IPlanElement

Populate the element from its xml serialization as returned by IPlanElement.ToXML()

Specified by:

FromXML in interface IPlanElement

Parameters:

XML - the xML serialization

Throws:

ExecutionSerializationException - A serialization error occurred

GetID

public String GetID()

Description copied from interface: IPlanElement

Gets the id.

Specified by:

GetID in interface IPlanElement

Returns:

the id of the element

GetName

public String GetName()

Description copied from interface: IPlanElement

Gets the name.

Specified by:

GetName in interface IPlanElement

Returns:

the name

SetName

public void SetName(String Name)

Description copied from interface: IPlanElement

Sets the name.

Specified by:

SetName in interface IPlanElement

Parameters:

Name - the name

Locate

public IPlanElement Locate(String ID)

Description copied from interface: IPlanElement

Locate the plan element with the provided id. If this is the element requested return this instance. Otherwise forward the request to any sub elements contained. If the element does not belong to the hierarchy under this element, return null

Specified by:

Locate in interface IPlanElement

Parameters:

ID - the iD

Returns:

the plan element with the provided id. or null if not found

LocateActionElements

public Set<IPlanElement> LocateActionElements()

Description copied from interface: IPlanElement

Retrieves the Action elements under this elements

Specified by:

LocateActionElements in interface IPlanElement

Returns:

The action ELements

GetNeededVariableNames

public Set<String> GetNeededVariableNames()

Description copied from interface: IPlanElement

Gets the needed variable names of the element and of the elements contained. These include the variables that are needed to be present for the element and its hierarchy to be executed.

Specified by:

GetNeededVariableNames in interface IPlanElement

Returns:

the set of the variable names that are needed by this element and its contained elements

GetModifiedVariableNames

public Set<String> GetModifiedVariableNames()

Description copied from interface: IPlanElement

Gets the modified variable names of the element and of the elements contained. These include the variables that are modified by the element and its hierarchy when executed.

Specified by:

GetModifiedVariableNames in interface IPlanElement

Returns:

the set of the variable names that are modified by this element and its contained elements

GetContingencyTriggers

public List<ContingencyTrigger> GetContingencyTriggers()

Description copied from interface: IPlanElement

Gets the contingency triggers.

Specified by:

GetContingencyTriggers in interface IPlanElement

Returns:

the list of contingency trigger that are applicable to the element.

SupportedContingencyTriggers

public IContingencyReaction.ReactionType[] SupportedContingencyTriggers()

Description copied from interface: IPlanElement

Retrieves the supported contingency triggers.

Specified by:

SupportedContingencyTriggers in interface IPlanElement

Returns:

the supported contingency triggers types.

SupportsContingencyTriggers

public boolean SupportsContingencyTriggers()

Description copied from interface: IPlanElement

Checks if the element supports contingency triggers.

Specified by:

SupportsContingencyTriggers in interface IPlanElement

Returns:

true, if it does

SetContingencyResourcePick

public void SetContingencyResourcePick(ExecutionHandle Handle,
                                       String Pick)
                                throws ExecutionRunTimeException

Description copied from interface: IPlanElement

Sets the picked resource in case the IContingencyReaction.ReactionType#Pick reaction is supported

Specified by:

SetContingencyResourcePick in interface IPlanElement

Parameters:

Handle - the execution handle handle

Pick - the picked resource

Throws:

ExecutionRunTimeException - A runtime error occurred

ExecuteExtender

protected void ExecuteExtender(ExecutionHandle Handle)
                        throws ExecutionRunTimeException,
                               ExecutionInternalErrorException,
                               ExecutionCancelException,
                               ExecutionBreakException

Description copied from class: PlanElementBase

Execute extender. This class is implemented by extenders of the class

Specified by:

ExecuteExtender in class PlanElementBase

Parameters:

Handle - the execution handle

Throws:

ExecutionRunTimeException - A runtime error occurred

ExecutionInternalErrorException - An internal error occurred

ExecutionCancelException - The execution was canceled

ExecutionBreakException - The execution was terminated