BrooklynPropertiesImpl (Apache Brooklyn)

java.lang.Object
- java.util.AbstractMap<K,V>
- - java.util.HashMap<K,V>
  - - java.util.LinkedHashMap
    - - org.apache.brooklyn.core.internal.BrooklynPropertiesImpl

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.util.Map, ConfigMap, StringConfigMap, BrooklynProperties
```
public class BrooklynPropertiesImpl
extends java.util.LinkedHashMap
implements BrooklynProperties
```
TODO methods in this class are not thread safe. intention is that they are set during startup and not modified thereafter.

See Also:
Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class BrooklynPropertiesImpl.Factory
- Nested classes/interfaces inherited from class java.util.AbstractMap
  java.util.AbstractMap.SimpleEntry<K,V>, java.util.AbstractMap.SimpleImmutableEntry<K,V>
- Nested classes/interfaces inherited from interface java.util.Map
  java.util.Map.Entry<K,V>

Nested Classes
Modifier and Type	Class and Description
`static class`	`BrooklynPropertiesImpl.Factory`

Method Summary

Methods
Modifier and Type	Method and Description
`BrooklynPropertiesImpl`	`addEnvironmentVars()`
`BrooklynPropertiesImpl`	`addFrom(ConfigBag cfg)`
`BrooklynPropertiesImpl`	`addFrom(java.io.File f)`
`BrooklynPropertiesImpl`	`addFrom(java.io.InputStream i)`
`BrooklynPropertiesImpl`	`addFrom(java.util.Map map)`
`BrooklynPropertiesImpl`	`addFrom(java.net.URL u)`
`BrooklynPropertiesImpl`	`addFromMap(java.util.Map properties)` adds the indicated properties
`BrooklynPropertiesImpl`	`addFromUrl(java.lang.String url)`
`BrooklynPropertiesImpl`	`addFromUrlProperty(java.lang.String urlProperty)` expects a property already set in scope, whose value is acceptable to `addFromUrl(String)`; if property not set, does nothing
`BrooklynPropertiesImpl`	`addSystemProperties()`
`java.util.Map<java.lang.String,java.lang.Object>`	`asMapWithStringKeys()` returns a read-only map view which has string keys (corresponding to the config key names); callers encouraged to use the typed keys (and so not use this method), but in some compatibility areas having a Properties-like view is useful
`java.lang.String`	`get(java.util.Map flags, java.lang.String key)` Deprecated. attempts to call get with this syntax are probably mistakes; get(key, defaultValue) is fine but Map is unlikely the key, much more likely they meant getFirst(flags, key).
`java.util.Map<ConfigKey<?>,java.lang.Object>`	`getAllConfig()` returns a map of all config keys to their raw (unresolved+uncoerced) contents
`<T> T`	`getConfig(ConfigKey.HasConfigKey<T> key)`
`<T> T`	`getConfig(ConfigKey.HasConfigKey<T> key, T defaultValue)`
`<T> T`	`getConfig(ConfigKey<T> key)`
`<T> T`	`getConfig(ConfigKey<T> key, T defaultValue)` Returns value stored against the given key, resolved (if it is a Task, possibly blocking), and coerced to the appropriate type, or given default value if not set, unless the default value is null in which case it returns the default.
`Maybe<java.lang.Object>`	`getConfigRaw(ConfigKey<?> key, boolean includeInherited)` returns the value stored against the given key, not any default, not resolved (and guaranteed non-blocking), and not type-coerced.
`java.lang.String`	`getFirst(java.util.Map flags, java.lang.String... keys)` returns the value of the first key which is defined
`java.lang.String`	`getFirst(java.lang.String... keys)` returns the value of the first key which is defined
`java.lang.Object`	`getRawConfig(ConfigKey<?> key)` as `#getConfigRaw(ConfigKey)` but returning null if not present
`<T> java.lang.Object`	`put(ConfigKey.HasConfigKey<T> key, T value)`
`<T> java.lang.Object`	`put(ConfigKey<T> key, T value)`
`java.lang.Object`	`put(java.lang.Object key, java.lang.Object value)` like normal map.put, except config keys are dereferenced on the way in
`void`	`putAll(java.util.Map vals)` like normal map.putAll, except config keys are dereferenced on the way in
`<T> boolean`	`putIfAbsent(ConfigKey<T> key, T value)`
`boolean`	`putIfAbsent(java.lang.String key, java.lang.Object value)` inserts the value under the given key, if it was not present
`BrooklynPropertiesImpl`	`submap( filter)` returns submap matching the given filter predicate; see ConfigPredicates for common predicates
`java.lang.String`	`toString()`

Methods inherited from class java.util.LinkedHashMap
clear, containsValue, get

Methods inherited from class java.util.HashMap
clone, containsKey, entrySet, isEmpty, keySet, remove, size, values

Methods inherited from class java.util.AbstractMap
equals, hashCode

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map
clear, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, remove, size, values

Methods inherited from interface org.apache.brooklyn.config.ConfigMap
isEmpty, size

- Method Detail
  - addEnvironmentVars
```
public BrooklynPropertiesImpl addEnvironmentVars()
```
    Specified by:
    
    addEnvironmentVars in interface BrooklynProperties
  - addSystemProperties
```
public BrooklynPropertiesImpl addSystemProperties()
```
    Specified by:
    
    addSystemProperties in interface BrooklynProperties
  - addFrom
```
public BrooklynPropertiesImpl addFrom(ConfigBag cfg)
```
    Specified by:
    
    addFrom in interface BrooklynProperties
  - addFrom
```
public BrooklynPropertiesImpl addFrom(java.util.Map map)
```
    Specified by:
    
    addFrom in interface BrooklynProperties
  - addFrom
```
public BrooklynPropertiesImpl addFrom(java.io.InputStream i)
```
    Specified by:
    
    addFrom in interface BrooklynProperties
  - addFrom
```
public BrooklynPropertiesImpl addFrom(java.io.File f)
```
    Specified by:
    
    addFrom in interface BrooklynProperties
  - addFrom
```
public BrooklynPropertiesImpl addFrom(java.net.URL u)
```
    Specified by:
    
    addFrom in interface BrooklynProperties
  - addFromUrl
```
public BrooklynPropertiesImpl addFromUrl(java.lang.String url)
```
    Specified by:
    
    addFromUrl in interface BrooklynProperties
    
    See Also:
    of the form form file:///home/... or http:// or classpath://xx ; for convenience if not starting with xxx: it is treated as a classpath reference or a file; throws if not found (but does nothing if argument is null)
  - addFromUrlProperty
```
public BrooklynPropertiesImpl addFromUrlProperty(java.lang.String urlProperty)
```
    expects a property already set in scope, whose value is acceptable to addFromUrl(String); if property not set, does nothing
    
    Specified by:
    
    addFromUrlProperty in interface BrooklynProperties
  - addFromMap
```
public BrooklynPropertiesImpl addFromMap(java.util.Map properties)
```
    adds the indicated properties
    
    Specified by:
    
    addFromMap in interface BrooklynProperties
  - putIfAbsent
```
public boolean putIfAbsent(java.lang.String key,
                  java.lang.Object value)
```
    inserts the value under the given key, if it was not present
    
    Specified by:
    
    putIfAbsent in interface BrooklynProperties
  - get
```
@Deprecated
public java.lang.String get(java.util.Map flags,
                              java.lang.String key)
```
    Deprecated. attempts to call get with this syntax are probably mistakes; get(key, defaultValue) is fine but Map is unlikely the key, much more likely they meant getFirst(flags, key).
    
    Specified by:
    
    get in interface BrooklynProperties
  - getFirst
```
public java.lang.String getFirst(java.lang.String... keys)
```
    returns the value of the first key which is defined
    takes the following flags: 'warnIfNone', 'failIfNone' (both taking a boolean (to use default message) or a string (which is the message)); and 'defaultIfNone' (a default value to return if there is no such property); defaults to no warning and null response
    
    Specified by:
    
    getFirst in interface StringConfigMap
    
    Specified by:
    
    getFirst in interface BrooklynProperties
    
    See Also:
    StringConfigMap.getFirst(java.util.Map, String...)
  - getFirst
```
public java.lang.String getFirst(java.util.Map flags,
                        java.lang.String... keys)
```
    Description copied from interface: StringConfigMap
    
    returns the value of the first key which is defined
    takes the following flags: 'warnIfNone' or 'failIfNone' (both taking a boolean (to use default message) or a string (which is the message)); and 'defaultIfNone' (a default value to return if there is no such property); defaults to no warning and null default value
    
    Specified by:
    
    getFirst in interface StringConfigMap
    
    Specified by:
    
    getFirst in interface BrooklynProperties
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.util.AbstractMap
  - put
```
public java.lang.Object put(java.lang.Object key,
                   java.lang.Object value)
```
    like normal map.put, except config keys are dereferenced on the way in
    
    Specified by:
    
    put in interface java.util.Map
    
    Specified by:
    
    put in interface BrooklynProperties
    
    Overrides:
    
    put in class java.util.HashMap
  - putAll
```
public void putAll(java.util.Map vals)
```
    like normal map.putAll, except config keys are dereferenced on the way in
    
    Specified by:
    
    putAll in interface java.util.Map
    
    Specified by:
    
    putAll in interface BrooklynProperties
    
    Overrides:
    
    putAll in class java.util.HashMap
  - put
```
public <T> java.lang.Object put(ConfigKey.HasConfigKey<T> key,
                       T value)
```
    Specified by:
    
    put in interface BrooklynProperties
  - put
```
public <T> java.lang.Object put(ConfigKey<T> key,
                       T value)
```
    Specified by:
    
    put in interface BrooklynProperties
  - putIfAbsent
```
public <T> boolean putIfAbsent(ConfigKey<T> key,
                      T value)
```
    Specified by:
    
    putIfAbsent in interface BrooklynProperties
  - getConfig
```
public <T> T getConfig(ConfigKey<T> key)
```
    Specified by:
    
    getConfig in interface ConfigMap
    
    Specified by:
    
    getConfig in interface BrooklynProperties
    
    See Also:
    #getConfig(ConfigKey, Object), with default value as per the key, or null
  - getConfig
```
public <T> T getConfig(ConfigKey.HasConfigKey<T> key)
```
    Specified by:
    
    getConfig in interface ConfigMap
    
    Specified by:
    
    getConfig in interface BrooklynProperties
    
    See Also:
    #getConfig(ConfigKey, Object), with default value as per the key, or null
  - getConfig
```
public <T> T getConfig(ConfigKey.HasConfigKey<T> key,
              T defaultValue)
```
    Specified by:
    
    getConfig in interface ConfigMap
    
    Specified by:
    
    getConfig in interface BrooklynProperties
    
    See Also:
    #getConfig(ConfigKey, Object), with provided default value if not set
  - getConfig
```
public <T> T getConfig(ConfigKey<T> key,
              T defaultValue)
```
    Description copied from interface: ConfigMap
    
    Returns value stored against the given key, resolved (if it is a Task, possibly blocking), and coerced to the appropriate type, or given default value if not set, unless the default value is null in which case it returns the default.
    
    Specified by:
    
    getConfig in interface ConfigMap
    
    Specified by:
    
    getConfig in interface BrooklynProperties
  - getRawConfig
```
public java.lang.Object getRawConfig(ConfigKey<?> key)
```
    Description copied from interface: ConfigMap
    
    as #getConfigRaw(ConfigKey) but returning null if not present
    
    Specified by:
    
    getRawConfig in interface ConfigMap
    
    Specified by:
    
    getRawConfig in interface BrooklynProperties
  - getConfigRaw
```
public Maybe<java.lang.Object> getConfigRaw(ConfigKey<?> key,
                                   boolean includeInherited)
```
    Description copied from interface: ConfigMap
    
    returns the value stored against the given key, not any default, not resolved (and guaranteed non-blocking), and not type-coerced.
    
    Specified by:
    
    getConfigRaw in interface ConfigMap
    
    Specified by:
    
    getConfigRaw in interface BrooklynProperties
    
    Parameters:
    key - key to look up
    includeInherited - for ConfigMap instances which have an inheritance hierarchy, whether to traverse it or not; has no effects where there is no inheritance
    
    Returns:
    raw, unresolved, uncoerced value of key in map, but not any default on the key
  - getAllConfig
```
public java.util.Map<ConfigKey<?>,java.lang.Object> getAllConfig()
```
    Description copied from interface: ConfigMap
    
    returns a map of all config keys to their raw (unresolved+uncoerced) contents
    
    Specified by:
    
    getAllConfig in interface ConfigMap
    
    Specified by:
    
    getAllConfig in interface BrooklynProperties
  - submap
```
public BrooklynPropertiesImpl submap( filter)
```
    Description copied from interface: ConfigMap
    
    returns submap matching the given filter predicate; see ConfigPredicates for common predicates
    
    Specified by:
    
    submap in interface ConfigMap
    
    Specified by:
    
    submap in interface BrooklynProperties
  - asMapWithStringKeys
```
public java.util.Map<java.lang.String,java.lang.Object> asMapWithStringKeys()
```
    Description copied from interface: ConfigMap
    
    returns a read-only map view which has string keys (corresponding to the config key names); callers encouraged to use the typed keys (and so not use this method), but in some compatibility areas having a Properties-like view is useful
    
    Specified by:
    
    asMapWithStringKeys in interface ConfigMap
    
    Specified by:
    
    asMapWithStringKeys in interface BrooklynProperties

Class BrooklynPropertiesImpl

Nested Class Summary

Nested classes/interfaces inherited from class java.util.AbstractMap

Nested classes/interfaces inherited from interface java.util.Map

Method Summary

Methods inherited from class java.util.LinkedHashMap

Methods inherited from class java.util.HashMap

Methods inherited from class java.util.AbstractMap

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Map

Methods inherited from interface org.apache.brooklyn.config.ConfigMap

Method Detail

addEnvironmentVars

addSystemProperties

addFrom

addFrom

addFrom

addFrom

addFrom

addFromUrl

addFromUrlProperty

addFromMap

putIfAbsent

get

getFirst

getFirst

toString

put

putAll

put

put

putIfAbsent

getConfig

getConfig

getConfig

getConfig

getRawConfig

getConfigRaw

getAllConfig

submap

asMapWithStringKeys