Package de.aristaflow.adept2.model.common

Enum Class ParameterChangePolicy

java.lang.Object
java.lang.Enum<ParameterChangePolicy>
de.aristaflow.adept2.model.common.ParameterChangePolicy
All Implemented Interfaces:
Serializable, Comparable<ParameterChangePolicy>, java.lang.constant.Constable
public enum ParameterChangePolicy extends Enum<ParameterChangePolicy>
Generic operations do not have a fixed interface but may allow to change their input and output parameters. This requires the operation to detect the parameters at runtime. Parameters may be added, changed or removed depending on the operation. This corresponds to the behaviour of programming languages:
  • Adding, changing and removing resembles determining an operation at runtime via reflection.
  • Changing a parameter is comparable to a type hierarchy having a common super type and special subtypes. However, the type hierarchy has some constraints on the kind of changes that are allowed.
  • Adding a parameter is equal to a variable amount of parameters, "varargs " in Java.
This enum represents different types of changes that are allowed for operations. The order of the elements of the enum specifies the degree of "genericness" of the operation.
However, the change policies CHANGE_PARAMETERS and ADD_PARAMETERS are at the same level and are mutual exclusive.

In the inheritance of the activity model, the parameter change policy applies to the next level of entities for parameters, that is, when setting the parameter change policy from GENERIC to FIXED, one may change the parameters of the current entity but not that of the child entity.
However, the parameter change policy FIXED affects the parameter templates of the current entity. In this case no changes (no addition and no removal) are allowed for parameter templates. This does not make any sense since parameters may not be changed any more.

  • Enum Constant Details

    • GENERIC

      public static final ParameterChangePolicy GENERIC
      Parameters may be added, changed and removed arbitrarily.

    • ADD_CHANGE_PARAMETERS

      public static final ParameterChangePolicy ADD_CHANGE_PARAMETERS
      Parameters may be added and changed but not removed.

    • ADD_PARAMETERS

      public static final ParameterChangePolicy ADD_PARAMETERS
      Parameters may be added, but no parameters may be changed or removed. This is at the same level of "genericness" as CHANGE_PARAMETERS; these policies are mutual exclusive.

    • CHANGE_PARAMETERS

      public static final ParameterChangePolicy CHANGE_PARAMETERS
      Parameters may be changed, but no parameters may be added or removed. This is at the same level of "genericness" as ADD_PARAMETERS; these policies are mutual exclusive.

    • ADD_VIRTUAL

      public static final ParameterChangePolicy ADD_VIRTUAL
      Parameters may not added, changed or removed. Only virtual parameters may be added which allows to provide additional data flows outside of the process and beyond the interface of the operation.

    • FIXED

      public static final ParameterChangePolicy FIXED
      The interface of the operation is fixed; no parameters may be added, changed or removed even no virtual parameters. This is the normal change policy for operations without any generic behaviour.

  • Method Details

    • values

      public static ParameterChangePolicy[] values()
      Returns an array containing the constants of this enum class, in the order they are declared.
      Returns:
      an array containing the constants of this enum class, in the order they are declared

    • valueOf

      public static ParameterChangePolicy valueOf(String name)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum class has no constant with the specified name
      NullPointerException - if the argument is null

    • getCode

      public byte getCode()
      Returns a byte code representing this parameter change policy. This code is resilient to reordering or renaming the enum constants.
      Returns:
      a byte code representing this parameter change policy

    • valueOf

      public static ParameterChangePolicy valueOf(byte code)
      Returns the parameter change policy for the given code or null if the code is not recognised.
      Parameters:
      code - the code for which to find the parameter change policy
      Returns:
      the parameter change policy for the given code