Package org.bigraphs.framework.core.impl.pure

Class PureBigraphBuilder<S extends AbstractEcoreSignature<? extends Control<?,?>>>

java.lang.Object

org.bigraphs.framework.core.BigraphBuilderSupport<S>

org.bigraphs.framework.core.impl.pure.PureBigraphBuilder<S>

All Implemented Interfaces:

BigraphBuilder<S>

Direct Known Subclasses:

KindBigraphBuilder, MutableBuilder

public class PureBigraphBuilder<S extends AbstractEcoreSignature<? extends Control<?,?>>>
extends BigraphBuilderSupport<S>

Concrete BigraphBuilder implementation for pure bigraphs.

Typical usage begins with root() and proceeds by creating children, hierarchies, and sites.

For compositions, see PureBigraphComposite, accessible with BigraphFactory.ops(Bigraph).

Author:

Dominik Grzelak

See Also:

• Getting Started: Creating a Bigraph

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	PureBigraphBuilder.Hierarchy	A bigraph consists of many node hierarchy.

Nested classes/interfaces inherited from class org.bigraphs.framework.core.BigraphBuilderSupport

BigraphBuilderSupport.InstanceParameter

Nested classes/interfaces inherited from interface org.bigraphs.framework.core.BigraphBuilder

BigraphBuilder.NodeHierarchy<S extends Signature<? extends Control<?,?>>>

Field Summary

Fields

Modifier and Type	Field	Description
protected final Map<String,BigraphEntity.Edge>	availableEdges
protected final Map<String,BigraphEntity.InnerName>	availableInnerNames
protected final Map<String,BigraphEntity.NodeEntity>	availableNodes
protected final Map<String,BigraphEntity.OuterName>	availableOuterNames
protected final Map<Integer,BigraphEntity.RootEntity>	availableRoots
protected final Map<Integer,BigraphEntity.SiteEntity>	availableSites
protected org.eclipse.emf.ecore.EObject	loadedInstanceModel
protected org.eclipse.emf.ecore.EPackage	metaModel

Fields inherited from class org.bigraphs.framework.core.BigraphBuilderSupport

DEFAULT_EDGE_PREFIX, DEFAULT_VERTEX_PREFIX

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	PureBigraphBuilder(org.eclipse.emf.ecore.EObject signatureMetaModel)
protected	PureBigraphBuilder(org.eclipse.emf.ecore.EObject signatureInstanceModel, String metaModelFilePath)
protected	PureBigraphBuilder(org.eclipse.emf.ecore.EObject signatureInstanceModel, String metaModelFilePath, String instanceModelFilePath)
protected	PureBigraphBuilder(org.eclipse.emf.ecore.EObject signatureMetaModel, EMetaModelData metaModelData)
protected	PureBigraphBuilder(org.eclipse.emf.ecore.EObject signatureMetaModel, org.eclipse.emf.ecore.EPackage metaModel, org.eclipse.emf.ecore.EObject instanceModel)
protected	PureBigraphBuilder(S signature)
protected	PureBigraphBuilder(S signature, String metaModelFilePath)
protected	PureBigraphBuilder(S signature, String metaModelFilePath, String instanceModelFilePath)
protected	PureBigraphBuilder(S signature, EMetaModelData metaModelData)
protected	PureBigraphBuilder(S signature, org.eclipse.emf.ecore.EPackage metaModel, String instanceModelFilePath)
protected	PureBigraphBuilder(S signature, org.eclipse.emf.ecore.EPackage metaModel, org.eclipse.emf.ecore.EObject instanceModel)

Method Summary

Modifier and Type	Method	Description
void	addInnerTo(BigraphEntity.InnerName innerName, BigraphEntity.InnerName toAttach)	Connects the inner name toAttach to innerName via a link (i.e., an edge or outer name).
void	checkIfNodeIsConnectable(BigraphEntity.NodeEntity<Control> node)	Checks whether a node's ports can be connected to a link (i.e., an edge or an outer name which in turn also includes inner names).
protected void	clearIntermediateResults()	Clears all generated intermediate results of the bigraph's current construction inside the builder.
PureBigraphBuilder<S>	closeInner()	Closes all inner names and doesn't keep idle edges and idle inner names.
void	closeInner(String innerName, boolean keepIdleName)	Convenient method for closeInner(BigraphEntity.InnerName, boolean)
void	closeInner(BigraphEntity.InnerName innerName)	Convenient method for closeInner(BigraphEntity.InnerName, boolean).
void	closeInner(BigraphEntity.InnerName... innerName)
void	closeInner(BigraphEntity.InnerName innerName, boolean keepIdleName)
PureBigraphBuilder<S>	closeOuter()	Closes all outer names.
void	closeOuter(String outerName, boolean keepIdleName)	Convenient method for closeOuter(BigraphEntity.OuterName, boolean)
void	closeOuter(BigraphEntity.OuterName outerName)	Closes the outer name by removing all connections and the outer name itself.
void	closeOuter(BigraphEntity.OuterName outerName, boolean keepIdleName)	If an inner name is connected to an outer name, the inner name will remain (i.e., not be removed).
protected BigraphEntity.Edge	connectByEdge(BigraphEntity.NodeEntity<Control>... nodes)
protected void	connectInnerToLink(BigraphEntity.InnerName innerName, BigraphEntity.Link edge)
protected void	connectNodeToOuterName(BigraphEntity.NodeEntity<Control> node1, BigraphEntity.OuterName outerName)	Helper method to connect a node to an outer name.
protected void	connectToEdge(BigraphEntity.NodeEntity<Control> node, BigraphEntity.Edge edge)	no checks are done here... use isConnectedWithLink(BigraphEntity.NodeEntity, EObject)
protected void	connectToLinkUsingIndex(BigraphEntity.NodeEntity<Control> node, BigraphEntity theLink, int customPortIndex)
PureBigraph	create()
static <S extends AbstractEcoreSignature<? extends Control<?, ?>>> PureBigraphBuilder<S>	create(@NonNull S signature)	Should not be directly called by the user.
static <S extends AbstractEcoreSignature<? extends Control<?, ?>>> PureBigraphBuilder<S>	create(@NonNull S signature, String metaModelFileName)
static <S extends AbstractEcoreSignature<? extends Control<?, ?>>> PureBigraphBuilder<S>	create(@NonNull S signature, String metaModelFilePath, String instanceModelFilePath)	Should not be directly called by the user.
static <S extends AbstractEcoreSignature<? extends Control<?, ?>>> PureBigraphBuilder<S>	create(@NonNull S signature, EMetaModelData metaModelData)	Should not be directly called by the user.
static <S extends AbstractEcoreSignature<? extends Control<?, ?>>> PureBigraphBuilder<S>	create(@NonNull S signature, @NonNull org.eclipse.emf.ecore.EPackage bigraphMetaModel, String instanceModelFilePath)
static <S extends AbstractEcoreSignature<? extends Control<?, ?>>> PureBigraphBuilder<S>	create(@NonNull S signature, org.eclipse.emf.ecore.EPackage metaModel, org.eclipse.emf.ecore.EObject instanceModel)
static <S extends AbstractEcoreSignature<? extends Control<?, ?>>> PureBigraphBuilder<S>	create(@NonNull org.eclipse.emf.ecore.EObject signatureInstance)
static <S extends AbstractEcoreSignature<? extends Control<?, ?>>> PureBigraphBuilder<S>	create(@NonNull org.eclipse.emf.ecore.EObject signatureInstance, String metaModelFileName)
static <S extends AbstractEcoreSignature<? extends Control<?, ?>>> PureBigraphBuilder<S>	create(@NonNull org.eclipse.emf.ecore.EObject signatureInstance, String metaModelFilePath, String instanceModelFilePath)
static <S extends AbstractEcoreSignature<? extends Control<?, ?>>> PureBigraphBuilder<S>	create(@NonNull org.eclipse.emf.ecore.EObject signatureInstance, EMetaModelData metaModelData)
static <S extends AbstractEcoreSignature<? extends Control<?, ?>>> PureBigraphBuilder<S>	create(@NonNull org.eclipse.emf.ecore.EObject signatureInstance, org.eclipse.emf.ecore.EPackage metaModel, org.eclipse.emf.ecore.EObject instanceModel)
protected BigraphEntity.Edge	createEdgeOfEClass()	Creates an edge of EClass BEdge and adds it to the list of available edges availableEdges.
protected BigraphEntity.Edge	createEdgeOfEClass(org.eclipse.emf.ecore.EObject eObject)
protected org.eclipse.emf.ecore.EObject	createEdgeOfEClass0(String edgeName)
BigraphEntity.InnerName	createInner(String name)	Returns the same inner name if it already exists under the same name
protected org.eclipse.emf.ecore.EObject	createInnerNameOfEClass(String name)
protected org.eclipse.emf.ecore.EObject	createNodeOfEClass(String name, @NonNull Control control)
protected org.eclipse.emf.ecore.EObject	createNodeOfEClass(String name, @NonNull Control control, String nodeIdentifier)
BigraphEntity.OuterName	createOuter(String name)	This method returns the same outer name if it already exists under the same name, otherwise it will be created and returned.
protected org.eclipse.emf.ecore.EObject	createOuterNameOfEClass(String name)
protected org.eclipse.emf.ecore.EObject	createPortWithIndex(int index)	Helper method that creates a bigraphical port EObject with the given index.
protected org.eclipse.emf.ecore.EObject	createRootOfEClass(int index)
protected org.eclipse.emf.ecore.EObject	createSiteOfEClass(int index)
protected Map<String,org.eclipse.emf.ecore.EClass>	getAvailableEClasses()
protected Map<String,org.eclipse.emf.ecore.EReference>	getAvailableEReferences()
protected org.eclipse.emf.ecore.EObject	getInstanceModel()
org.eclipse.emf.ecore.EPackage	getMetaModel()
PureBigraphBuilder<S>.Hierarchy	hierarchy(String controlLabel)
PureBigraphBuilder<S>.Hierarchy	hierarchy(Control control)	Creates a new independent hierarchy which can be added later.
protected boolean	isConnectedWithLink(BigraphEntity.NodeEntity<Control> place, @Nullable org.eclipse.emf.ecore.EObject theLink)	Helper method to check if a given node is connected to the given link.
PureBigraphBuilder<S>	linkInner(BigraphEntity.InnerName ecoreInnerName1, BigraphEntity.InnerName ecoreInnerName2)	Convenient method of linkInner(BigraphEntity.InnerName, BigraphEntity.InnerName, boolean) which doesn't keep idle edges when inner names are already connected to a node.
PureBigraphBuilder<S>	linkInner(BigraphEntity.InnerName ecoreInnerName1, BigraphEntity.InnerName ecoreInnerName2, boolean keepIdleEdges)	Connects two existing inner names by an edge.
PureBigraphBuilder<S>	linkInnerToOuter(BigraphEntity innerName, BigraphEntity outerName)	Connects an inner name to an outer name.
protected void	linkInnerToOuter0(BigraphEntity innerName, BigraphEntity outerName)	Ecore specific - only called by methods of this builder internally
void	linkNodeToInner(BigraphEntity.NodeEntity<Control> node1, BigraphEntity.InnerName innerName)	Link a node with an inner name by an edge
void	linkNodeToInner(BigraphEntity.NodeEntity<Control> node1, BigraphEntity.InnerName... innerNames)	Link multiple inner names by an edge to one node
protected void	loadSignatureMetaModel(String metaModelFilePath)	Does not re-create control nodes of type EClass because it directly uses the bigraphical Ecore metamodel.
void	makeGround()	Converts the current bigraph to a ground bigraph (i.e., no sites an no inner names).
PureBigraphBuilder<S>.Hierarchy	root()	Create a root node under which additional nodes or hierarchies can be place.
PureBigraphBuilder<S>	spawn()	Spawns a fresh bigraph builder but with exactly the same instance of the extended bigraph metamodel and signature as before.

Methods inherited from class org.bigraphs.framework.core.BigraphBuilderSupport

assertSortingIsEnsuredForControl, assertSortingIsEnsuredForControl, createBBigraphContainer, createIndexSupplier, createNameSupplier, executeValidationChain, getSignatureFromMetaModel, isEdge, isNode, isOuter, isRoot

Methods inherited from class java.lang.Object

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

Field Details

metaModel

protected org.eclipse.emf.ecore.EPackage metaModel

loadedInstanceModel

protected org.eclipse.emf.ecore.EObject loadedInstanceModel

availableEdges

protected final Map<String,BigraphEntity.Edge> availableEdges

availableOuterNames

protected final Map<String,BigraphEntity.OuterName> availableOuterNames

availableInnerNames

protected final Map<String,BigraphEntity.InnerName> availableInnerNames

availableRoots

protected final Map<Integer,BigraphEntity.RootEntity> availableRoots

availableSites

protected final Map<Integer,BigraphEntity.SiteEntity> availableSites

availableNodes

protected final Map<String,BigraphEntity.NodeEntity> availableNodes

Constructor Details

PureBigraphBuilder

protected PureBigraphBuilder(S signature)
                      throws BigraphMetaModelLoadingFailedException

Throws:

BigraphMetaModelLoadingFailedException

PureBigraphBuilder

protected PureBigraphBuilder(org.eclipse.emf.ecore.EObject signatureMetaModel)

Throws:

SignatureValidationFailedException - If the provided signature metamodel does not conform the the builders signature type S

PureBigraphBuilder

protected PureBigraphBuilder(S signature,
 EMetaModelData metaModelData)
                      throws BigraphMetaModelLoadingFailedException

Throws:

BigraphMetaModelLoadingFailedException - If the provided signature metamodel does not conform the the builders signature type S

PureBigraphBuilder

protected PureBigraphBuilder(org.eclipse.emf.ecore.EObject signatureMetaModel,
 EMetaModelData metaModelData)

Throws:

SignatureValidationFailedException - If the provided signature metamodel does not conform the the builders signature type S

PureBigraphBuilder

protected PureBigraphBuilder(S signature,
 org.eclipse.emf.ecore.EPackage metaModel,
 org.eclipse.emf.ecore.EObject instanceModel)

PureBigraphBuilder

protected PureBigraphBuilder(org.eclipse.emf.ecore.EObject signatureMetaModel,
 org.eclipse.emf.ecore.EPackage metaModel,
 org.eclipse.emf.ecore.EObject instanceModel)

Throws:

SignatureValidationFailedException - If the provided signature metamodel does not conform the the builders signature type S

PureBigraphBuilder

protected PureBigraphBuilder(S signature,
 String metaModelFilePath,
 String instanceModelFilePath)
                      throws BigraphMetaModelLoadingFailedException

Throws:

BigraphMetaModelLoadingFailedException - If the provided signature metamodel does not conform the the builders signature type S

PureBigraphBuilder

protected PureBigraphBuilder(S signature,
 org.eclipse.emf.ecore.EPackage metaModel,
 String instanceModelFilePath)
                      throws BigraphMetaModelLoadingFailedException

Throws:

BigraphMetaModelLoadingFailedException

PureBigraphBuilder

protected PureBigraphBuilder(org.eclipse.emf.ecore.EObject signatureInstanceModel,
 String metaModelFilePath,
 String instanceModelFilePath)

Throws:

SignatureValidationFailedException - If the provided signature instance model does not conform the the builders signature type S

PureBigraphBuilder

protected PureBigraphBuilder(S signature,
 String metaModelFilePath)
                      throws BigraphMetaModelLoadingFailedException

Throws:

BigraphMetaModelLoadingFailedException - If the provided signature instance model does not conform the the builders signature type S

PureBigraphBuilder

protected PureBigraphBuilder(org.eclipse.emf.ecore.EObject signatureInstanceModel,
 String metaModelFilePath)

Throws:

SignatureValidationFailedException - If the provided signature instance model does not conform the the builders signature type S

Method Details

spawn

public PureBigraphBuilder<S> spawn()

Description copied from interface: BigraphBuilder

Spawns a fresh bigraph builder but with exactly the same instance of the extended bigraph metamodel and signature as before.

Returns:

a fresn bigraph builder with the same bigraph metamodel and signature metamodel

create

public static <S extends AbstractEcoreSignature<? extends Control<?,
?>>>
PureBigraphBuilder<S> create(@NonNull S signature,
 String metaModelFilePath,
 String instanceModelFilePath)
                      throws BigraphMetaModelLoadingFailedException

Should not be directly called by the user. Instead use the AbstractBigraphFactory.

Type Parameters:

S - the type of the signature

Parameters:

signature - the signature for the builder and the generated bigraph

metaModelFilePath - the file to the Ecore meta model

instanceModelFilePath - file path to the instance model

Returns:

a configured builder with the bigraph instance loaded

Throws:

BigraphMetaModelLoadingFailedException - If the provided signature metamodel does not conform the the builders signature type S

create

public static <S extends AbstractEcoreSignature<? extends Control<?,
?>>>
PureBigraphBuilder<S> create(@NonNull org.eclipse.emf.ecore.EObject signatureInstance,
 String metaModelFilePath,
 String instanceModelFilePath)

Throws:

SignatureValidationFailedException - If the provided signature instance model does not conform the the builders signature type S

create

public static <S extends AbstractEcoreSignature<? extends Control<?,
?>>>
PureBigraphBuilder<S> create(@NonNull S signature,
 @NonNull org.eclipse.emf.ecore.EPackage bigraphMetaModel,
 String instanceModelFilePath)

create

public static <S extends AbstractEcoreSignature<? extends Control<?,
?>>>
PureBigraphBuilder<S> create(@NonNull S signature,
 org.eclipse.emf.ecore.EPackage metaModel,
 org.eclipse.emf.ecore.EObject instanceModel)
                      throws BigraphMetaModelLoadingFailedException

Throws:

BigraphMetaModelLoadingFailedException - If the provided bigraph metamodel could not be loaded

create

public static <S extends AbstractEcoreSignature<? extends Control<?,
?>>>
PureBigraphBuilder<S> create(@NonNull org.eclipse.emf.ecore.EObject signatureInstance,
 org.eclipse.emf.ecore.EPackage metaModel,
 org.eclipse.emf.ecore.EObject instanceModel)

Throws:

SignatureValidationFailedException - If the provided signature instance model does not conform the the builders signature type S

create

public static <S extends AbstractEcoreSignature<? extends Control<?,
?>>>
PureBigraphBuilder<S> create(@NonNull S signature)
                      throws BigraphMetaModelLoadingFailedException

Should not be directly called by the user. Instead use the AbstractBigraphFactory.

Type Parameters:

S - type of the signature

Parameters:

signature - the signature for the builder

Returns:

a pure bigraph builder with the given signature

Throws:

BigraphMetaModelLoadingFailedException - If the provided bigraph metamodel does not conform the the builders signature type S

create

public static <S extends AbstractEcoreSignature<? extends Control<?,
?>>>
PureBigraphBuilder<S> create(@NonNull org.eclipse.emf.ecore.EObject signatureInstance)
                      throws BigraphMetaModelLoadingFailedException

Throws:

SignatureValidationFailedException - If the provided signature instance model does not conform the the builders signature type S

BigraphMetaModelLoadingFailedException

create

public static <S extends AbstractEcoreSignature<? extends Control<?,
?>>>
PureBigraphBuilder<S> create(@NonNull S signature,
 EMetaModelData metaModelData)
                      throws BigraphMetaModelLoadingFailedException

Should not be directly called by the user. Instead use the AbstractBigraphFactory.

Type Parameters:

S - the type of the signature

Parameters:

signature - the signature for the builder and generated bigraph

metaModelData - the meta data to use for the model

Returns:

a pure bigraph builder over the given signature

Throws:

BigraphMetaModelLoadingFailedException - If the provided bigraph metamodel does not conform the the builders signature type S

create

public static <S extends AbstractEcoreSignature<? extends Control<?,
?>>>
PureBigraphBuilder<S> create(@NonNull org.eclipse.emf.ecore.EObject signatureInstance,
 EMetaModelData metaModelData)
                      throws BigraphMetaModelLoadingFailedException

Throws:

SignatureValidationFailedException - If the provided signature instance model does not conform the the builders signature type S

BigraphMetaModelLoadingFailedException

create

public static <S extends AbstractEcoreSignature<? extends Control<?,
?>>>
PureBigraphBuilder<S> create(@NonNull S signature,
 String metaModelFileName)
                      throws BigraphMetaModelLoadingFailedException

Throws:

BigraphMetaModelLoadingFailedException - If the provided bigraph metamodel does not conform the the builders signature type S

create

public static <S extends AbstractEcoreSignature<? extends Control<?,
?>>>
PureBigraphBuilder<S> create(@NonNull org.eclipse.emf.ecore.EObject signatureInstance,
 String metaModelFileName)
                      throws BigraphMetaModelLoadingFailedException

Throws:

SignatureValidationFailedException - If the provided signature instance model does not conform the the builders signature type S

BigraphMetaModelLoadingFailedException

getMetaModel

public org.eclipse.emf.ecore.EPackage getMetaModel()

Specified by:

getMetaModel in class BigraphBuilderSupport<S extends AbstractEcoreSignature<? extends Control<?,?>>>

getInstanceModel

protected org.eclipse.emf.ecore.EObject getInstanceModel()

Specified by:

getInstanceModel in class BigraphBuilderSupport<S extends AbstractEcoreSignature<? extends Control<?,?>>>

getAvailableEClasses

protected Map<String,org.eclipse.emf.ecore.EClass> getAvailableEClasses()

Specified by:

getAvailableEClasses in class BigraphBuilderSupport<S extends AbstractEcoreSignature<? extends Control<?,?>>>

getAvailableEReferences

protected Map<String,org.eclipse.emf.ecore.EReference> getAvailableEReferences()

Specified by:

getAvailableEReferences in class BigraphBuilderSupport<S extends AbstractEcoreSignature<? extends Control<?,?>>>

root

public PureBigraphBuilder<S>.Hierarchy root()

Description copied from interface: BigraphBuilder

Create a root node under which additional nodes or hierarchies can be place.

A hierarchy is returned which contains a collection of nodes in a tree structure. The hierarchy BigraphBuilder.NodeHierarchy provides additional methods for adding nodes and sites. The hierarchy can only be used with the BigraphBuilder which created it.

Returns:

a hierarchical tree structure

hierarchy

public PureBigraphBuilder<S>.Hierarchy hierarchy(Control control)

Creates a new independent hierarchy which can be added later.

Parameters:

control - the control of the parent for the new hierarchy

Returns:

a new hierarchy for the current bigraph

hierarchy

public PureBigraphBuilder<S>.Hierarchy hierarchy(String controlLabel)

createSiteOfEClass

protected org.eclipse.emf.ecore.EObject createSiteOfEClass(int index)

createRootOfEClass

protected org.eclipse.emf.ecore.EObject createRootOfEClass(int index)

createInnerNameOfEClass

protected org.eclipse.emf.ecore.EObject createInnerNameOfEClass(String name)

createOuterNameOfEClass

protected org.eclipse.emf.ecore.EObject createOuterNameOfEClass(String name)

createOuter

public BigraphEntity.OuterName createOuter(String name)

This method returns the same outer name if it already exists under the same name, otherwise it will be created and returned.

Parameters:

name - the name for the outer name

Returns:

a new outer name or an existing one with the same name

createInner

public BigraphEntity.InnerName createInner(String name)

Returns the same inner name if it already exists under the same name

Parameters:

name - the name for the inner name

Returns:

a new inner name or an existing one with the same name

connectToEdge

protected void connectToEdge(BigraphEntity.NodeEntity<Control> node,
 BigraphEntity.Edge edge)

no checks are done here... use isConnectedWithLink(BigraphEntity.NodeEntity, EObject)

Parameters:

node - the node to connect

edge - the edge to use to connect the node

See Also:

• isConnectedWithLink(BigraphEntity.NodeEntity, EObject)

connectInnerToLink

protected void connectInnerToLink(BigraphEntity.InnerName innerName,
 BigraphEntity.Link edge)

connectToLinkUsingIndex

protected void connectToLinkUsingIndex(BigraphEntity.NodeEntity<Control> node,
 BigraphEntity theLink,
 int customPortIndex)

connectByEdge

protected BigraphEntity.Edge connectByEdge(BigraphEntity.NodeEntity<Control>... nodes)
                                    throws InvalidArityOfControlException

Throws:

InvalidArityOfControlException

linkInnerToOuter

public PureBigraphBuilder<S> linkInnerToOuter(BigraphEntity innerName,
 BigraphEntity outerName)
                                       throws InvalidConnectionException

Connects an inner name to an outer name. The inner and outer name must be created with the same builder. If they are already connected or doesn't belong to the builder than this builder is simply returned without an error.

Parameters:

innerName - the inner name to be connected to the outer name

outerName - the outer name

Returns:

this builder instance

Throws:

InvalidConnectionException - link couldn't be established because of already existing connection of the provided links

linkInnerToOuter0

protected void linkInnerToOuter0(BigraphEntity innerName,
 BigraphEntity outerName)

Ecore specific - only called by methods of this builder internally

Parameters:

innerName - the inner name

outerName - the outer name

linkNodeToInner

public void linkNodeToInner(BigraphEntity.NodeEntity<Control> node1,
 BigraphEntity.InnerName innerName)
                     throws LinkTypeNotExistsException,
InvalidConnectionException

Link a node with an inner name by an edge

Parameters:

node1 - the node

innerName - the inner name

Throws:

LinkTypeNotExistsException - if the inner name doesn't exists (i.e., doesn't belong from this builder

InvalidArityOfControlException - if the control cannot connect anything (e.g., is atomic, or no open ports left)

InvalidConnectionException - if the inner name is already connected to an outer name

linkNodeToInner

public void linkNodeToInner(BigraphEntity.NodeEntity<Control> node1,
 BigraphEntity.InnerName... innerNames)
                     throws LinkTypeNotExistsException,
InvalidConnectionException

Link multiple inner names by an edge to one node

Old links of inner names (i.e., edges and outer names) are replaced by the freshly created edge.

Parameters:

node1 - the node

innerNames - the inner name

Throws:

LinkTypeNotExistsException - if the inner name doesn't exists (i.e., doesn't belong from this builder

InvalidArityOfControlException - if the control cannot connect anything (e.g., is atomic, or no open ports left)

InvalidConnectionException - if the inner name is already connected to an outer name

addInnerTo

public void addInnerTo(BigraphEntity.InnerName innerName,
 BigraphEntity.InnerName toAttach)
                throws LinkTypeNotExistsException,
InvalidConnectionException

Connects the inner name toAttach to innerName via a link (i.e., an edge or outer name). If innerName is already connected to a link, this link will be used for attaching toAttach. If no link is present for innerName, a new edge will be created.

Parameters:

innerName - the inner name that will be linked with toAttach via a new link, or an existing one

toAttach - the inner name that shall be linked with innerName via a new link, or an existing one from innerName

Throws:

LinkTypeNotExistsException

InvalidConnectionException

linkInner

public PureBigraphBuilder<S> linkInner(BigraphEntity.InnerName ecoreInnerName1,
 BigraphEntity.InnerName ecoreInnerName2)
                                throws InvalidConnectionException

Convenient method of linkInner(BigraphEntity.InnerName, BigraphEntity.InnerName, boolean) which doesn't keep idle edges when inner names are already connected to a node. Meaning, that the last argument defaults to false.

Parameters:

ecoreInnerName1 - an existing inner name

ecoreInnerName2 - an existing inner name

Returns:

the builder

Throws:

InvalidConnectionException - if the inner names could not be connected.

linkInner

public PureBigraphBuilder<S> linkInner(BigraphEntity.InnerName ecoreInnerName1,
 BigraphEntity.InnerName ecoreInnerName2,
 boolean keepIdleEdges)
                                throws InvalidConnectionException

Connects two existing inner names by an edge.

If they are already connected the class itself is returned.

The method will throw an exception if one of the given inner names are already connected to an outer name.

If they are already connected to another edge from a node than the parameter keepIdleEdges decides whether to keep the idle edges of the nodes when connecting the inner names or to remove them completely.

Parameters:

ecoreInnerName1 - an existing inner name

ecoreInnerName2 - an existing inner name

keepIdleEdges - flag to decide whether idle edges should remain

Returns:

the builder class

Throws:

InvalidConnectionException - if the inner name could not be connected

checkIfNodeIsConnectable

public void checkIfNodeIsConnectable(BigraphEntity.NodeEntity<Control> node)
                              throws InvalidArityOfControlException

Checks whether a node's ports can be connected to a link (i.e., an edge or an outer name which in turn also includes inner names).

The verification is based on the arity of the control and current connections made so far.

Parameters:

node - the node to check

Throws:

InvalidArityOfControlException - if control is atomic or the current connections exceed the control's arity

connectNodeToOuterName

protected void connectNodeToOuterName(BigraphEntity.NodeEntity<Control> node1,
 BigraphEntity.OuterName outerName)
                               throws TypeNotExistsException,
InvalidArityOfControlException

Helper method to connect a node to an outer name.

Parameters:

node1 - the node to connect

outerName - the outer name to which the node is connected

Throws:

LinkTypeNotExistsException - if the link is contained in the bigraph

InvalidArityOfControlException - if the node cannot connect links anymore

TypeNotExistsException

createPortWithIndex

protected org.eclipse.emf.ecore.EObject createPortWithIndex(int index)

Helper method that creates a bigraphical port EObject with the given index.

Parameters:

index - the index for the newly created port instance.

Returns:

a new port instance with the index set

isConnectedWithLink

protected boolean isConnectedWithLink(BigraphEntity.NodeEntity<Control> place,
 @Nullable org.eclipse.emf.ecore.EObject theLink)

Helper method to check if a given node is connected to the given link. If the link is null, then false is returned.

Parameters:

place - the node to test

theLink - the link

Returns:

true, if the given place is connected with the link, otherwise false.

createNodeOfEClass

protected org.eclipse.emf.ecore.EObject createNodeOfEClass(String name,
 @NonNull Control control)

createNodeOfEClass

protected org.eclipse.emf.ecore.EObject createNodeOfEClass(String name,
 @NonNull Control control,
 String nodeIdentifier)

createEdgeOfEClass0

protected org.eclipse.emf.ecore.EObject createEdgeOfEClass0(String edgeName)

createEdgeOfEClass

protected BigraphEntity.Edge createEdgeOfEClass()

Creates an edge of EClass BEdge and adds it to the list of available edges availableEdges.

Returns:

the freshly created edge

createEdgeOfEClass

protected BigraphEntity.Edge createEdgeOfEClass(org.eclipse.emf.ecore.EObject eObject)

create

public PureBigraph create()

makeGround

public void makeGround()

Converts the current bigraph to a ground bigraph (i.e., no sites an no inner names).

closeInner

public PureBigraphBuilder<S> closeInner()

Closes all inner names and doesn't keep idle edges and idle inner names.

closeInner

public void closeInner(BigraphEntity.InnerName... innerName)
                throws LinkTypeNotExistsException

Throws:

LinkTypeNotExistsException

closeInner

public void closeInner(String innerName,
 boolean keepIdleName)
                throws TypeNotExistsException

Convenient method for closeInner(BigraphEntity.InnerName, boolean)

Throws:

TypeNotExistsException

closeInner

public void closeInner(BigraphEntity.InnerName innerName)
                throws TypeNotExistsException

Convenient method for closeInner(BigraphEntity.InnerName, boolean). The last argument defaults to false.

Parameters:

innerName - an inner name

Throws:

TypeNotExistsException - if the given inner names is not contained in the bigraph.

closeInner

public void closeInner(BigraphEntity.InnerName innerName,
 boolean keepIdleName)
                throws LinkTypeNotExistsException

Specified by:

closeInner in class BigraphBuilderSupport<S extends AbstractEcoreSignature<? extends Control<?,?>>>

Throws:

LinkTypeNotExistsException

closeOuter

public PureBigraphBuilder<S> closeOuter()

Closes all outer names. See closeOuter(BigraphEntity.OuterName).

closeOuter

public void closeOuter(BigraphEntity.OuterName outerName)
                throws TypeNotExistsException

Closes the outer name by removing all connections and the outer name itself. This method doesn't allow idle names. Connected nodes over the same name will not be connected by an edge.

Parameters:

outerName - the outer name to remove

Throws:

TypeNotExistsException - if the passed outer name is not contained in the bigraph

closeOuter

public void closeOuter(String outerName,
 boolean keepIdleName)
                throws TypeNotExistsException

Convenient method for closeOuter(BigraphEntity.OuterName, boolean)

Throws:

TypeNotExistsException

closeOuter

public void closeOuter(BigraphEntity.OuterName outerName,
 boolean keepIdleName)
                throws TypeNotExistsException

If an inner name is connected to an outer name, the inner name will remain (i.e., not be removed). The port of a connected node is removed.

Parameters:

outerName - the outer name to remove

keepIdleName - true, if the outer name shall be kept as an idle name; and false to remove

Throws:

TypeNotExistsException - if the passed outer name is not contained in the bigraph

loadSignatureMetaModel

protected void loadSignatureMetaModel(String metaModelFilePath)

Does not re-create control nodes of type EClass because it directly uses the bigraphical Ecore metamodel. May throw a runtime exception.

Parameters:

metaModelFilePath - the filepath to the bigraphical metamodel containing signature information.

Throws:

BigraphMetaModelLoadingFailedException - if metamodel could not be loaded

clearIntermediateResults

protected void clearIntermediateResults()

Clears all generated intermediate results of the bigraph's current construction inside the builder.
Should not be called. Is made available for the MutableBuilder.