com.metamatrix.common.object
Interface PropertyDefinition

All Superinterfaces:

java.lang.Comparable, ObjectDefinition, PropertiedObject

All Known Implementing Classes:

ComponentTypePropDefn, PropertyDefinitionImpl

public interface PropertyDefinition
extends ObjectDefinition

Defines the type of property that will be placed in a detail panel or table

Method Summary

java.util.List	getAllowedValues() Get the allowed values for this property.
java.lang.Object	getDefaultValue() Get the default value for values of this property, or an empty String if there is no default value.
PropertyType	getPropertyType() Get the type for values of this property.
PropertyDefinition.RestartType	getRequiresRestart() Get whether this property requires the system to be restarted before it takes effect.
boolean	hasDefaultValue() Return whether there is a default value for this property.
boolean	isConstrainedToAllowedValues() Return whether the value or values for this property are constrained to be only those in the AllowedValues list.
boolean	isExpert() The "expert" flag is used to distinguish between features that are intended for expert users from those that are intended for normal users.
boolean	isMasked() The "masked" flag is used to tell whether the value should be masked when displayed to users.
boolean	isModifiable() The modifiable flag is used to identify features that may not be changed once they are set.
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.

Methods inherited from interface com.metamatrix.common.object.ObjectDefinition

compareTo, equals, getDisplayName, getName, getPluralDisplayName, getShortDescription, getShortDisplayName, toString

Method Detail

getPropertyType

PropertyType getPropertyType()

Get the type for values of this property.

Returns:

the type that best describes the values of this property.

getDefaultValue

java.lang.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.

See Also:

hasDefaultValue()

getAllowedValues

java.util.List getAllowedValues()

Get the allowed values for this property.

Returns:

the unmodifiable list of allowed values for this property, or an empty set if the values do not have to conform to a fixed set.

See Also:

#hasAllowedValues

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:

#hasAllowedValues, getAllowedValues()

hasDefaultValue

boolean hasDefaultValue()

Return whether there is a default value for this property.

Returns:

true if this property has a default value or false if there is no default value.

See Also:

getDefaultValue()

isExpert

boolean isExpert()

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.