Package de.aristaflow.adept2.model.processmodel.systemdata

Interface DependencyProvider

  • All Known Implementing Classes:
    NodeDependencyProvider, VolatileNodeDependencyProvider
    public interface DependencyProvider
    A DependencyProvider establishes the context for SystemDataConsumers and provides dependency-related information about them. This allows to implement editors (like the StaffAssignmentRuleDialogue) for SystemDataConsumers in a generic way, without having to know any details about which kinds of dependency types exist, what contextual arguments they have or what would be a suitable label text.
    Author:
    Patrick Schmidt

    • Method Detail

      • getParameters

        ParameterRef[] getParameters()
        Returns all already existing parameters. Use getDependencyOf(String) to retrieve dependency information about each parameter.
        Returns:
        all already existing parameters

      • parameterExists

        boolean parameterExists​(String parameterName)
        Returns whether a parameter with the specified name already exists.
        Parameters:
        parameterName - name of the parameter to be looked for
        Returns:
        whether a parameter with the specified name already exists

      • getDependencyOf

        Dependency getDependencyOf​(String parameterName)
        Returns dependency-related information about the parameter with the specified name or null if the parameter has currently no dependency bound to it or the parameter does not exist.
        Parameters:
        parameterName - the name of the parameter for which to return dependency-related information
        Returns:
        dependency-related information for the specified parameter

      • getCompleteDataTypeOf

        Pair<ProcessConstants.AdeptDataType,​String> getCompleteDataTypeOf​(String parameterName)
        Returns the data type (including the UDT name if appropriate) of the parameter with the specified name or null if the parameter does not exist.
        Parameters:
        parameterName - the name of the parameter for which to return dependency-related information
        Returns:
        The data type including the UDT name of the specified parameter. If the designated parameter does not exist, null will be returned. If the designated parameter is not ProcessConstants.AdeptDataType.USERDEFINED, the second element of the pair will be null.

      • getDependencyTypes

        Map<Object,​String> getDependencyTypes​(ProcessConstants.AdeptDataType dataType,
                                            UUID identifierID)
        Returns all available dependency types in a map. This number of dependency types can optionally be limited by specifying a data type and (also optionally} an identifier ID.

        The dependency types are represented by objects and used as keys in the maps. The value is a label text created by getLabelForType(Object).

        The map should have a specific, consistent order (-> e.g. LinkedHashMap).

        Parameters:
        dataType - data type to limit the number of returned dependency types; may be null for no restriction
        identifierID - identifier ID to further limit the number of returned dependency types; may be null for no restriction
        Returns:
        all available dependency types in a map (matching the optionally specified data type and identifier ID)

      • getDependencyTypeArguments

        Map<Dependency,​String> getDependencyTypeArguments​(Object dependencyType,
                                                        ProcessConstants.AdeptDataType dataType,
                                                        UUID identifierID)
        Returns all available dependencies for the specified dependency type in a map. The arguments are the dependencies while the value is a label text created by getLabelForType(Object).

        If the dependency type does not need any arguments a singleton map with null as key is returned. If the returned map is empty this means that there are no valid arguments which basically renders the dependency type unusable in the current context.

        The map should have a specific, consistent order (-> e.g. LinkedHashMap).

        Parameters:
        dependencyType - the dependency type for which to return available arguments
        dataType - data type to limit the number of returned dependency type arguments
        identifierID - identifier ID to further limit the number of returned dependency type arguments; may be null for no restriction
        Returns:
        all arguments for the specified dependency type in a map (matching the optionally specified data type and identifier ID)

      • getLabelForType

        String getLabelForType​(Object dependencyType)
        Returns a label text for the given dependency type.
        Parameters:
        dependencyType - dependency type for which to return a label
        Returns:
        a label text for the given dependency type

      • getLabelForArgument

        String getLabelForArgument​(Dependency dependency)
        Returns a label text for argument of the designated dependency.
        Parameters:
        dependency - The dependency of which to receive a label of the argument.
        Returns:
        A label text for the argument of the designated dependency.

      • getLabelForTypeAndArgument

        String getLabelForTypeAndArgument​(Dependency dependency)
        Returns a label text for the designated dependency.
        Parameters:
        dependency - the dependency for which to return a label
        Returns:
        a label text for the given dependency

      • getPreferredParameter

        ParameterRef getPreferredParameter​(Dependency dependency)
        Returns the preferred parameter name and type for the specified dependency. Each combination of dependency type and argument should have its own unique name. If a parameter for the dependency already exists, that parameter's name is returned instead, even if it doesn't have the preferred name. If the preferred name is already occupied by a parameter which is associated to a different dependency, a different parameter name is generated in a deterministic way.
        Parameters:
        dependency - the dependency for which to return the preferred parameter name
        Returns:
        the preferred parameter name for the specified dependency