Interface AbstractParameterTemplate
-
- All Superinterfaces:
PluginDataContainer
,UserAttributeContainer
- All Known Subinterfaces:
ParameterTemplate
,StorageParameterTemplate
public interface AbstractParameterTemplate extends UserAttributeContainer, PluginDataContainer
This interface unifies the methods of aParameterTemplate
used with inheritance (in the GUI) as well as for storage.This interface is not for public usage! It is only public due to a bug in the javadoc-generation. Never cast one of the sub-interfaces (
ParameterTemplate
andStorageParameterTemplate
) to this interface!- Author:
- Ulrich Kreher
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description ActivityConstants.AccessType
getAccessType()
Gets the access type for the parameter of this template.ProcessConstants.AdeptDataType
getDataType()
Gets the data type for the parameter of this template.String
getDefaultValue()
Gets the string representation for the default value for the parameter of this template.String
getDescription()
Gets the description for the parameter of this template.UUID
getIdentifierID()
Gets the ID of the identifier for the parameter of this template.String
getName()
Gets the name for the parameter of this template.String
getTemplateDescription()
Gets a description for the process modeler and the administrator of the activity model.String
getTemplateName()
Gets the unique (with respect to the corresponding entity) name of this parameter template.String
getUDTName()
Gets the name for the user-defined data type for the parameter of this template.boolean
isAccessTypeInherited()
Gets whether the access type for a parameter of this template is inherited from a parent entity, that is this template does not override the access type attribute of a template of a parent entity.boolean
isDataTypeInherited()
Gets whether the data type for a parameter of this template is inherited from a parent entity, that is this template does not override the data type attribute of a template of a parent entity.boolean
isDefaultValueInherited()
Gets whether the string representation for the default value for a parameter of this template is inherited from a parent entity, that is this template does not override the string representation attribute for the default value of a template of a parent entity.boolean
isDescriptionInherited()
Gets whether the description for a parameter of this template is inherited from a parent entity, that is this template does not override the description attribute of a template of a parent entity.Boolean
isFailure()
Gets whether the parameter of this template is a failure parameter and therefore all other output parameters are treated as optional if explicitly mapped to a data element.boolean
isFailureInherited()
Gets whether the failure flag for a parameter of this template is inherited from a parent entity, that is this template does not override the failure flag attribute of a template of a parent entity.boolean
isIdentifierIDInherited()
Gets whether the ID of the identifier for a parameter of this template is inherited from a parent entity, that is this template does not override the ID of the identifier attribute of a template of a parent entity.boolean
isNameInherited()
Gets whether the name for a parameter of this template is inherited from a parent entity, that is this template does not override the name attribute of a template of a parent entity.Boolean
isOptional()
Gets whether the parameter of this template is optional and therefore may have a value of null at runtime.boolean
isOptionalInherited()
Gets whether the optional flag for a parameter of this template is inherited from a parent entity, that is this template does not override the optional flag attribute of a template of a parent entity.boolean
isTemplateDescriptionInherited()
Gets whether the description of this parameter template is inherited from a parent entity, that is this template does not override the description attribute of a template of a parent entity.boolean
isUDTNameInherited()
Gets whether the user-defined type name for a parameter of this template is inherited from a parent entity, that is this template does not override the user-defined type name attribute of a template of a parent entity.Boolean
isVirtual()
Gets whether the parameter of this template is virtual and therefore is not provided to the implementation of the corresponding operation.boolean
isVirtualInherited()
Gets whether the virtual flag for a parameter of this template is inherited from a parent entity, that is this template does not override the virtual flag attribute of a template of a parent entity.void
removeOwnAccessType()
Removes the access type that overrides the access type provided by a corresponding parameter template from a parent entity.void
removeOwnDataType()
Removes the data type that overrides the data type provided by a corresponding parameter template from a parent entity.void
removeOwnDefaultValue()
Removes the string representation for the default value that overrides the string representation for the default value provided by a corresponding parameter template from a parent entity.void
removeOwnDescription()
Removes the description that overrides the description provided by a corresponding parameter template from a parent entity.void
removeOwnFailure()
Removes the failure flag that overrides the failure flag provided by a corresponding parameter template from a parent entity.void
removeOwnIdentifierID()
Removes the ID of the identifier that overrides the ID of the identifier provided by a corresponding parameter template from a parent entity.void
removeOwnName()
Removes the name that overrides the name provided by a corresponding parameter template from a parent entity.void
removeOwnOptional()
Removes the optional flag that overrides the optional flag provided by a corresponding parameter template from a parent entity.void
removeOwnTemplateDescription()
Removes the description of this parameter template that overrides the description provided by a corresponding parameter template from a parent entity.void
removeOwnUDTName()
Removes the user-defined type name that overrides the data type provided by a corresponding parameter template from a parent entity.void
removeOwnVirtual()
Removes the virtual flag that overrides the virtual flag provided by a corresponding parameter template from a parent entity.void
setAccessType(ActivityConstants.AccessType accessType)
Sets the access type for the parameter of this template.void
setDataType(ProcessConstants.AdeptDataType dataType)
Sets the data type for the parameter of this template.void
setDefaultValue(String defaultValue)
Sets the string representation for the default value parameter of this template.void
setDescription(String description)
Sets the description for the parameter of this template.void
setFailure(boolean failure)
Sets whether the parameter of this template is a failure parameter and therefore sets all other parameters to optional if explicitly mapped to a data element.void
setIdentifierID(UUID identifierID)
Sets the ID of the identifier for the parameter of this template.void
setName(String name)
Sets the name for the parameter of this template.void
setOptional(boolean optional)
Sets whether the parameter of this template is optional and therefore may have a value of null at runtime.void
setTemplateDescription(String templateDescription)
Sets a description for the process modeler and the administrator of the activity model.void
setTemplateName(String templateName)
Sets the unique (with respect to the corresponding entity) name of this parameter template.void
setUDTName(String udtName)
Sets the the user-defined type name for the parameter of this template.void
setVirtual(boolean virtual)
Sets whether the parameter of this template is virtual and therefore is not provided to the implementation of the corresponding operation.-
Methods inherited from interface de.aristaflow.adept2.model.common.PluginDataContainer
getPluginData, getPluginDatas, getSupportedPlugins
-
Methods inherited from interface de.aristaflow.adept2.model.common.UserAttributeContainer
getUserAttributes, getUserAttributeValue, removeUserAttributeValue, setUserAttributeValue
-
-
-
-
Method Detail
-
getTemplateName
String getTemplateName()
Gets the unique (with respect to the corresponding entity) name of this parameter template. This is used to identify the template and provide a name for the user when creating new parameters.- Returns:
- The unique (with respect to the corresponding entity) name of this parameter template.
-
getTemplateDescription
String getTemplateDescription()
Gets a description for the process modeler and the administrator of the activity model. This description is not propagated to the corresponding parameter.- Returns:
- A description for the process modeler and the administrator of the activity model. This description is not propagated to the corresponding parameter.
-
getAccessType
ActivityConstants.AccessType getAccessType()
Gets the access type for the parameter of this template.The access type may be null in which case it is interpreted as do not care and the user needs to assign one when creating the corresponding parameter.
- Returns:
- The access type for a parameter of this template, that is a parameter created based on this template will have this access type.
-
getName
String getName()
Gets the name for the parameter of this template. Note that this name is to be unique for the designated entity and the access type. There may be templates for several parameters having the same name but when adding parameters only one of this will be able to be used.The name of the parameter may be localised which will be applied to the created parameter accordingly. The name may be null in which case it is interpreted as do not care and the user needs to assign one when creating the corresponding parameter.
- Returns:
- The name for a parameter of this template, that is a parameter created based on this template will have this name.
-
getDescription
String getDescription()
Gets the description for the parameter of this template. This is some arbitrary text describing the usage of the parameter (not the usage of the parameter template).The description of the parameter may be localised which will be applied to the created parameter accordingly. The description may be null in which case it is interpreted as do not care and the user may assign one when creating the corresponding parameter.
- Returns:
- The description for a parameter of this template, that is a parameter created based on this template will have this description.
-
getDataType
ProcessConstants.AdeptDataType getDataType()
Gets the data type for the parameter of this template.The data type may be null in which case it is interpreted as do not care and the user may needs to assign one when creating the corresponding parameter.
- Returns:
- The data type for a parameter of this template, that is a parameter created based on this template will have this data type.
-
getUDTName
String getUDTName()
Gets the name for the user-defined data type for the parameter of this template. This name will only used in case the data type isUSERDEFINED
for the created parameter. This may either be due to the data type set in the template or by the user.The name of the user-defined data type may be null in which case it is interpreted as do not care and the user may assign one when creating the corresponding parameter.
- Returns:
- The name for the user-defined data type for a parameter of this template, that is a parameter created based on this template will have this user-defined data type name.
-
getIdentifierID
UUID getIdentifierID()
Gets the ID of the identifier for the parameter of this template.The ID may be null in which case it is interpreted as do not care and the user needs to assign one when creating the corresponding parameter.
- Returns:
- The ID of the identifier for a parameter of this template, that is a parameter created based on this template will have this identifier.
-
isOptional
Boolean isOptional()
Gets whether the parameter of this template is optional and therefore may have a value of null at runtime.This flag may be null in which case it is interpreted as do not care and the user needs to set it when creating the corresponding parameter.
- Returns:
- Whether a parameter of this template is optional and therefore may have a value of null at runtime.
-
isVirtual
Boolean isVirtual()
Gets whether the parameter of this template is virtual and therefore is not provided to the implementation of the corresponding operation.This flag may be null in which case it is interpreted as do not care and the user needs to set it when creating the corresponding parameter.
- Returns:
- Whether a parameter of this template is virtual and therefore is not provided to the implementation of the corresponding operation.
-
isFailure
Boolean isFailure()
Gets whether the parameter of this template is a failure parameter and therefore all other output parameters are treated as optional if explicitly mapped to a data element. However, the parameters itself remain mandatory (not optional), only the data edge will be optional.This flag may be null in which case it is interpreted as do not care and the user needs to set it when creating the corresponding parameter.
- Returns:
- Whether a parameter of this template is a failure parameter and therefore its mapping to a data element sets all other parameters to optional.
-
getDefaultValue
String getDefaultValue()
Gets the string representation for the default value for the parameter of this template. The string representation conforms to the string representation in configurations, that is, the same transformation is applied for non-string types, for instance user-defined data types. This transformation is the only way to allow for complex data types in simple configuration files which are usually based on simple strings.The value string may be null in which case it is interpreted as do not care and the user may assign one when creating the corresponding parameter.
- Returns:
- The string representation for the default value of the parameter of this template. The representation conforms to the string representation used in configurations for complex data types.
-
setTemplateName
void setTemplateName(String templateName)
Sets the unique (with respect to the corresponding entity) name of this parameter template.- Parameters:
templateName
- The unique (with respect to the corresponding entity) name of this parameter template. This may neither be null nor the empty string.
-
setTemplateDescription
void setTemplateDescription(String templateDescription)
Sets a description for the process modeler and the administrator of the activity model. This description is not propagated to the corresponding parameter. If this description is not set, it will be interpreted as do not care and the user needs to assign one when creating the corresponding parameter.
The description may only be set if not set in the parent parameter template, that is overriding of null (the do not care value). UseremoveOwnTemplateDescription()
to unset the template description for this entity. This will either inherit the value again if there is a parent parameter template or set it to null (and therefore do not care) if there is no parent parameter template.- Parameters:
templateDescription
- A description for the process modeler and the administrator of the activity model. This description is not propagated to the corresponding parameter. This must not be null.
-
setName
void setName(String name)
Sets the name for the parameter of this template. The same name may be used for different parameter templates but only one of these may be used as a real parameter for the corresponding operation. If this name is not set, it will be interpreted as do not care and the user needs to assign one when creating the corresponding parameter.
The name may only be set if not set in the parent parameter template, that is overriding of null (the do not care value). UseremoveOwnName()
to unset the name for this entity. This will either inherit the value again if there is a parent parameter template or set it to null (and therefore do not care) if there is no parent parameter template.Use the usual plugins for localising this name.
- Parameters:
name
- The name for a parameter of this template, that is a parameter created based on this template will have this name. This must not be null.
-
setDescription
void setDescription(String description)
Sets the description for the parameter of this template. This is some arbitrary text describing the usage of the parameter (not the usage of the parameter template). If this description is not set, it will be interpreted as do not care and the user needs to assign one when creating the corresponding parameter.
The description may only be set if not set in the parent parameter template, that is overriding of null (the do not care value). UseremoveOwnDescription()
to unset the description for this entity. This will either inherit the value again if there is a parent parameter template or set it to null (and therefore do not care) if there is no parent parameter template.Use the usual plugins for localising this description.
- Parameters:
description
- the description for a parameter of this template, that is a parameter created based on this template will have this description. This must not be null.
-
setDataType
void setDataType(ProcessConstants.AdeptDataType dataType)
Sets the data type for the parameter of this template. If the data type is not set, each will be interpreted as do not care and the user needs to assign one when creating the corresponding parameter.
The data type may only be set if not set in the parent parameter template, that is overriding of null (the do not care value). UseremoveOwnDataType()
to unset the data type for this entity. This will either inherit the value again if there is a parent parameter template or set it to null (and therefore do not care) if there is no parent parameter template.- Parameters:
dataType
- The data type for a parameter of this template, that is a parameter created based on this template will have this data type. This must not be null.
-
setUDTName
void setUDTName(String udtName)
Sets the the user-defined type name for the parameter of this template. This will only apply if the data type isAdeptDataType.USERDEFINED
. If the user-defined type name is not set, it will be interpreted as do not care and the user needs to assign one when creating the corresponding parameter.
The user-defined type name may only be set if not set in the parent parameter template, that is overriding of null (the do not care value). UseremoveOwnUDTName()
to unset the user-defined type name for this entity. This will either inherit the value again if there is a parent parameter template or set it to null (and therefore do not care) if there is no parent parameter template.- Parameters:
udtName
- The empty string or the name of the user-defined type for a parameter of this template, that is a parameter created based on this template will have this name in case it is of user-defined type. This must not be null.
-
setIdentifierID
void setIdentifierID(UUID identifierID)
Sets the ID of the identifier for the parameter of this template. If this ID is not set, it will be interpreted as do not care and the user needs to assign one when creating the corresponding parameter.
The ID may only be set if not set in the parent parameter template, that is overriding of null (the do not care value). UseremoveOwnIdentifierID()
to unset the identifier ID for this entity. This will either inherit the value again if there is a parent parameter template or set it to null (and therefore do not care) if there is no parent parameter template.- Parameters:
identifierID
- The ID of the identifier for a parameter of this template, that is a parameter created based on this template will have this identifier. This must not be null.
-
setAccessType
void setAccessType(ActivityConstants.AccessType accessType)
Sets the access type for the parameter of this template. If this access type is not set, it will be interpreted as do not care and the user needs to assign one when creating the corresponding parameter.
The access type may only be set if not set in the parent parameter template, that is overriding of null (the do not care value). UseremoveOwnAccessType()
to unset the access type for this entity. This will either inherit the value again if there is a parent parameter template or set it to null (and therefore do not care) if there is no parent parameter template.- Parameters:
accessType
- The access type for a parameter of this template, that is a parameter created based on this template will have this access type. This must not be null.
-
setOptional
void setOptional(boolean optional)
Sets whether the parameter of this template is optional and therefore may have a value of null at runtime. If this flag is not set, it will be interpreted as do not care and the user needs to set it when creating the corresponding parameter.
The optional flag may only be set if not set in the parent parameter template, that is overriding of null (the do not care value). UseremoveOwnOptional()
to unset the optional flag for this entity. This will either inherit the value again if there is a parent parameter template or set it to null (and therefore do not care) if there is no parent parameter template.- Parameters:
optional
- Whether a parameter of this template is optional and therefore may have a value of null at runtime.
-
setVirtual
void setVirtual(boolean virtual)
Sets whether the parameter of this template is virtual and therefore is not provided to the implementation of the corresponding operation. If this flag is not set, it will be interpreted as do not care and the user needs to set it when creating the corresponding parameter.
The virtual flag may only be set if not set in the parent parameter template, that is overriding of null (the do not care value). UseremoveOwnVirtual()
to unset the virtual flag for this entity. This will either inherit the value again if there is a parent parameter template or set it to null (and therefore do not care) if there is no parent parameter template.- Parameters:
virtual
- Whether a parameter of this template is virtual and therefore is not provided to the implementation of the corresponding operation.
-
setFailure
void setFailure(boolean failure)
Sets whether the parameter of this template is a failure parameter and therefore sets all other parameters to optional if explicitly mapped to a data element. If this flag is not set, it will be interpreted as do not care and the user needs to set it when creating the corresponding parameter.
The failure flag may only be set if not set in the parent parameter template, that is overriding of null (the do not care value). UseremoveOwnFailure()
to unset the failure flag for this entity. This will either inherit the value again if there is a parent parameter template or set it to null (and therefore do not care) if there is no parent parameter template.- Parameters:
failure
- Whether a parameter of this template is a failure parameter and therefore its mapping to a data element sets all other parameters to optional.
-
setDefaultValue
void setDefaultValue(String defaultValue)
Sets the string representation for the default value parameter of this template. The string representation has to conform to the string representation in configurations, that is, the same transformation needs to be applied for non-string types, for instance user-defined data types. This transformation is the only way to allow for complex data types in simple configuration files which are usually based on simple strings.
If this default value is not set, it will be interpreted as do not care and the user needs to assign one when creating the corresponding parameter.
The default value may only be set if not set in the parent parameter template, that is overriding of null (the do not care value). UseremoveOwnDefaultValue()
to unset the default value for this entity. This will either inherit the value again if there is a parent parameter template or set it to null (and therefore do not care) if there is no parent parameter template.- Parameters:
defaultValue
- The string representation for the default value of the parameter of this template. The representation has to conform to the string representation used in configurations for complex data types. This must not be null.
-
isTemplateDescriptionInherited
boolean isTemplateDescriptionInherited()
Gets whether the description of this parameter template is inherited from a parent entity, that is this template does not override the description attribute of a template of a parent entity.- Returns:
- Whether the description of this parameter template is inherited from a parent entity or the description is provided by this template.
-
removeOwnTemplateDescription
void removeOwnTemplateDescription()
Removes the description of this parameter template that overrides the description provided by a corresponding parameter template from a parent entity. Afterwards the description is inherited again or if this parameter template does not have a parent, the value will be set to null (the do not care value).
Calling this method will have no effects if the description of this parameter template is already inherited.
-
isNameInherited
boolean isNameInherited()
Gets whether the name for a parameter of this template is inherited from a parent entity, that is this template does not override the name attribute of a template of a parent entity.- Returns:
- Whether the name for a parameter of this template is inherited from a parent entity or the name is provided by this template.
-
removeOwnName
void removeOwnName()
Removes the name that overrides the name provided by a corresponding parameter template from a parent entity. Afterwards the name is inherited again or if this parameter template does not have a parent, the value will be set to null (the do not care value).
Calling this method will have no effects if the name is already inherited.
-
isDescriptionInherited
boolean isDescriptionInherited()
Gets whether the description for a parameter of this template is inherited from a parent entity, that is this template does not override the description attribute of a template of a parent entity.- Returns:
- Whether the description for a parameter of this template is inherited from a parent entity or the description is provided by this template.
-
removeOwnDescription
void removeOwnDescription()
Removes the description that overrides the description provided by a corresponding parameter template from a parent entity. Afterwards the description is inherited again or if this parameter template does not have a parent, the value will be set to null (the do not care value).
Calling this method will have no effects if the description is already inherited.
-
isDataTypeInherited
boolean isDataTypeInherited()
Gets whether the data type for a parameter of this template is inherited from a parent entity, that is this template does not override the data type attribute of a template of a parent entity.- Returns:
- Whether the data type for a parameter of this template is inherited from a parent entity or the data type is provided by this template.
-
removeOwnDataType
void removeOwnDataType()
Removes the data type that overrides the data type provided by a corresponding parameter template from a parent entity. Afterwards the data type is inherited again or if this parameter template does not have a parent, the value will be set to null (the do not care value).
Calling this method will have no effects if the data type is already inherited.
-
isUDTNameInherited
boolean isUDTNameInherited()
Gets whether the user-defined type name for a parameter of this template is inherited from a parent entity, that is this template does not override the user-defined type name attribute of a template of a parent entity.- Returns:
- Whether the user-defined type name for a parameter of this template is inherited from a parent entity or the user-defined type name is provided by this template.
-
removeOwnUDTName
void removeOwnUDTName()
Removes the user-defined type name that overrides the data type provided by a corresponding parameter template from a parent entity. Afterwards the user-defined type name is inherited again or if this parameter template does not have a parent, the value will be set to null (the do not care value).
Calling this method will have no effects if the user-defined type name is already inherited.
-
isIdentifierIDInherited
boolean isIdentifierIDInherited()
Gets whether the ID of the identifier for a parameter of this template is inherited from a parent entity, that is this template does not override the ID of the identifier attribute of a template of a parent entity.- Returns:
- Whether the ID of the identifier for a parameter of this template is inherited from a parent entity or the ID of the identifier is provided by this template.
-
removeOwnIdentifierID
void removeOwnIdentifierID()
Removes the ID of the identifier that overrides the ID of the identifier provided by a corresponding parameter template from a parent entity. Afterwards the ID of the identifier is inherited again or if this parameter template does not have a parent, the value will be set to null (the do not care value).
Calling this method will have no effects if the ID of the identifier is already inherited.
-
isAccessTypeInherited
boolean isAccessTypeInherited()
Gets whether the access type for a parameter of this template is inherited from a parent entity, that is this template does not override the access type attribute of a template of a parent entity.- Returns:
- Whether the access type for a parameter of this template is inherited from a parent entity or the access type is provided by this template.
-
removeOwnAccessType
void removeOwnAccessType()
Removes the access type that overrides the access type provided by a corresponding parameter template from a parent entity. Afterwards the access type is inherited again or if this parameter template does not have a parent, the value will be set to null (the do not care value).
Calling this method will have no effects if the access type is already inherited.
-
isOptionalInherited
boolean isOptionalInherited()
Gets whether the optional flag for a parameter of this template is inherited from a parent entity, that is this template does not override the optional flag attribute of a template of a parent entity.- Returns:
- Whether the optional flag for a parameter of this template is inherited from a parent entity or the optional flag is provided by this template.
-
removeOwnOptional
void removeOwnOptional()
Removes the optional flag that overrides the optional flag provided by a corresponding parameter template from a parent entity. Afterwards the optional flag is inherited again or if this parameter template does not have a parent, the value will be set to null (the do not care value).
Calling this method will have no effects if the optional flag is already inherited.
-
isVirtualInherited
boolean isVirtualInherited()
Gets whether the virtual flag for a parameter of this template is inherited from a parent entity, that is this template does not override the virtual flag attribute of a template of a parent entity.- Returns:
- Whether the virtual flag for a parameter of this template is inherited from a parent entity or the virtual flag is provided by this template.
-
removeOwnVirtual
void removeOwnVirtual()
Removes the virtual flag that overrides the virtual flag provided by a corresponding parameter template from a parent entity. Afterwards the virtual flag is inherited again or if this parameter template does not have a parent, the value will be set to null (the do not care value).
Calling this method will have no effects if the virtual flag is already inherited.
-
isFailureInherited
boolean isFailureInherited()
Gets whether the failure flag for a parameter of this template is inherited from a parent entity, that is this template does not override the failure flag attribute of a template of a parent entity.- Returns:
- Whether the failure flag for a parameter of this template is inherited from a parent entity or the failure flag is provided by this template.
-
removeOwnFailure
void removeOwnFailure()
Removes the failure flag that overrides the failure flag provided by a corresponding parameter template from a parent entity. Afterwards the failure flag is inherited again or if this parameter template does not have a parent, the value will be set to null (the do not care value).
Calling this method will have no effects if the failure flag is already inherited.
-
isDefaultValueInherited
boolean isDefaultValueInherited()
Gets whether the string representation for the default value for a parameter of this template is inherited from a parent entity, that is this template does not override the string representation attribute for the default value of a template of a parent entity.- Returns:
- Whether the string representation for the default value for a parameter of this template is inherited from a parent entity or the string representation for the default value is provided by this template.
-
removeOwnDefaultValue
void removeOwnDefaultValue()
Removes the string representation for the default value that overrides the string representation for the default value provided by a corresponding parameter template from a parent entity. Afterwards the string representation for the default value is inherited again or if this parameter template does not have a parent, the value will be set to null (the do not care value).
Calling this method will have no effects if string representation for the default value is already inherited.
-
-