de.aristaflow.adept2.model.runtimeenvironment

Interface DataContext

All Superinterfaces:

InputDataContext, PluginDataContainer, UserAttributeContainer

All Known Subinterfaces:

SerialisableDataContext

All Known Implementing Classes:

SettableDataContext

public interface DataContext
extends InputDataContext

This interface provides reading access to all input and output parameters of an application as well as write access to output parameters. Access is based on the name of a parameter. An application may retrieve whether a parameter (input or output) is null and the corresponding values.
The DataContext is provided by the runtime manager for the actual application. An InvalidExecutorThreadException will be thrown if the method is not called by the main thread of the corresponding component.

This data context may be read-only in which case all store-methods throw an UnsupportedOperationException. A read-only context is used for displaying purpose.

Author:

Ulrich Kreher

Method Summary

Modifier and Type	Method and Description
boolean	ignoredValue(java.lang.String parameterName) Returns whether the value of the designated output parameter is not or has not been set (ignored) by the application.
void	ignoreValue(java.lang.String parameterName) Ignores the value of the designated parameter that is the value has not been written.
boolean	isReadOnly() Returns whether this data container is read only and therefore does not allow to store values (and throws an UnsupportedOperationException at the corresponding methods).
void	storeBooleanParameterValue(java.lang.String parameterName, boolean value) Writes an output parameter of the type boolean to the data container of the process management system.
void	storeDateParameterValue(java.lang.String parameterName, java.util.Date value) Writes an output parameter of the type date to the data context of the process management system.
boolean	storedBooleanParameterValue(java.lang.String parameterName) Reads the boolean value of the designated output parameter.
java.util.Date	storedDateParameterValue(java.lang.String parameterName) Reads the date value of the designated output parameter.
double	storedFloatParameterValue(java.lang.String parameterName) Reads the double value of the designated output parameter.
long	storedIntegerParameterValue(java.lang.String parameterName) Reads the long value of the designated output parameter.
java.lang.String	storedStringParameterValue(java.lang.String parameterName) Reads the string value of the designated output parameter.
UDTValue	storedUDTParameterValue(java.lang.String parameterName) Reads the value of the designated output parameter of user-defined type.
java.net.URI	storedURIParameterValue(java.lang.String parameterName) Reads the URI value of the designated output parameter.
void	storeFloatParameterValue(java.lang.String parameterName, double value) Writes an output parameter of the type float to the data container of the process management system.
void	storeIntegerParameterValue(java.lang.String parameterName, long value) Writes an output parameter of the type integer (in java: long) to the data context of the process management system.
void	storeStringParameterValue(java.lang.String parameterName, java.lang.String value) Writes an output parameter of type String to the data container of the process management system.
void	storeUDTParameterValue(java.lang.String parameterName, UDTValue value) Writes an output parameter of an user defined type to the data container of the process management system.
void	storeURIParameterValue(java.lang.String parameterName, java.net.URI value) Writes an output parameter of type URI to the data container of the process management system.

Methods inherited from interface de.aristaflow.adept2.model.execution.InputDataContext

isNull, retrieveBooleanParameterValue, retrieveDateParameterValue, retrieveFloatParameterValue, retrieveIntegerParameterValue, retrieveStringParameterValue, retrieveUDTParameterValue, retrieveURIParameterValue

Methods inherited from interface de.aristaflow.adept2.model.common.UserAttributeContainer

getUserAttributes, getUserAttributeValue, removeUserAttributeValue, setUserAttributeValue

Methods inherited from interface de.aristaflow.adept2.model.common.PluginDataContainer

getPluginData, getPluginDatas, getSupportedPlugins

Method Detail

isReadOnly

boolean isReadOnly()

Returns whether this data container is read only and therefore does not allow to store values (and throws an UnsupportedOperationException at the corresponding methods).

Returns:

Whether this data container is read only and therefore does not allow to store values.

ignoreValue

void ignoreValue(java.lang.String parameterName)
          throws NoSuchParameterException

Ignores the value of the designated parameter that is the value has not been written.
An InvalidExecutorThreadException will be thrown if the method is not called by the main thread of the corresponding component.

Parameters:

parameterName - The name of the parameter to be ignored.

Throws:

NoSuchParameterException - If the parameter of the designated name does not exist, a NoSuchParameterException will be thrown.

java.lang.UnsupportedOperationException - If this data context is only for displaying purpose, an UnsupportedOperationException will be thrown.

ignoredValue

boolean ignoredValue(java.lang.String parameterName)
              throws NoSuchParameterException

Returns whether the value of the designated output parameter is not or has not been set (ignored) by the application.
An InvalidExecutorThreadException will be thrown if the method is not called by the main thread of the corresponding component.

Parameters:

parameterName - The name of the output parameter to check for being unset.

Returns:

true if the value of the designated output parameter is or has not been written.

Throws:

NoSuchParameterException - If the output parameter of the designated name does not exist, a NoSuchParameterException will be thrown.

storeIntegerParameterValue

void storeIntegerParameterValue(java.lang.String parameterName,
                                long value)
                         throws InvalidDataTypeException,
                                NoSuchParameterException

Writes an output parameter of the type integer (in java: long) to the data context of the process management system. The RuntimeEnvironment executes some management routines, e. g. access control, and delegates the function call to the DataContainer object.
An InvalidExecutorThreadException will be thrown if the method is not called by the main thread of the corresponding component.

Parameters:

parameterName - The name of the output parameter to be written.

value - The value that is written for the designated output parameter.

Throws:

InvalidDataTypeException - If the designated parameter is not of type INTEGER, an InvalidDataTypeException will be raised.

NoSuchParameterException - If the parameter of the designated name does not exist, a NoSuchParameterException will be thrown.

java.lang.UnsupportedOperationException - If this data context is only for displaying purpose, an UnsupportedOperationException will be thrown.

See Also:

DataContainer

storedIntegerParameterValue

long storedIntegerParameterValue(java.lang.String parameterName)
                          throws InvalidDataTypeException,
                                 NoSuchParameterException

Reads the long value of the designated output parameter.
An InvalidExecutorThreadException will be thrown if the method is not called by the main thread of the corresponding component.

Parameters:

parameterName - The name of the output parameter to be read.

Returns:

The value of the parameter of ADEPT2-type INTEGER and of Java-type long.

Throws:

InvalidDataTypeException - If the designated output parameter is not of type INTEGER, an InvalidDataTypeException will be raised.

NoSuchParameterException - If the output parameter of the designated name does not exist, a NoSuchParameterException will be thrown.

See Also:

ProcessConstants.AdeptDataType.INTEGER

storeFloatParameterValue

void storeFloatParameterValue(java.lang.String parameterName,
                              double value)
                       throws InvalidDataTypeException,
                              NoSuchParameterException

Writes an output parameter of the type float to the data container of the process management system. The RuntimeEnvironment executes some management routines, e. g. access control, and delegates the function call to the DataContainer object.
An InvalidExecutorThreadException will be thrown if the method is not called by the main thread of the corresponding component.

Parameters:

parameterName - The name of the output parameter to be written.

value - The value that is written for the designated output parameter.

Throws:

InvalidDataTypeException - If the designated parameter is not of type FLOAT, an InvalidDataTypeException will be raised.

NoSuchParameterException - If the parameter of the designated name does not exist, a NoSuchParameterException will be thrown.

java.lang.UnsupportedOperationException - If this data context is only for displaying purpose, an UnsupportedOperationException will be thrown.

See Also:

DataContainer

storedFloatParameterValue

double storedFloatParameterValue(java.lang.String parameterName)
                          throws InvalidDataTypeException,
                                 NoSuchParameterException

Reads the double value of the designated output parameter.
An InvalidExecutorThreadException will be thrown if the method is not called by the main thread of the corresponding component.

Parameters:

parameterName - The name of the output parameter to be read.

Returns:

The value of the output parameter of ADEPT2-type FLOAT and of Java-type double.

Throws:

InvalidDataTypeException - If the designated output parameter is not of type FLOAT, an InvalidDataTypeException will be raised.

NoSuchParameterException - If the output parameter of the designated name does not exist, a NoSuchParameterException will be thrown.

See Also:

ProcessConstants.AdeptDataType.FLOAT

storeBooleanParameterValue

void storeBooleanParameterValue(java.lang.String parameterName,
                                boolean value)
                         throws InvalidDataTypeException,
                                NoSuchParameterException

Writes an output parameter of the type boolean to the data container of the process management system. The RuntimeEnvironment executes some management routines, e. g. access control, and delegates the function call to the DataContainer object.
An InvalidExecutorThreadException will be thrown if the method is not called by the main thread of the corresponding component.

Parameters:

parameterName - The name of the output parameter to be written.

value - The value that is written for the designated output parameter.

Throws:

InvalidDataTypeException - If the designated parameter is not of type BOOLEAN, an InvalidDataTypeException will be raised.

NoSuchParameterException - If the parameter of the designated name does not exist, a NoSuchParameterException will be thrown.

java.lang.UnsupportedOperationException - If this data context is only for displaying purpose, an UnsupportedOperationException will be thrown.

See Also:

DataContainer

storedBooleanParameterValue

boolean storedBooleanParameterValue(java.lang.String parameterName)
                             throws InvalidDataTypeException,
                                    NoSuchParameterException

Reads the boolean value of the designated output parameter.
An InvalidExecutorThreadException will be thrown if the method is not called by the main thread of the corresponding component.

Parameters:

parameterName - The name of the output parameter to be read.

Returns:

The value of the output parameter of ADEPT2-type BOOLEAN and of Java-type boolean.

Throws:

InvalidDataTypeException - If the designated output parameter is not of type BOOLEAN, an InvalidDataTypeException will be raised.

NoSuchParameterException - If the output parameter of the designated name does not exist, a NoSuchParameterException will be thrown.

See Also:

ProcessConstants.AdeptDataType.BOOLEAN

storeStringParameterValue

void storeStringParameterValue(java.lang.String parameterName,
                               java.lang.String value)
                        throws InvalidDataTypeException,
                               NoSuchParameterException

Writes an output parameter of type String to the data container of the process management system. The RuntimeEnvironment executes some management routines, e. g. access control, and delegates the function call to the DataContainer object.
An InvalidExecutorThreadException will be thrown if the method is not called by the main thread of the corresponding component.

Parameters:

parameterName - The name of the output parameter to be written.

value - The value that is written for the designated output parameter.

Throws:

InvalidDataTypeException - If the designated parameter is not of type STRING, an InvalidDataTypeException will be raised.

NoSuchParameterException - If the parameter of the designated name does not exist, a NoSuchParameterException will be thrown.

java.lang.UnsupportedOperationException - If this data context is only for displaying purpose, an UnsupportedOperationException will be thrown.

See Also:

DataContainer

storedStringParameterValue

java.lang.String storedStringParameterValue(java.lang.String parameterName)
                                     throws InvalidDataTypeException,
                                            NoSuchParameterException

Reads the string value of the designated output parameter.
An InvalidExecutorThreadException will be thrown if the method is not called by the main thread of the corresponding component.

Parameters:

parameterName - The name of the output parameter to be read.

Returns:

The value of the output parameter of ADEPT2-type STRING and of Java-type String.

Throws:

InvalidDataTypeException - If the designated output parameter is not of type STRING, an InvalidDataTypeException will be raised.

NoSuchParameterException - If the output parameter of the designated name does not exist, a NoSuchParameterException will be thrown.

See Also:

ProcessConstants.AdeptDataType.STRING

storeDateParameterValue

void storeDateParameterValue(java.lang.String parameterName,
                             java.util.Date value)
                      throws InvalidDataTypeException,
                             NoSuchParameterException

Writes an output parameter of the type date to the data context of the process management system. The RuntimeEnvironment executes some management routines, e. g. access control, and delegates the function call to the DataContainer object.
An InvalidExecutorThreadException will be thrown if the method is not called by the main thread of the corresponding component.

Parameters:

parameterName - The name of the output parameter to be written.

value - The value that is written for the designated output parameter.

Throws:

InvalidDataTypeException - If the designated parameter is not of type DATE, an InvalidDataTypeException will be raised.

NoSuchParameterException - If the parameter of the designated name does not exist, a NoSuchParameterException will be thrown.

java.lang.UnsupportedOperationException - If this data context is only for displaying purpose, an UnsupportedOperationException will be thrown.

See Also:

DataContainer

storedDateParameterValue

java.util.Date storedDateParameterValue(java.lang.String parameterName)
                                 throws InvalidDataTypeException,
                                        NoSuchParameterException

Reads the date value of the designated output parameter.
An InvalidExecutorThreadException will be thrown if the method is not called by the main thread of the corresponding component.

Parameters:

parameterName - The name of the output parameter to be read.

Returns:

The value of the parameter of ADEPT2-type DATE and of Java-type java.util.Date.

Throws:

InvalidDataTypeException - If the designated output parameter is not of type DATE, an InvalidDataTypeException will be raised.

NoSuchParameterException - If the output parameter of the designated name does not exist, a NoSuchParameterException will be thrown.

See Also:

ProcessConstants.AdeptDataType.DATE

storeURIParameterValue

void storeURIParameterValue(java.lang.String parameterName,
                            java.net.URI value)
                     throws InvalidDataTypeException,
                            NoSuchParameterException

Writes an output parameter of type URI to the data container of the process management system. The RuntimeEnvironment executes some management routines, e. g. access control, and delegates the function call to the DataContainer object.
An InvalidExecutorThreadException will be thrown if the method is not called by the main thread of the corresponding component.

Parameters:

parameterName - The name of the output parameter to be written.

value - The value that is written for the designated output parameter.

Throws:

InvalidDataTypeException - If the designated parameter is not of type URI, an InvalidDataTypeException will be raised.

NoSuchParameterException - If the parameter of the designated name does not exist, a NoSuchParameterException will be thrown.

java.lang.UnsupportedOperationException - If this data context is only for displaying purpose, an UnsupportedOperationException will be thrown.

See Also:

DataContainer

storedURIParameterValue

java.net.URI storedURIParameterValue(java.lang.String parameterName)
                              throws InvalidDataTypeException,
                                     NoSuchParameterException

Reads the URI value of the designated output parameter.
An InvalidExecutorThreadException will be thrown if the method is not called by the main thread of the corresponding component.

Parameters:

parameterName - The name of the output parameter to be read.

Returns:

The value of the parameter of ADEPT2-type URI and of Java-type java.net.URI.

Throws:

InvalidDataTypeException - If the output designated parameter is not of type URI, an InvalidDataTypeException will be raised.

NoSuchParameterException - If the output parameter of the designated name does not exist, a NoSuchParameterException will be thrown.

See Also:

ProcessConstants.AdeptDataType.URI

storeUDTParameterValue

void storeUDTParameterValue(java.lang.String parameterName,
                            UDTValue value)
                     throws InvalidDataTypeException,
                            NoSuchParameterException

Writes an output parameter of an user defined type to the data container of the process management system. The RuntimeEnvironment executes some management routines, e. g. access control, and delegates the function call to the DataContainer object.
An InvalidExecutorThreadException will be thrown if the method is not called by the main thread of the corresponding component.

Parameters:

parameterName - The name of the output parameter to be written.

value - The value that is written for the designated output parameter.

Throws:

InvalidDataTypeException - If the designated parameter is not of type UDT, an InvalidDataTypeException will be raised.

NoSuchParameterException - If the parameter of the designated name does not exist, a NoSuchParameterException will be thrown.

java.lang.UnsupportedOperationException - If this data context is only for displaying purpose, an UnsupportedOperationException will be thrown.

See Also:

DataContainer

storedUDTParameterValue

UDTValue storedUDTParameterValue(java.lang.String parameterName)
                          throws InvalidDataTypeException,
                                 NoSuchParameterException

Reads the value of the designated output parameter of user-defined type.
An InvalidExecutorThreadException will be thrown if the method is not called by the main thread of the corresponding component.

Parameters:

parameterName - The name of the output parameter to be read.

Returns:

The value of the output parameter of ADEPT2-type USERDEFINED and of Java-type UDTValue.

Throws:

InvalidDataTypeException - If the designated output parameter is not of type USERDEFINED, an InvalidDataTypeException will be raised.

NoSuchParameterException - If the output parameter of the designated name does not exist, a NoSuchParameterException will be thrown.

See Also:

ProcessConstants.AdeptDataType.USERDEFINED