Package com.nomagic.uml2.ext.jmi.smartlistener

Class SmartListenerConfig

java.lang.Object
com.nomagic.uml2.ext.jmi.smartlistener.SmartListenerConfig
@OpenApiAll public class SmartListenerConfig extends Object

Smart listener configuration describes how to reach a specific property in the model from a given model element. Smart listener uses the configuration to create a chain of properties through which listener events map.

This class also contains predefined smart listener configurations which can be widely reused. Reusable smart listener configurations cannot be modified.

See Also:

  • Field Details

    • NAME_CONFIG

      public static final SmartListenerConfig NAME_CONFIG
      Listen to the name of the element.

    • DOCUMENTATION_CONFIG

      public static final SmartListenerConfig DOCUMENTATION_CONFIG
      Listen to the documentation of the element.

    • QUALIFIED_NAME_CONFIG

      public static final SmartListenerConfig QUALIFIED_NAME_CONFIG
      Listen to the qualified name of the element.

    • VALUE_SPECIFICATION_CONFIG

      public static final SmartListenerConfig VALUE_SPECIFICATION_CONFIG
      Listen to properties of ValueSpecification.

    • SLOT_VALUE_CONFIG

      public static final SmartListenerConfig SLOT_VALUE_CONFIG
      Listen to the value of Slot.

    • INSTANCE_SLOT_VALUE_CONFIG

      public static final SmartListenerConfig INSTANCE_SLOT_VALUE_CONFIG
      Listen to properties of Slot of InstanceSpecification.

    • STEREOTYPE_METACLASS_CONFIG

      public static final SmartListenerConfig STEREOTYPE_METACLASS_CONFIG
      Listen to the metaclass of Stereotype.

    • APPLIED_STEREOTYPE_CONFIG

      public static final SmartListenerConfig APPLIED_STEREOTYPE_CONFIG
      Listen to the applied stereotype.

    • APPLIED_STEREOTYPE_AND_TAGGED_VALUE_SHALLOW_CONFIG

      public static final SmartListenerConfig APPLIED_STEREOTYPE_AND_TAGGED_VALUE_SHALLOW_CONFIG
      Listens to applied stereotypes and tagged values values.

    • APPLIED_STEREOTYPE_NAME_CONFIG

      public static final SmartListenerConfig APPLIED_STEREOTYPE_NAME_CONFIG
      Listen to the applied stereotype's name.

    • APPLIED_STEREOTYPE_NAME_ICON_CONFIG

      public static final SmartListenerConfig APPLIED_STEREOTYPE_NAME_ICON_CONFIG
      Listen to the applied stereotype's name and icon

    • APPLIED_STEREOTYPE_NAME_AND_TAGGED_VALUE_DEEP_CONFIG

      public static final SmartListenerConfig APPLIED_STEREOTYPE_NAME_AND_TAGGED_VALUE_DEEP_CONFIG
      Listens to applied stereotype's name, tagged value values and tag definition properties.

    • APPLIED_STEREOTYPE_NAME_ICON_AND_TAGGED_VALUE_DEEP_CONFIG

      public static final SmartListenerConfig APPLIED_STEREOTYPE_NAME_ICON_AND_TAGGED_VALUE_DEEP_CONFIG
      Listens to applied stereotype (name and icon), tagged values (value and names of values), tag definition's name.

    • APPLIED_STEREOTYPE_NAME_ICON_AND_TAGGED_VALUE_SHALLOW_CONFIG

      public static final SmartListenerConfig APPLIED_STEREOTYPE_NAME_ICON_AND_TAGGED_VALUE_SHALLOW_CONFIG
      Listens to applied stereotype (name and icon), tagged values values. Does not listen deeper (properties of values).

    • TAGGED_VALUE_SHALLOW_CONFIG

      public static final SmartListenerConfig TAGGED_VALUE_SHALLOW_CONFIG
      Listens to applied tagged values values. Does not listen deeper (properties of values).

    • TAGGED_VALUE_DEEP_CONFIG

      public static final SmartListenerConfig TAGGED_VALUE_DEEP_CONFIG
      Listens to applied tagged values properties.

    • VALUE_OF_TAGGED_VALUE_CONFIG

      public static final SmartListenerConfig VALUE_OF_TAGGED_VALUE_CONFIG
      Listen to the properties of values of TaggedValue.

    • PARAMETER_SUBSTITUTION_CONFIG

      public static final SmartListenerConfig PARAMETER_SUBSTITUTION_CONFIG
      Listens to parameter substitution.

    • TRIGGER_CONFIG

      public static final SmartListenerConfig TRIGGER_CONFIG
      Listens to trigger.

    • TRANSITION_CONFIG

      public static final SmartListenerConfig TRANSITION_CONFIG
      Listens to transition.

    • MESSAGE_SIGNATURE_CONFIG

      public static final SmartListenerConfig MESSAGE_SIGNATURE_CONFIG
      Listens to message signature.

    • MESSAGE_CONFIG

      public static final SmartListenerConfig MESSAGE_CONFIG
      Listens to the message.

    • COMBINED_FRAGMENT_CONFIG

      public static final SmartListenerConfig COMBINED_FRAGMENT_CONFIG
      Listens to combined fragment.

    • CONVEYED_INFORMATION_CONFIG

      public static final SmartListenerConfig CONVEYED_INFORMATION_CONFIG
      Listens to conveyed information.

    • DIAGRAM_CONTEXT_CONFIG

      public static final SmartListenerConfig DIAGRAM_CONTEXT_CONFIG
      Listens to diagram context.

    • MULTIPLICITY_CONFIG

      public static final SmartListenerConfig MULTIPLICITY_CONFIG
      Listens to the multiplicity.

    • EMPTY_CONFIG

      public static final SmartListenerConfig EMPTY_CONFIG
      Configuration that does not listen to any properties

  • Constructor Details

    • SmartListenerConfig

      public SmartListenerConfig()
      Constructs empty configuration.

    • SmartListenerConfig

      public SmartListenerConfig(String propertyName)
      Constructs the configuration with a property name.
      Parameters:
      propertyName - property name to use as a reference
      See Also:

    • SmartListenerConfig

      public SmartListenerConfig(String propertyName, SmartListenerConfig config)
      Constructs the configuration.
      Parameters:
      propertyName - property name to use as a reference
      config - config to use with a property reference
      See Also:

    • SmartListenerConfig

      public SmartListenerConfig(Map<String,SmartListenerConfig> references)
      Constructs the configuration.
      Parameters:
      references - map of references to use

  • Method Details

    • initValueSpecificationConfig

      public static void initValueSpecificationConfig(SmartListenerConfig valueSpecificationConfig, SmartListenerConfig elementAsValueConfig)
      Initializes value specification config.
      Parameters:
      valueSpecificationConfig - config to initialize.
      elementAsValueConfig - element config to use.

    • makeUnmodifiable

      public void makeUnmodifiable()
      Make config unmodifiable. This means that new references can not be added or existing can not be changed. Any attempt to change unmodifiable config will end up with runtime exception.

    • copy

      public void copy(SmartListenerConfig config)
      Makes a shallow copy of the passed config to this config. Instances of configs in the tree are reused and not re-created.
      Parameters:
      config - passed configuration for copying.

    • deepCopy

      public void deepCopy(SmartListenerConfig config)
      Deep copies a passed config to this config. Whole config tree is copied by recreating referenced config instances.
      Parameters:
      config - config to copy

    • deepCopy

      public SmartListenerConfig deepCopy()
      Creates a deep copy of the specified smart listener config.
      Returns:
      copy

    • getReferences

      public Map<String,SmartListenerConfig> getReferences()
      Gets references of this configuration.
      Returns:
      references of this configuration

    • getPropertyConfig

      public SmartListenerConfig getPropertyConfig(String propertyName)
      Gets property config which is used for a particular property.
      Parameters:
      propertyName - property for which to get property config
      Returns:
      property config for a given property

    • listenTo

      public SmartListenerConfig listenTo(String referenceName, @CheckForNull SmartListenerConfig config)
      Listens to a given property and passes a smart listener configuration for it to apply if references are found among property values.
      Parameters:
      referenceName - property name for which configuration should be applied.
      config - passed configuration for the property. If for a given property an existing configuration is found, the two configurations will be merged and the merged configuration will be stored.
      Returns:
      self or a merged config if the configurations had to be merged

    • listenTo2

      @Deprecated public SmartListenerConfig listenTo2(String referenceName, SmartListenerConfig config)
      Deprecated.
      use listenTo(String, SmartListenerConfig), because it merges configs too.
      Makes the same thing as listenTo(String, SmartListenerConfig). Only if founds already registered property doesn't emit warning, but makes merge with already registered configuration. If configurations are merged, then passed config VALUE is replaced with a contents of merge result.
      Parameters:
      referenceName - property name for which configuration is applicable
      config - passed configuration. It's VALUE will be edited if another configuration will be found already registered by given reference name. VALUE of passed reference will be changed to the merged one
      Returns:
      self or a merged config if the configurations had to be merged

    • listenTo

      public SmartListenerConfig listenTo(String propertyName)
      Listens to a given property name.
      Parameters:
      propertyName - property name ot listen to.
      Returns:
      self or a merged config if the configurations had to be merged

    • listenTo

      public SmartListenerConfig listenTo(Collection<String> propertyNames)
      Listens to given properties' names.
      Parameters:
      propertyNames - properties' names to listen to
      Returns:
      self

    • listenTo

      public SmartListenerConfig listenTo(String... propertyNames)
      Listens to given properties' names.
      Parameters:
      propertyNames - properties' names to listen to
      Returns:
      self

    • listenToNested

      public SmartListenerConfig listenToNested(String propertyName)
      Listens to a nested property configuration.
      Parameters:
      propertyName - property name to listen to.
      Returns:
      property config of a given property, allows performing nested calls.

    • listenTo

      public SmartListenerConfig listenTo(SmartListenerConfig config)
      Merges information from given config.
      Parameters:
      config - config
      Returns:
      self

    • mergeConfigurations

      public static SmartListenerConfig mergeConfigurations(SmartListenerConfig c1, SmartListenerConfig c2)
      Merges two configurations into a single configuration.
      Parameters:
      c1 - first configuration to merge.
      c2 - second configuration to merge.
      Returns:
      merged configuration.

    • mergeConfigurations

      public static SmartListenerConfig mergeConfigurations(Collection<SmartListenerConfig> configurations)
      Merges given configurations into a single configuration.
      Parameters:
      configurations - configurations to merge
      Returns:
      merged configuration

    • dump

      public void dump()
      Dumps property configuration to the standard output.