Package net.ssehub.easy.varModel.model

Class AttributeAssignment

java.lang.Object

net.ssehub.easy.varModel.model.ModelElement

net.ssehub.easy.varModel.model.ContainableModelElement

net.ssehub.easy.varModel.model.AttributeAssignment

All Implemented Interfaces:

IContainableElementsSorter, IDatatypeVisitable, IDecisionVariableContainer, IModelElement

public class AttributeAssignment
extends ContainableModelElement
implements IDecisionVariableContainer

Represents an assignment of a value to attributes of at least one model element. So far we refrained from defining (multiple) recursive iterators (over the assignments) due to different style and potential performance issues of the generic code.

Author:

Holger Eichelberger

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	AttributeAssignment.Assignment	Characterizes an attribute-value assignment.

Field Summary

Fields

Modifier and Type	Field	Description
private BasicDecisionVariableContainer	container
private java.util.List<AttributeAssignment.Assignment>	data

Constructor Summary

Constructors

Constructor	Description
AttributeAssignment()	Constructor for serialization.
AttributeAssignment(IModelElement parent)	Creates a new attribute assignment.

Method Summary

Modifier and Type	Method	Description
void	accept(IModelVisitor visitor)	Accept method for the visitor.
void	add(AttributeAssignment assignment)	Adds a nested assignment.
void	add(AttributeAssignment.Assignment assignment)	Adds an individual assignment.
void	add(Comment comment)	Adds a comment to the list of contained elements.
boolean	add(DecisionVariableDeclaration elem)	Method to add an object to the elements list of the project.
void	add(EvaluationBlock eval)	adds a nested evaluation block.
void	addConstraint(Constraint constraint, boolean internal)	Adds a constraint.
boolean	contains(DecisionVariableDeclaration var)	Returns whether this element contains var.
boolean	containsByName(java.lang.String name)	Returns whether this project contains an element and its name.
void	forceUpdate()	Forces the IDecisionVariableContainer to update cached lists of nested DecisionVariableDeclarations.
AttributeAssignment	getAssignment(int index)	Returns the assignment specified by index.
int	getAssignmentCount()	Returns the number of assignments.
AttributeAssignment.Assignment	getAssignmentData(int index)	Returns the specified assignment data instance.
int	getAssignmentDataCount()	Returns the number of assignment data instances (attribute-value combinations).
Constraint	getConstraint(int index)	Returns the specified contained constraint.
int	getConstraintsCount()	Returns the number of contained constraints.
DecisionVariableDeclaration	getDeclaration(int index)	Returns the specified DecisionVariableDeclaration.
int	getDeclarationCount()	Returns the number of all nested DecisionVariableDeclarations including nested DecisionVariableDeclarations of AttributeAssignments.
IModelElement	getEffectiveParent()	Returns the effective parent of this assignment, i.e., the containing compound or project.
DecisionVariableDeclaration	getElement(int index)	Returns the element specified by index.
DecisionVariableDeclaration	getElement(java.lang.String name)	Returns the element specified by name.
int	getElementCount()	Returns the number of elements.
ContainableModelElement	getModelElement(int index)	Returns a contained model element specified by index.
int	getModelElementCount()	Returns the number of contained elements.
Constraint	getRealizing(int index)	Returns the specified realizing constraint.
int	getRealizingCount()	Returns the number of realizing constraints.
boolean	isTransparent()	Returns whether this element is transparent regarding the naming hierarchy.
boolean	propagateAttribute(Attribute attribute)	Propagates an attribute application from the parent to this element or contained elements.
void	sortContainedElements(java.util.Comparator<ContainableModelElement> comp)	Sorts the contained elements (and creates the related datastructure if needed) according to the specified comparator.

Methods inherited from class net.ssehub.easy.varModel.model.ContainableModelElement

accept, getNameSpace, getParent, getProject, getQualifiedName, getTopLevelParent, isTopLevel, setParent

Methods inherited from class net.ssehub.easy.varModel.model.ModelElement

findAttribute, getComment, getName, getUniqueName, setComment, setName, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.ssehub.easy.varModel.model.IModelElement

getComment, getName, getNameSpace, getParent, getQualifiedName, getUniqueName, setComment

Field Detail

data

private java.util.List<AttributeAssignment.Assignment> data

container

private BasicDecisionVariableContainer container

Constructor Detail

AttributeAssignment

AttributeAssignment()

Constructor for serialization.

AttributeAssignment

public AttributeAssignment(IModelElement parent)

Creates a new attribute assignment.

Parameters:

parent - the model element, in which this specific one is embedded

Method Detail

accept

public void accept(IModelVisitor visitor)

Description copied from interface: IModelElement

Accept method for the visitor.

Specified by:

accept in interface IModelElement

Parameters:

visitor - The visitor, which should process this model element.

getEffectiveParent

public IModelElement getEffectiveParent()

Returns the effective parent of this assignment, i.e., the containing compound or project.

Returns:

the effective parent (null if there is none)

getAssignmentDataCount

public int getAssignmentDataCount()

Returns the number of assignment data instances (attribute-value combinations).

Returns:

the number of assignment instances

getAssignmentData

public AttributeAssignment.Assignment getAssignmentData(int index)

Returns the specified assignment data instance.

Parameters:

index - the index of the assignment to be returned

Returns:

the specified assignment

Throws:

java.lang.IndexOutOfBoundsException - if index < 0 || index >= getAssignmentCount()

add

public boolean add(DecisionVariableDeclaration elem)

Description copied from interface: IDecisionVariableContainer

Method to add an object to the elements list of the project.

Specified by:

add in interface IDecisionVariableContainer

Parameters:

elem - which should be added

Returns:

true if the addition was successful, false else due to duplicated variable declaration

add

public void add(AttributeAssignment.Assignment assignment)

Adds an individual assignment.

Parameters:

assignment - the assignment to be added

isTransparent

public boolean isTransparent()

Description copied from interface: IModelElement

Returns whether this element is transparent regarding the naming hierarchy.

Specified by:

isTransparent in interface IModelElement

Overrides:

isTransparent in class ModelElement

Returns:

true if it is transparent, false else

getElementCount

public int getElementCount()

Description copied from interface: IDecisionVariableContainer

Returns the number of elements.

Specified by:

getElementCount in interface IDecisionVariableContainer

Returns:

the number of elements

getElement

public DecisionVariableDeclaration getElement(java.lang.String name)

Description copied from interface: IDecisionVariableContainer

Returns the element specified by name.

Specified by:

getElement in interface IDecisionVariableContainer

Parameters:

name - the name of the element

Returns:

the element, null if none was found

contains

public boolean contains(DecisionVariableDeclaration var)

Description copied from interface: IDecisionVariableContainer

Returns whether this element contains var.

Specified by:

contains in interface IDecisionVariableContainer

Parameters:

var - the variable declaration to search for

Returns:

true if found, false else

getElement

public DecisionVariableDeclaration getElement(int index)

Description copied from interface: IDecisionVariableContainer

Returns the element specified by index.

Specified by:

getElement in interface IDecisionVariableContainer

Parameters:

index - a 0-based index specifying the element to be returned

Returns:

the element

getConstraintsCount

public int getConstraintsCount()

Description copied from interface: IDecisionVariableContainer

Returns the number of contained constraints.

Specified by:

getConstraintsCount in interface IDecisionVariableContainer

Returns:

the number of constraints

getConstraint

public Constraint getConstraint(int index)

Description copied from interface: IDecisionVariableContainer

Returns the specified contained constraint.

Specified by:

getConstraint in interface IDecisionVariableContainer

Parameters:

index - the index of the constraint to be returned

Returns:

the specified constraint

getRealizingCount

public int getRealizingCount()

Description copied from interface: IDecisionVariableContainer

Returns the number of realizing constraints. Please note that these constraints are derived and not originally specified in the input IVML model.

Specified by:

getRealizingCount in interface IDecisionVariableContainer

Returns:

the number of constraints

getRealizing

public Constraint getRealizing(int index)

Description copied from interface: IDecisionVariableContainer

Returns the specified realizing constraint. Please note that these constraints are derived and not originally specified in the input IVML model.

Specified by:

getRealizing in interface IDecisionVariableContainer

Parameters:

index - the index of the constraint to be returned

Returns:

the specified constraint

add

public void add(Comment comment)

Description copied from interface: IDecisionVariableContainer

Adds a comment to the list of contained elements.

Specified by:

add in interface IDecisionVariableContainer

Parameters:

comment - the comment to be added

add

public void add(AttributeAssignment assignment)

Description copied from interface: IDecisionVariableContainer

Adds a nested assignment.

Specified by:

add in interface IDecisionVariableContainer

Parameters:

assignment - the assignment which should be added

addConstraint

public void addConstraint(Constraint constraint,
                          boolean internal)

Description copied from interface: IDecisionVariableContainer

Adds a constraint.

Specified by:

addConstraint in interface IDecisionVariableContainer

Parameters:

constraint - the constraint to be added

internal - whether the constraint is internally created while building up the model (ignored)

getAssignmentCount

public int getAssignmentCount()

Description copied from interface: IDecisionVariableContainer

Returns the number of assignments.

Specified by:

getAssignmentCount in interface IDecisionVariableContainer

Returns:

the number of assignments

getAssignment

public AttributeAssignment getAssignment(int index)

Description copied from interface: IDecisionVariableContainer

Returns the assignment specified by index.

Specified by:

getAssignment in interface IDecisionVariableContainer

Parameters:

index - a 0-based index specifying the element to be returned

Returns:

the assignment

getModelElement

public ContainableModelElement getModelElement(int index)

Description copied from interface: IDecisionVariableContainer

Returns a contained model element specified by index. Please note that this method returns all contained model elements, i.e., decision variables and constraints and is intended to restore the input sequence correctly.

Specified by:

getModelElement in interface IDecisionVariableContainer

Parameters:

index - a 0-based index specifying the operation to be returned

Returns:

the contained element

getModelElementCount

public int getModelElementCount()

Description copied from interface: IDecisionVariableContainer

Returns the number of contained elements. Please note that this method refers to all contained model elements, i.e., decision variables and constraints and is intended to restore the input sequence correctly.

Specified by:

getModelElementCount in interface IDecisionVariableContainer

Returns:

the number of contained elements

sortContainedElements

public void sortContainedElements(java.util.Comparator<ContainableModelElement> comp)

Description copied from interface: IContainableElementsSorter

Sorts the contained elements (and creates the related datastructure if needed) according to the specified comparator. Please note the following requirements for applying this method:

• All Elements which were added before this operation must still be member of this project after executing this operation.
• Comments related to an element must occur before the element in the final sequence.

Specified by:

sortContainedElements in interface IContainableElementsSorter

Parameters:

comp - a comparator which fulfills the requirements above

propagateAttribute

public boolean propagateAttribute(Attribute attribute)

Description copied from interface: IModelElement

Propagates an attribute application from the parent to this element or contained elements. This may imply the creation of clones of the given attribute.

Specified by:

propagateAttribute in interface IModelElement

Overrides:

propagateAttribute in class ModelElement

Parameters:

attribute - the attribute to be propagated

Returns:

true if the operation was successful, false if the element is about being attributed multiple times with the same attribute

getDeclarationCount

public int getDeclarationCount()

Description copied from interface: IDecisionVariableContainer

Returns the number of all nested DecisionVariableDeclarations including nested DecisionVariableDeclarations of AttributeAssignments.

Specified by:

getDeclarationCount in interface IDecisionVariableContainer

Returns:

The number of all nested DecisionVariableDeclarations. This will be greater or equal to 0.

getDeclaration

public DecisionVariableDeclaration getDeclaration(int index)

Description copied from interface: IDecisionVariableContainer

Returns the specified DecisionVariableDeclaration.

Specified by:

getDeclaration in interface IDecisionVariableContainer

Parameters:

index - the index of the DecisionVariableDeclaration to be returned

Returns:

the specified DecisionVariableDeclaration

add

public void add(EvaluationBlock eval)

Description copied from interface: IDecisionVariableContainer

adds a nested evaluation block.

Specified by:

add in interface IDecisionVariableContainer

Parameters:

eval - the eval block

containsByName

public boolean containsByName(java.lang.String name)

Description copied from interface: IDecisionVariableContainer

Returns whether this project contains an element and its name.

Specified by:

containsByName in interface IDecisionVariableContainer

Parameters:

name - the name to search for

Returns:

true if this project contains the specified element, false else

forceUpdate

public void forceUpdate()

Description copied from interface: IDecisionVariableContainer

Forces the IDecisionVariableContainer to update cached lists of nested DecisionVariableDeclarations. This is only necessary if multiple IDecisionVariableContainer are nested into each other and only during incremental build up if an inner element is updated while already added to the outer element.

Specified by:

forceUpdate in interface IDecisionVariableContainer