Singleton node and Non-singleton nodes:
Cardinality Property:
The Cardinality property is composed of a pair of values that controls the maximum and minimum number of elements - 0...1: Zero or one
- 0...n: Zero or More
- 1...1 One and only One
- 1...n: One or More.
may contain at runtime.
The Cardinality property may have four possible values:
The first part of the cardinality describes the minimum number of elements that 's
Element collection may contain. This value is either Zero or One, and is stored as a Boolean value. This value can be obtained at runtime by calling the method
Node .getNodeInfo ().is Mandatory ().
The Second part of the cardinality describes the maximum number elements that 's element collection may contain. This value is either a '1' or an 'n'(meaning any) and is stored as a Boolean value (false = 1,true = n).
This value can be obtained at runtime by calling method node
.getNodeInfo ().is Multiple().
If has a cardinality of 1..<something>, then it can be assumed that after the context has been initialized, there will be at least one element present in the node collection. This element is known as default element and cannot be deleted.
If you attempt to perform some action on a node that would violate the constraints of the cardinality, then you will get a runtime exception in the context e.g., trying to add a second element to a node of cardinality 0..1 or trying to delete the last element from a node of cardinality 1..n.
Singleton Property:
The Singleton property critically affects the relationship between the child node and its parent node .
If is declared at design time, the generated interface for this node will vary depending on whether it is a Singleton or Non-Singleton node.
There is one to one relationship between each element in the parent node's element collection and the corresponding child node.
If has n elements in its element collection then you will have 'n' distinct instances of the non-singleton child node .
Non-Singleton child node can be created by their respective parent element.
Singleton child nodes however are associated with their parent node on a per node basis.
Irrespective of the number of elements in the parent node's element collection, there will only ever be one instance of the singleton child node .
The Singleton child node holds the data relevant for the element at the lead selection in the parent node's element collection.
Singleton child nodes must be created by their parent node. Since there can only ever one instance of singleton child node. It is impossible for an element in a parent node collection to create singleton child node.
Since the context root node always has exactly one element, all the nodes that have the context root node as their immediate parent must, by definition be singleton nodes.
Further to this, the definition of a Singleton child node immediately implies that it must be repopulated every time the lead selection in its parent node changes. This job is performed by declaring a Supply Function for the singleton child node.
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.