MMIR Framework

Class: ConfigurationManager

mmir. ConfigurationManager

mmir.ConfigurationManager

manager/settings/configurationManager.js, line 3
A class for managing the configuration.
It's purpose is to load the configuration and settings automatically. This "class" is structured as a singleton - so that only one instance is in use.

Requires

  • module:mmir.require

Methods

addListener(propertyName, listener)

manager/settings/configurationManager.js, line 538
Register listener for configuration changes.
Name Type Description
propertyName String | Array.<String> optional OPTIONAL The name of the property, to listen for changes: if unspecified, listener will be invoked on all configuration changes. If propertyName is an Array, it will be treated as if its entries were path-elements analogous to a dot-separated String propertyName. NOTE: dot-separated names will be resolved into object-structures, e.g. some.property will be resolved so that the value will set to: some: {property: <value>}
listener function the listener function that will be invoked when a configuration value is changed: 
listener(newValue: any, oldValue: any, propertyName: string)
See:

get(propertyName, defaultValue, useSafeAccess){any}

manager/settings/configurationManager.js, line 352
Returns the value of a property.
Name Type Description
propertyName String | Array.<String> if String: The name of the property. NOTE: If the property does not exists at the root-level, dot-separated names will be resolved into object-structures, e.g. some.property will be resolved so that the value at: some: {property: <value>} will be returned if String array: each entry corresponds to component in a dot-separated path (see above)
defaultValue any optional OPTIONAL a default value that will be returned, in case there is no property propertyName.
useSafeAccess Boolean optional OPTIONAL if true, resolution of dot-separated paths will be done "safely", i.e. if a path-element does not exists, no error will be thrown, but instead the function will return the defaultValue (which will be undefined if the argument is not given).
DEFAULT: true
NOTE: if this argument is used, param defaultValue must also be given!
Returns:
Type Description
any The value of the property

getBoolean(defaultValue)

manager/settings/configurationManager.js, line 476
Uses get. If the propertyName does not exists, returns undefined, otherwise values will be converted into Boolean values. Special case for Strings: the String "false" will be converted to Boolean value false.
Name Type Description
defaultValue any optional OPTIONAL if a default value is specified and there exists no property propertyName, the specified default value will be returned. NOTE: if this argument is used, useSafeAccess must also be given! NOTE: the default value will also be converted to a Boolean value, if necessary.
See:

getString(defaultValue)

manager/settings/configurationManager.js, line 515
Uses get. If the property does not exists, returns undefined, otherwise values will be converted into String values. If the value has not the type "string", it will be converted by JSON.stringify.
Name Type Description
defaultValue any optional OPTIONAL if a default value is specified and there exists no property propertyName, the specified default value will be returned. NOTE: if this argument is used, useSafeAccess must also be given! NOTE: the default value will also be converted to a String value, if necessary.
See:

off(propertyName, listener){boolean}

manager/settings/configurationManager.js, line 563
Remove listener for configuration changes: if listener was registered multiple times, the first one is removed.
Name Type Description
propertyName String | Array.<String> optional OPTIONAL The name of the property, to listen for changes: if unspecified, listener will be removed from list of listeners for all configuration changes, otherwise it will be removed from listeners for the specified property-path.
listener function the listener function that will be invoked when a configuration value is changed: 
listener(newValue: any, oldValue: any, propertyName: string)
See:
Returns:
Type Description
boolean true if a listener was removed, otherwise false.

on(propertyName, listener)

manager/settings/configurationManager.js, line 555
Register listener for configuration changes.
Name Type Description
propertyName String | Array.<String> optional OPTIONAL The name of the property, to listen for changes: if unspecified, listener will be invoked on all configuration changes. If propertyName is an Array, it will be treated as if its entries were path-elements analogous to a dot-separated String propertyName. NOTE: dot-separated names will be resolved into object-structures, e.g. some.property will be resolved so that the value will set to: some: {property: <value>}
listener function the listener function that will be invoked when a configuration value is changed: 
listener(newValue: any, oldValue: any, propertyName: string)
See:

removeListener(propertyName, listener){boolean}

manager/settings/configurationManager.js, line 546
Remove listener for configuration changes: if listener was registered multiple times, the first one is removed.
Name Type Description
propertyName String | Array.<String> optional OPTIONAL The name of the property, to listen for changes: if unspecified, listener will be removed from list of listeners for all configuration changes, otherwise it will be removed from listeners for the specified property-path.
listener function the listener function that will be invoked when a configuration value is changed: 
listener(newValue: any, oldValue: any, propertyName: string)
See:
Returns:
Type Description
boolean true if a listener was removed, otherwise false.

set(propertyName, value)

manager/settings/configurationManager.js, line 414
Sets a property to a given value.
Name Type Description
propertyName String | Array.<String> The name of the property. If propertyName is an Array, it will be treated as if its entries were path-elements analogous to a dot-separated String propertyName. NOTE: dot-separated names will be resolved into object-structures, e.g. some.property will be resolved so that the value will set to: some: {property: <value>}
value any The value of the property
Throws:
if the propertyName is dot-separated AND one of its path-elements (except for the last) already exists AND its type is not 'object'
Type
Error