org.eclipse.papyrus.designer.components.transformation.core.transformations.connector

Class ConnectorReification

java.lang.Object

org.eclipse.papyrus.designer.components.transformation.core.transformations.connector.ConnectorReification

public class ConnectorReification
extends Object

This class enables the reification of connectors, i.e. the replacement of a UML connector with an interaction component. Reification is primarily done on the level of a composite class, the

Field Summary

Fields

Modifier and Type	Field and Description
static org.eclipse.uml2.uml.TemplateBinding	binding

Constructor Summary

Constructors

Constructor and Description
ConnectorReification()

Method Summary

Modifier and Type	Method and Description
static org.eclipse.uml2.uml.Port	getConnectorPort(org.eclipse.uml2.uml.EncapsulatedClassifier connectorType, org.eclipse.uml2.uml.Port otherPort, boolean isAssembly) Find a port that would match a connection
static org.eclipse.uml2.uml.ConnectorEnd	oppositeConnEnd(org.eclipse.uml2.uml.Connector connection, org.eclipse.uml2.uml.ConnectorEnd myEnd) Simple helper function
static void	propagateNodeAllocation(org.eclipse.uml2.uml.Class composite, org.eclipse.uml2.uml.InstanceSpecification compositeIS, org.eclipse.uml2.uml.Slot partSlot) Propagate node allocation into a reified connector (identified via its part) The allocation algorithm works as follows
static org.eclipse.uml2.uml.Property	reifyConnector(LazyCopier copier, org.eclipse.uml2.uml.Class tmComponent, org.eclipse.uml2.uml.Property smConnectorPart, org.eclipse.uml2.uml.InstanceSpecification tmIS) Reify a connector already represented in form of a part (useful for n-ary connectors)
static org.eclipse.uml2.uml.Property	reifyConnector(LazyCopier copier, org.eclipse.uml2.uml.Class tmComponent, String name, org.eclipse.uml2.uml.Connector smConnector, org.eclipse.uml2.uml.InstanceSpecification tmIS) Reify a connector

Methods inherited from class java.lang.Object

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

Field Detail

binding

public static org.eclipse.uml2.uml.TemplateBinding binding

Constructor Detail

ConnectorReification

public ConnectorReification()

Method Detail

getConnectorPort

public static org.eclipse.uml2.uml.Port getConnectorPort(org.eclipse.uml2.uml.EncapsulatedClassifier connectorType,
                                                         org.eclipse.uml2.uml.Port otherPort,
                                                         boolean isAssembly)

Find a port that would match a connection

Parameters:

connectorType - a connector type, i.e. a component with ports

the - port on the other side of the connection

Returns:

the first port (of all ports owned or inherited by the type) that is compatible with the passed otherPort.

reifyConnector

public static org.eclipse.uml2.uml.Property reifyConnector(LazyCopier copier,
                                                           org.eclipse.uml2.uml.Class tmComponent,
                                                           org.eclipse.uml2.uml.Property smConnectorPart,
                                                           org.eclipse.uml2.uml.InstanceSpecification tmIS)
                                                    throws TransformationException

Reify a connector already represented in form of a part (useful for n-ary connectors)

Parameters:

copier - a lazy copier

tmComponent - containing composite in target target model

smConnectorPart - Part representing the connector

tmIS - target instance specification of the composite passed as 2nd parameter (required for obtaining node allocation and choosing the right implementation. Main use: decide whether a distributed implementation of an interaction component needs to be used)

Returns:

The created part within tmComponent that represents the reified connector

Throws:

TransformationException

reifyConnector

public static org.eclipse.uml2.uml.Property reifyConnector(LazyCopier copier,
                                                           org.eclipse.uml2.uml.Class tmComponent,
                                                           String name,
                                                           org.eclipse.uml2.uml.Connector smConnector,
                                                           org.eclipse.uml2.uml.InstanceSpecification tmIS)
                                                    throws TransformationException

Reify a connector

Parameters:

copier - The coper from source to target mode

tmComponent - containing composite in target target

name - name of the connector

smConnector - connector element within the source model

tmIS - target instance specification of the composite passed as 2nd parameter (required for obtaining node allocation and choosing the right implementation. Main use: decide whether a distributed implementation of an interaction component needs to be used)

Returns:

the created part within tmComponent

Throws:

TransformationException

oppositeConnEnd

public static org.eclipse.uml2.uml.ConnectorEnd oppositeConnEnd(org.eclipse.uml2.uml.Connector connection,
                                                                org.eclipse.uml2.uml.ConnectorEnd myEnd)

Simple helper function

Parameters:

part -

connection -

Returns:

the connector end that is associated with the "other" end of a connection, i.e. the end that is not connected with the part passed as parameter.

propagateNodeAllocation

public static void propagateNodeAllocation(org.eclipse.uml2.uml.Class composite,
                                           org.eclipse.uml2.uml.InstanceSpecification compositeIS,
                                           org.eclipse.uml2.uml.Slot partSlot)

Propagate node allocation into a reified connector (identified via its part) The allocation algorithm works as follows. - get a connector (simple) originating from the passed part - get the opposite end of this simple connector and identify the connected part (other part, e.g. a part typed with an application component) - obtain the nodes to which this other part is allocated: - in case of a composite, connections are followed up to a monolithic component - propagate the node allocation into the connector (propagation will finally allocate leafs within a (composite) connector.

Parameters:

composite - the composite class (e.g. system) in which a connector is reified

compositeIS - the associated instance specification

partSlot - the slot associated with the part for which nodes are allocated.