com.inductiveautomation.ignition.common.config

Class BasicMutableConfigurationPropertyModel

java.lang.Object

com.inductiveautomation.ignition.common.config.BasicConfigurationPropertyModel

com.inductiveautomation.ignition.common.config.BasicMutableConfigurationPropertyModel

All Implemented Interfaces:

ConfigurationPropertyModel, MutableConfigurationPropertyModel, PropertyResolver, java.io.Serializable

public class BasicMutableConfigurationPropertyModel
extends BasicConfigurationPropertyModel
implements MutableConfigurationPropertyModel

This is the basic serializable version of the configuration property model.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	BasicMutableConfigurationPropertyModel.ClassifiedProperties<T>

Nested classes/interfaces inherited from class com.inductiveautomation.ignition.common.config.BasicConfigurationPropertyModel

BasicConfigurationPropertyModel.DefaultRankedProperty, BasicConfigurationPropertyModel.InternalProperty<T>, BasicConfigurationPropertyModel.RankedProperty

Field Summary

Fields inherited from interface com.inductiveautomation.ignition.common.config.ConfigurationPropertyModel

EMPTY_MODEL

Constructor Summary

Constructors

Constructor and Description
BasicMutableConfigurationPropertyModel()

Method Summary

Modifier and Type	Method and Description
void	addClassifiedProperties(java.lang.String classification, Property<?> prop, java.util.Collection<Property<?>> properties) Registers a set of properties that would be available for a given value of a certain classification.
<T> void	addClassifiedValue(java.lang.String classification, Property<T> keyProp, T value) This is where we associate a particular value with a certain classification.
<T> void	addDependantProperties(Property<T> prop, java.util.Collection<T> values, java.util.Collection<Property<?>> properties) Same as single-value registerDependentProperties, but when multiple values are valid.
<T> void	addDependantProperties(Property<T> prop, T value, java.util.Collection<Property<?>> properties) Registers properties that are only available if the specified property is equal to the given value.
void	addProperties(java.util.Collection<Property<?>> properties) Registers properties that are always editable.
long	getCurrentModelVersion() Returns the current model version, incremented when the model is changed.
ConfigurationPropertyModel	getModelSnapshot() Returns a serializable, non-mutable version of the model appropriate for sending to the designer or remote gateways.
protected void	incrementModelVersion()
void	markImmutable(Property<?> property) This effectively excludes a property from ever being "applicable".
static BasicMutableConfigurationPropertyModel	of(java.util.Collection<Property<?>> props)
static BasicMutableConfigurationPropertyModel	of(Property<?>... props)
<T> void	registerAllowedValues(Property<T> property, java.util.List<T> values) Registers a set of allowed values for the given property.
void	removeClassifiedProperties(java.lang.String classification, Property<?> keyProp)
<T> void	removeClassifiedValue(java.lang.String classification, Property<T> keyProp, T value)
<T> void	removeDependantProperties(Property<T> prop, T value) Removes all dependant properties for the given value.
void	removeProperties(java.util.Collection<Property<?>> properties) Unregisters tag properties.
<T> void	setAllowedValues(Property<T> property, java.util.List<T> values) Registers a set of allowed values for the given property.

Methods inherited from class com.inductiveautomation.ignition.common.config.BasicConfigurationPropertyModel

compareRankedProperties, connectDependency, contains, getAffectedProperties, getAllowedValues, getApplicableProperties, getModelProperties, isApplicable, isModelProperty, mergeTo, p, resolve

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.inductiveautomation.ignition.common.config.MutableConfigurationPropertyModel

addDependantProperties, addProperties, removeProperties

Methods inherited from interface com.inductiveautomation.ignition.common.config.ConfigurationPropertyModel

contains, getAffectedProperties, getAllowedValues, getApplicableProperties, getModelProperties, isApplicable, isModelProperty, mergeTo

Methods inherited from interface com.inductiveautomation.ignition.common.config.PropertyResolver

resolve

Constructor Detail

BasicMutableConfigurationPropertyModel

public BasicMutableConfigurationPropertyModel()

Method Detail

getCurrentModelVersion

public long getCurrentModelVersion()

Description copied from interface: ConfigurationPropertyModel

Returns the current model version, incremented when the model is changed.

Specified by:

getCurrentModelVersion in interface ConfigurationPropertyModel

Overrides:

getCurrentModelVersion in class BasicConfigurationPropertyModel

incrementModelVersion

protected void incrementModelVersion()

getModelSnapshot

public ConfigurationPropertyModel getModelSnapshot()

Description copied from interface: MutableConfigurationPropertyModel

Returns a serializable, non-mutable version of the model appropriate for sending to the designer or remote gateways.

Specified by:

getModelSnapshot in interface MutableConfigurationPropertyModel

of

public static BasicMutableConfigurationPropertyModel of(java.util.Collection<Property<?>> props)

of

public static BasicMutableConfigurationPropertyModel of(Property<?>... props)

markImmutable

public void markImmutable(Property<?> property)

Description copied from interface: MutableConfigurationPropertyModel

This effectively excludes a property from ever being "applicable". However, it's still used to evaluate dependencies. Therefore, it's used when we want sets of properties to be dependent on a value that should not be changed through any sort of editing UI.

Specified by:

markImmutable in interface MutableConfigurationPropertyModel

addProperties

public void addProperties(java.util.Collection<Property<?>> properties)

Description copied from interface: MutableConfigurationPropertyModel

Registers properties that are always editable.

Specified by:

addProperties in interface MutableConfigurationPropertyModel

removeProperties

public void removeProperties(java.util.Collection<Property<?>> properties)

Description copied from interface: MutableConfigurationPropertyModel

Unregisters tag properties. Only affects properties registered by registerProperties.

Specified by:

removeProperties in interface MutableConfigurationPropertyModel

registerAllowedValues

public <T> void registerAllowedValues(Property<T> property,
                                      java.util.List<T> values)

Description copied from interface: MutableConfigurationPropertyModel

Registers a set of allowed values for the given property. If values are already defined, these will be added to them.

Specified by:

registerAllowedValues in interface MutableConfigurationPropertyModel

setAllowedValues

public <T> void setAllowedValues(Property<T> property,
                                 java.util.List<T> values)

Description copied from interface: MutableConfigurationPropertyModel

Registers a set of allowed values for the given property. If values are already defined, they will be replaced. If the property is a string type, the empty string option will automatically be added. This function is primarily used by string options that want to allow selection from a list of profiles, or objects. Often these properties allow "" but don't provide it as a value from their model. If you really want to not allow the empty option, you can call setAllowedValues(p, null), and then call registerAllowedValues(...) with the values you want.

Specified by:

setAllowedValues in interface MutableConfigurationPropertyModel

addDependantProperties

public <T> void addDependantProperties(Property<T> prop,
                                       T value,
                                       java.util.Collection<Property<?>> properties)

Description copied from interface: MutableConfigurationPropertyModel

Registers properties that are only available if the specified property is equal to the given value.

Specified by:

addDependantProperties in interface MutableConfigurationPropertyModel

addDependantProperties

public <T> void addDependantProperties(Property<T> prop,
                                       java.util.Collection<T> values,
                                       java.util.Collection<Property<?>> properties)

Description copied from interface: MutableConfigurationPropertyModel

Same as single-value registerDependentProperties, but when multiple values are valid. Slightly more efficient than registering each value independently.

Specified by:

addDependantProperties in interface MutableConfigurationPropertyModel

removeDependantProperties

public <T> void removeDependantProperties(Property<T> prop,
                                          T value)

Description copied from interface: MutableConfigurationPropertyModel

Removes all dependant properties for the given value.

Specified by:

removeDependantProperties in interface MutableConfigurationPropertyModel

addClassifiedProperties

public void addClassifiedProperties(java.lang.String classification,
                                    Property<?> prop,
                                    java.util.Collection<Property<?>> properties)

Description copied from interface: MutableConfigurationPropertyModel

Registers a set of properties that would be available for a given value of a certain classification. This is typically used for properties registered by extension points. The type id is the "class", and then as profiles are added and removed, they are registered/unregistered with registerClassifiedValue.

Specified by:

addClassifiedProperties in interface MutableConfigurationPropertyModel

addClassifiedValue

public <T> void addClassifiedValue(java.lang.String classification,
                                   Property<T> keyProp,
                                   T value)

This is where we associate a particular value with a certain classification.

Specified by:

addClassifiedValue in interface MutableConfigurationPropertyModel

removeClassifiedProperties

public void removeClassifiedProperties(java.lang.String classification,
                                       Property<?> keyProp)

Specified by:

removeClassifiedProperties in interface MutableConfigurationPropertyModel

removeClassifiedValue

public <T> void removeClassifiedValue(java.lang.String classification,
                                      Property<T> keyProp,
                                      T value)

Specified by:

removeClassifiedValue in interface MutableConfigurationPropertyModel