Interface PropertyDefinition

    • Field Detail

      • UNBOUNDED_VALUE

        static final int UNBOUNDED_VALUE
        The value of the maximum multiplicity if the multiplicity is considered unbounded.
        See Also:
        Constant Field Values
    • Method Detail

      • getDisplayName

        String getDisplayName()
        Get the localized display name of this property.
        Returns:
        the displayable name for this property
      • getDescription

        String getDescription()
        Get the description of this property.
        Returns:
        the description for this property
      • getPropertyTypeClassName

        String getPropertyTypeClassName()
        Get the name of the java class that best represents the property type.
        Returns:
        the name of the java class that best represents the property type.
      • getDefaultValue

        Object getDefaultValue()
        Get the default value for values of this property, or an empty String if there is no default value.
        Returns:
        the default value for this property, or an empty String if there is no default value.
      • getAllowedValues

        Collection getAllowedValues()
        Get the allowed values for this property.
        Returns:
        the list of allowed values for this property, or an empty set if the values do not have to conform to a fixed set.
      • getRequiresRestart

        PropertyDefinition.RestartType getRequiresRestart()
        Get whether this property requires the system to be restarted before it takes effect.
        Returns:
        true if this property requires the system to be restarted before it takes effect.
      • isModifiable

        boolean isModifiable()
        The modifiable flag is used to identify features that may not be changed once they are set.
        Returns:
        true if this property is marked with the modifyable flag, or false otherwise.
      • isConstrainedToAllowedValues

        boolean isConstrainedToAllowedValues()
        Return whether the value or values for this property are constrained to be only those in the AllowedValues list.
        Returns:
        true if this property's value must be with the list of AllowedValues.
        See Also:
        getAllowedValues()
      • isAdvanced

        boolean isAdvanced()
        The "expert" flag is used to distinguish between features that are intended for expert users from those that are intended for normal users.
        Returns:
        true if this property is to be marked with the expert flag, or false otherwise.
      • isRequired

        boolean isRequired()
        The "required" flag is used to identify features that require at least one value (possibly a default value) by the consumer of the property. Whether a property definition is required or not can be determined entirely from the multiplicity: if the multiplicity includes '0', then the property is not required.

        Whether a property is required by the consumer is unrelated to whether there is a default value, which only simplifies the task of the property provider. A property may be required, meaning it must have at least one value, but that same property definition may or may not have a default. The combination of required and whether it has a default will determine whether the user must supply a value.

        Returns:
        true if this property requires at least one value.
      • isMasked

        boolean isMasked()
        The "masked" flag is used to tell whether the value should be masked when displayed to users.
        Returns:
        true if this property value is to be masked, or false otherwise.
      • getCategory

        String getCategory()
        Get the category of the property
        Returns:
        if null, no category exists