Package de.aristaflow.adept2.model.execution

Interface InputDataContext

All Superinterfaces:
PluginDataContainer, UserAttributeContainer
All Known Subinterfaces:
DataContext, ParameterDataContext, SerialisableDataContext
All Known Implementing Classes:
SettableDataContext
public interface InputDataContext extends UserAttributeContainer, PluginDataContainer
This interface provides read access to all parameters of an application or a node. Access is based on the name of a parameter. It may be retrieved whether a parameter is null and the corresponding values.

  • Method Details

    • isNull

      boolean isNull(String parameterName) throws NoSuchParameterException
      Returns whether the value of the designated parameter is NULL which means the data element has not been written or has been consumed yet or has been explicitly set to NULL by a previous application. This method has to be called before retrieving a value.
      Parameters:
      parameterName - The name of the parameter to check on NULL.
      Returns:
      true if the value of the designated parameter is NULL and therefore has not been written or has been consumed yet.
      Throws:
      NoSuchParameterException - If the parameter of the designated name does not exist, a NoSuchParameterException will be thrown.

    • retrieveIntegerParameterValue

      long retrieveIntegerParameterValue(String parameterName) throws NoSuchParameterException, InvalidDataTypeException
      Reads from an input parameter. The associated value must be of type long.
      Callers should first check whether the value is NULL by calling isNull(String). Otherwise in case of NULL an IllegalStateException will be thrown.
      Parameters:
      parameterName - the name of the input parameter to be read
      Returns:
      The value for the designated input parameter.
      Throws:
      NoSuchParameterException - If the parameter of the designated name does not exist, a NoSuchParameterException will be thrown.
      InvalidDataTypeException - If the designated parameter is not of type INTEGER, an InvalidDataTypeException will be raised.
      IllegalStateException - If the value of the designated parameter is NULL, an IllegalStateException will be thrown.

    • retrieveFloatParameterValue

      double retrieveFloatParameterValue(String parameterName) throws NoSuchParameterException, InvalidDataTypeException
      Reads from an input parameter. The associated value must be of type double.
      Callers should first check whether the value is NULL by calling isNull(String). Otherwise in case of NULL an IllegalStateException will be thrown.
      Parameters:
      parameterName - the name of the input parameter to be read
      Returns:
      The value for the designated input parameter.
      Throws:
      NoSuchParameterException - If the parameter of the designated name does not exist, a NoSuchParameterException will be thrown.
      InvalidDataTypeException - If the designated parameter is not of type FLOAT, an InvalidDataTypeException will be raised.
      IllegalStateException - If the value of the designated parameter is NULL, an IllegalStateException will be thrown.

    • retrieveBooleanParameterValue

      boolean retrieveBooleanParameterValue(String parameterName) throws NoSuchParameterException, InvalidDataTypeException
      Reads from an input parameter. The associated value must be of type boolean.
      Callers should first check whether the value is NULL by calling isNull(String). Otherwise in case of NULL an IllegalStateException will be thrown.
      Parameters:
      parameterName - the name of the input parameter to be read
      Returns:
      The value for the designated input parameter.
      Throws:
      NoSuchParameterException - If the parameter of the designated name does not exist, a NoSuchParameterException will be thrown.
      InvalidDataTypeException - If the designated parameter is not of type BOOLEAN, an InvalidDataTypeException will be raised.
      IllegalStateException - If the value of the designated parameter is NULL, an IllegalStateException will be thrown.

    • retrieveStringParameterValue

      String retrieveStringParameterValue(String parameterName) throws NoSuchParameterException, InvalidDataTypeException
      Reads from an input parameter. The associated value must be of type String.
      Callers should first check whether the value is NULL by calling isNull(String). Otherwise in case of NULL an IllegalStateException will be thrown.
      Parameters:
      parameterName - the name of the input parameter to be read
      Returns:
      The value for the designated input parameter.
      Throws:
      NoSuchParameterException - If the parameter of the designated name does not exist, a NoSuchParameterException will be thrown.
      InvalidDataTypeException - If the designated parameter is not of type STRING, an InvalidDataTypeException will be raised.
      IllegalStateException - If the value of the designated parameter is NULL, an IllegalStateException will be thrown.

    • retrieveDateParameterValue

      Date retrieveDateParameterValue(String parameterName) throws NoSuchParameterException, InvalidDataTypeException
      Reads from an input parameter. The associated value must be of type java.util.Date.
      Callers should first check whether the value is NULL by calling isNull(String). Otherwise in case of NULL an IllegalStateException will be thrown.
      Parameters:
      parameterName - the name of the input parameter to be read
      Returns:
      The value for the designated input parameter.
      Throws:
      NoSuchParameterException - If the parameter of the designated name does not exist, a NoSuchParameterException will be thrown.
      InvalidDataTypeException - If the designated parameter is not of type DATE, an InvalidDataTypeException will be raised.
      IllegalStateException - If the value of the designated parameter is NULL, an IllegalStateException will be thrown.

    • retrieveURIParameterValue

      URI retrieveURIParameterValue(String parameterName) throws NoSuchParameterException, InvalidDataTypeException
      Reads from an input parameter. The associated value must be of type URI.
      Callers should first check whether the value is NULL by calling isNull(String). Otherwise in case of NULL an IllegalStateException will be thrown.
      Parameters:
      parameterName - the name of the input parameter to be read
      Returns:
      The value for the designated input 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.
      IllegalStateException - If the value of the designated parameter is NULL, an IllegalStateException will be thrown.

    • retrieveUDTParameterValue

      UDTValue retrieveUDTParameterValue(String parameterName) throws NoSuchParameterException, InvalidDataTypeException
      Reads from an input parameter. The associated value must be of an user-defined type.
      Callers should first check whether the value is NULL by calling isNull(String). Otherwise in case of NULL an IllegalStateException will be thrown.
      Parameters:
      parameterName - the name of the input parameter to be read
      Returns:
      The value for the designated input parameter. The UDTValue will be coupled to this InputDataContext, so do not close it; clone it if required longer than this InputDataContext.
      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.
      IllegalStateException - If the value of the designated parameter is NULL, an IllegalStateException will be thrown.