org.eclipse.uml2.uml
Interface Extend

All Superinterfaces:
DirectedRelationship, Element, org.eclipse.emf.ecore.EModelElement, org.eclipse.emf.ecore.EObject, NamedElement, org.eclipse.emf.common.notify.Notifier, Relationship

public interface Extend
extends NamedElement, DirectedRelationship

A representation of the model object 'Extend'. A relationship from an extending UseCase to an extended UseCase that specifies how and when the behavior defined in the extending UseCase can be inserted into the behavior defined in the extended UseCase.

From package UML::UseCases.

The following features are supported:

See Also:
UMLPackage.getExtend()

Field Summary
 
Fields inherited from interface org.eclipse.uml2.uml.NamedElement
SEPARATOR
 
Method Summary
 Constraint createCondition(java.lang.String name)
          Creates a new Constraint,with the specified 'Name', and sets the 'Condition' containment reference
 Constraint createCondition(java.lang.String name, org.eclipse.emf.ecore.EClass eClass)
          Creates a new Constraint, with the specified 'Name', and sets the 'Condition' containment reference
 Constraint getCondition()
          Returns the value of the 'Condition' containment reference.
 UseCase getExtendedCase()
          Returns the value of the 'Extended Case' reference.
 UseCase getExtension()
          Returns the value of the 'Extension' container reference.
 ExtensionPoint getExtensionLocation(java.lang.String name)
          Retrieves the first ExtensionPoint with the specified 'Name' from the 'Extension Location' reference list
 ExtensionPoint getExtensionLocation(java.lang.String name, boolean ignoreCase)
          Retrieves the first ExtensionPoint with the specified 'Name' from the 'Extension Location' reference list
 org.eclipse.emf.common.util.EList<ExtensionPoint> getExtensionLocations()
          Returns the value of the 'Extension Location' reference list.
 void setCondition(Constraint value)
          Sets the value of the 'Condition' containment reference
 void setExtendedCase(UseCase value)
          Sets the value of the 'Extended Case' reference
 void setExtension(UseCase value)
          Sets the value of the 'Extension' container reference
 boolean validateExtensionPoints(org.eclipse.emf.common.util.DiagnosticChain diagnostics, java.util.Map<java.lang.Object,java.lang.Object> context)
          The ExtensionPoints referenced by the Extend relationship must belong to the UseCase that is being extended.
 
Methods inherited from interface org.eclipse.uml2.uml.NamedElement
allNamespaces, allOwningPackages, createDependency, createNameExpression, createUsage, getClientDependencies, getClientDependency, getClientDependency, getLabel, getLabel, getName, getNameExpression, getNamespace, getQualifiedName, getVisibility, isDistinguishableFrom, isSetName, isSetVisibility, separator, setName, setNameExpression, setVisibility, unsetName, unsetVisibility, validateHasNoQualifiedName, validateHasQualifiedName, validateVisibilityNeedsOwnership
 
Methods inherited from interface org.eclipse.uml2.uml.DirectedRelationship
getSources, getTargets
 
Methods inherited from interface org.eclipse.uml2.uml.Relationship
getRelatedElements
 
Methods inherited from interface org.eclipse.uml2.uml.Element
addKeyword, allOwnedElements, applyStereotype, createEAnnotation, createOwnedComment, destroy, getApplicableStereotype, getApplicableStereotypes, getAppliedStereotype, getAppliedStereotypes, getAppliedSubstereotype, getAppliedSubstereotypes, getKeywords, getModel, getNearestPackage, getOwnedComments, getOwnedElements, getOwner, getRelationships, getRelationships, getRequiredStereotype, getRequiredStereotypes, getSourceDirectedRelationships, getSourceDirectedRelationships, getStereotypeApplication, getStereotypeApplications, getTargetDirectedRelationships, getTargetDirectedRelationships, getValue, hasKeyword, hasValue, isStereotypeApplicable, isStereotypeApplied, isStereotypeRequired, mustBeOwned, removeKeyword, setValue, unapplyStereotype, validateHasOwner, validateNotOwnSelf
 
Methods inherited from interface org.eclipse.emf.ecore.EModelElement
getEAnnotation, getEAnnotations
 
Methods inherited from interface org.eclipse.emf.ecore.EObject
eAllContents, eClass, eContainer, eContainingFeature, eContainmentFeature, eContents, eCrossReferences, eGet, eGet, eInvoke, eIsProxy, eIsSet, eResource, eSet, eUnset
 
Methods inherited from interface org.eclipse.emf.common.notify.Notifier
eAdapters, eDeliver, eNotify, eSetDeliver
 

Method Detail

getExtendedCase

UseCase getExtendedCase()
Returns the value of the 'Extended Case' reference.

This feature subsets the following features:

The UseCase that is being extended.

From package UML::UseCases.

Returns:
the value of the 'Extended Case' reference.
See Also:
setExtendedCase(UseCase), UMLPackage.getExtend_ExtendedCase()

setExtendedCase

void setExtendedCase(UseCase value)
Sets the value of the 'Extended Case' reference.

Parameters:
value - the new value of the 'Extended Case' reference.
See Also:
getExtendedCase()

getCondition

Constraint getCondition()
Returns the value of the 'Condition' containment reference.

This feature subsets the following features:

References the condition that must hold when the first ExtensionPoint is reached for the extension to take place. If no constraint is associated with the Extend relationship, the extension is unconditional.

From package UML::UseCases.

Returns:
the value of the 'Condition' containment reference.
See Also:
setCondition(Constraint), UMLPackage.getExtend_Condition()

setCondition

void setCondition(Constraint value)
Sets the value of the 'Condition' containment reference.

Parameters:
value - the new value of the 'Condition' containment reference.
See Also:
getCondition()

createCondition

Constraint createCondition(java.lang.String name,
                           org.eclipse.emf.ecore.EClass eClass)
Creates a new Constraint, with the specified 'Name', and sets the 'Condition' containment reference.

Parameters:
name - The 'Name' for the new Constraint, or null.
eClass - The Ecore class of the Constraint to create.
Returns:
The new Constraint.
See Also:
getCondition()

createCondition

Constraint createCondition(java.lang.String name)
Creates a new Constraint,with the specified 'Name', and sets the 'Condition' containment reference.

Parameters:
name - The 'Name' for the new Constraint, or null.
Returns:
The new Constraint.
See Also:
getCondition()

getExtensionLocations

org.eclipse.emf.common.util.EList<ExtensionPoint> getExtensionLocations()
Returns the value of the 'Extension Location' reference list. The list contents are of type ExtensionPoint. An ordered list of ExtensionPoints belonging to the extended UseCase, specifying where the respective behavioral fragments of the extending UseCase are to be inserted. The first fragment in the extending UseCase is associated with the first extension point in the list, the second fragment with the second point, and so on. Note that, in most practical cases, the extending UseCase has just a single behavior fragment, so that the list of ExtensionPoints is trivial.

From package UML::UseCases.

Returns:
the value of the 'Extension Location' reference list.
See Also:
UMLPackage.getExtend_ExtensionLocation()

getExtensionLocation

ExtensionPoint getExtensionLocation(java.lang.String name)
Retrieves the first ExtensionPoint with the specified 'Name' from the 'Extension Location' reference list.

Parameters:
name - The 'Name' of the ExtensionPoint to retrieve, or null.
Returns:
The first ExtensionPoint with the specified 'Name', or null.
See Also:
getExtensionLocations()

getExtensionLocation

ExtensionPoint getExtensionLocation(java.lang.String name,
                                    boolean ignoreCase)
Retrieves the first ExtensionPoint with the specified 'Name' from the 'Extension Location' reference list.

Parameters:
name - The 'Name' of the ExtensionPoint to retrieve, or null.
ignoreCase - Whether to ignore case in String comparisons.
Returns:
The first ExtensionPoint with the specified 'Name', or null.
See Also:
getExtensionLocations()

getExtension

UseCase getExtension()
Returns the value of the 'Extension' container reference. It is bidirectional and its opposite is 'Extend'.

This feature subsets the following features:

The UseCase that represents the extension and owns the Extend relationship.

From package UML::UseCases.

Returns:
the value of the 'Extension' container reference.
See Also:
setExtension(UseCase), UMLPackage.getExtend_Extension(), UseCase.getExtends()

setExtension

void setExtension(UseCase value)
Sets the value of the 'Extension' container reference.

Parameters:
value - the new value of the 'Extension' container reference.
See Also:
getExtension()

validateExtensionPoints

boolean validateExtensionPoints(org.eclipse.emf.common.util.DiagnosticChain diagnostics,
                                java.util.Map<java.lang.Object,java.lang.Object> context)
The ExtensionPoints referenced by the Extend relationship must belong to the UseCase that is being extended. extensionLocation->forAll (xp | extendedCase.extensionPoint->includes(xp))

Parameters:
diagnostics - The chain of diagnostics to which problems are to be appended.
context - The cache of context-specific information.

Copyright 2003, 2014 IBM Corporation, CEA, and others.
All Rights Reserved.