Package org.palladiosimulator.pcm.seff
Interface ExternalCallAction
- All Superinterfaces:
AbstractAction
,CallAction
,CallReturnAction
,org.eclipse.emf.cdo.CDOObject
,org.eclipse.emf.cdo.common.id.CDOWithID
,Entity
,EObject
,FailureHandlingEntity
,de.uka.ipd.sdq.identifier.Identifier
,NamedElement
,Notifier
,PCMBaseClass
,PCMClass
- All Known Implementing Classes:
ExternalCallActionImpl
A representation of the model object 'External Call Action'.
ExternalCallAction models the invocation of a service specified in a required interface. Therefore, it references a Role, from which the providing component can be derived, and a Signature to specify the called service. ExternalCallActions model synchronous calls to required services, i.e., the caller waits until the called service finishes execution before continuing execution itself. The PCM allows modelling asynchronous calls to required services by using an ExternalCallAction inside a ForkedBehaviour.
ExternalCallActions do not have resource demands by themselves. Component developers need to specify the resource demand of the called service in the RDSEFF of that service. The resource demand can also be calculated by analysing the providing component. This keeps the RDSEFF specification of different component developers independent from each other and makes them replaceable in an architectural model.
ExternalCallActions may contain two sets of VariableUsages specifying input parameter characterisations and output parameter characterisations respectively. VariableUsages for input parameters may only reference IN or INOUT parameters of the call's referenced signature. The random variable characterisation inside such a VariableUsage may be constants, probability distribution functions, or include a stochastic expression involving for example arithmetic operations. The latter models a dependency between the current service's own input parameters and the input parameters of the required service.
ExternalCallActions do not have resource demands by themselves. Component developers need to specify the resource demand of the called service in the RDSEFF of that service. The resource demand can also be calculated by analysing the providing component. This keeps the RDSEFF specification of different component developers independent from each other and makes them replaceable in an architectural model.
ExternalCallActions may contain two sets of VariableUsages specifying input parameter characterisations and output parameter characterisations respectively. VariableUsages for input parameters may only reference IN or INOUT parameters of the call's referenced signature. The random variable characterisation inside such a VariableUsage may be constants, probability distribution functions, or include a stochastic expression involving for example arithmetic operations. The latter models a dependency between the current service's own input parameters and the input parameters of the required service.
The following features are supported:
- See Also:
- Generated class or method.
- EMF model class or method.
- annotation="http://www.eclipse.org/emf/2002/Ecore constraints='signatureBelongsToRole operationRequiredRoleMustBeReferencedByContainer'" annotation="http://www.eclipse.org/emf/2002/Ecore/OCL/LPG signatureBelongsToRole='self.role_ExternalService.requiredInterface__OperationRequiredRole.signatures__OperationInterface->includes(self.calledService_ExternalService)' operationRequiredRoleMustBeReferencedByContainer='self.oclAsType(ecore::EObject)->closure(eContainer())->select( entity | entity.oclIsKindOf(pcm::core::entity::InterfaceRequiringEntity)).oclAsType(pcm::core::entity::InterfaceRequiringEntity).requiredRoles_InterfaceRequiringEntity->includes(self.role_ExternalService)'"
-
Field Summary
-
Method Summary
Modifier and TypeMethodDescriptionReturns the value of the 'Called Service External Service' reference.int
Returns the value of the 'Retry Count' attribute.Returns the value of the 'Role External Service' reference.void
Sets the value of the 'Called Service External Service
' reference.void
setRetryCount
(int value) Sets the value of the 'Retry Count
' attribute.void
Sets the value of the 'Role External Service
' reference.Methods inherited from interface org.palladiosimulator.pcm.seff.AbstractAction
getPredecessor_AbstractAction, getResourceDemandingBehaviour_AbstractAction, getSuccessor_AbstractAction, setPredecessor_AbstractAction, setResourceDemandingBehaviour_AbstractAction, setSuccessor_AbstractAction
Methods inherited from interface org.palladiosimulator.pcm.seff.CallAction
getInputVariableUsages__CallAction
Methods inherited from interface org.palladiosimulator.pcm.seff.CallReturnAction
getReturnVariableUsage__CallReturnAction
Methods inherited from interface org.eclipse.emf.cdo.CDOObject
cdoConflict, cdoDirectResource, cdoHistory, cdoID, cdoInvalid, cdoLockState, cdoPermission, cdoPrefetch, cdoReadLock, cdoReload, cdoResource, cdoRevision, cdoRevision, cdoState, cdoView, cdoWriteLock, cdoWriteOption
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.palladiosimulator.pcm.seff.seff_reliability.FailureHandlingEntity
getFailureTypes_FailureHandlingEntity
Methods inherited from interface de.uka.ipd.sdq.identifier.Identifier
getId, setId
Methods inherited from interface org.palladiosimulator.pcm.core.entity.NamedElement
getEntityName, setEntityName
Methods inherited from interface org.eclipse.emf.common.notify.Notifier
eAdapters, eDeliver, eNotify, eSetDeliver
-
Field Details
-
copyright
- See Also:
- Generated class or method.
-
-
Method Details
-
getCalledService_ExternalService
OperationSignature getCalledService_ExternalService()Returns the value of the 'Called Service External Service' reference.- Returns:
- the value of the 'Called Service External Service' reference.
- See Also:
- Generated class or method.
- EMF model class or method.
- required="true" ordered="false"
-
setCalledService_ExternalService
Sets the value of the 'Called Service External Service
' reference.- Parameters:
value
- the new value of the 'Called Service External Service' reference.- See Also:
- Generated class or method.
-
getRole_ExternalService
OperationRequiredRole getRole_ExternalService()Returns the value of the 'Role External Service' reference.- Returns:
- the value of the 'Role External Service' reference.
- See Also:
- Generated class or method.
- EMF model class or method.
- required="true" ordered="false"
-
setRole_ExternalService
Sets the value of the 'Role External Service
' reference.- Parameters:
value
- the new value of the 'Role External Service' reference.- See Also:
- Generated class or method.
-
getRetryCount
int getRetryCount()Returns the value of the 'Retry Count' attribute. Specifies the number of retries this ExternalCallAction shoul be re-executed in case of failure occurence.- Returns:
- the value of the 'Retry Count' attribute.
- See Also:
- Generated class or method.
- EMF model class or method.
- required="true" ordered="false"
-
setRetryCount
void setRetryCount(int value) Sets the value of the 'Retry Count
' attribute.- Parameters:
value
- the new value of the 'Retry Count' attribute.- See Also:
- Generated class or method.
-