BrooklynProperties (Apache Brooklyn)

java.lang.Object
- java.util.AbstractMap<K,V>
- - java.util.HashMap<K,V>
  - - java.util.LinkedHashMap
    - - brooklyn.config.BrooklynProperties

All Implemented Interfaces:

ConfigMap, StringConfigMap, java.io.Serializable, java.lang.Cloneable, java.util.Map
```
public class BrooklynProperties
extends java.util.LinkedHashMap
implements StringConfigMap
```
utils for accessing command-line and system-env properties; doesn't resolve anything (unless an execution context is supplied) and treats ConfigKeys as of type object when in doubt, or string when that is likely wanted (e.g. getFirst(Map, String...)
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 BrooklynProperties.Factory
- Nested classes/interfaces inherited from class java.util.AbstractMap
  java.util.AbstractMap.SimpleEntry<K,V>, java.util.AbstractMap.SimpleImmutableEntry<K,V>

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

Method Summary

Methods
Modifier and Type	Method and Description
`BrooklynProperties`	`addEnvironmentVars()`
`BrooklynProperties`	`addFrom(ConfigBag cfg)`
`BrooklynProperties`	`addFrom(java.io.File f)`
`BrooklynProperties`	`addFrom(java.io.InputStream i)`
`BrooklynProperties`	`addFrom(java.util.Map map)`
`BrooklynProperties`	`addFrom(java.net.URL u)`
`BrooklynProperties`	`addFromMap(java.util.Map properties)` adds the indicated properties
`BrooklynProperties`	`addFromUrl(java.lang.String url)`
`BrooklynProperties`	`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
`BrooklynProperties`	`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
`BrooklynProperties`	`submap(com.google.common.base.Predicate<ConfigKey<?>> 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 brooklyn.config.ConfigMap
isEmpty, size

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

- Method Detail
  - addEnvironmentVars
```
public BrooklynProperties addEnvironmentVars()
```
  - addSystemProperties
```
public BrooklynProperties addSystemProperties()
```
  - addFrom
```
public BrooklynProperties addFrom(ConfigBag cfg)
```
  - addFrom
```
public BrooklynProperties addFrom(java.util.Map map)
```
  - addFrom
```
public BrooklynProperties addFrom(java.io.InputStream i)
```
  - addFrom
```
public BrooklynProperties addFrom(java.io.File f)
```
  - addFrom
```
public BrooklynProperties addFrom(java.net.URL u)
```
  - addFromUrl
```
public BrooklynProperties addFromUrl(java.lang.String url)
```
    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 BrooklynProperties 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
  - addFromMap
```
public BrooklynProperties addFromMap(java.util.Map properties)
```
    adds the indicated properties
  - putIfAbsent
```
public boolean putIfAbsent(java.lang.String key,
                  java.lang.Object value)
```
    inserts the value under the given key, if it was not present
  - 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).
  - 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
    
    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
  - 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
    
    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
    
    Overrides:
    
    putAll in class java.util.HashMap
  - put
```
public <T> java.lang.Object put(ConfigKey.HasConfigKey<T> key,
                       T value)
```
  - put
```
public <T> java.lang.Object put(ConfigKey<T> key,
                       T value)
```
  - putIfAbsent
```
public <T> boolean putIfAbsent(ConfigKey<T> key,
                      T value)
```
  - getConfig
```
public <T> T getConfig(ConfigKey<T> key)
```
    Specified by:
    
    getConfig in interface ConfigMap
    
    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
    
    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
    
    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
  - 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
  - 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
    
    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
  - submap
```
public BrooklynProperties submap(com.google.common.base.Predicate<ConfigKey<?>> filter)
```
    Description copied from interface: ConfigMap
    
    returns submap matching the given filter predicate; see ConfigPredicates for common predicates
    
    Specified by:
    
    submap in interface ConfigMap
  - 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

Class BrooklynProperties

Nested Class Summary

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

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 brooklyn.config.ConfigMap

Methods inherited from interface java.util.Map

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