AbstractLocation (Apache Brooklyn)

java.lang.Object
- brooklyn.basic.AbstractBrooklynObject
- - brooklyn.location.basic.AbstractLocation

All Implemented Interfaces:

BrooklynObject, BrooklynObjectInternal, Rebindable, Configurable, Identifiable, LocationInternal, HasHostGeoInfo, Location, java.io.Serializable

Direct Known Subclasses:

AbstractCloudMachineProvisioningLocation, AggregatingMachineProvisioningLocation, FixedListMachineProvisioningLocation, MoreLocation, MultiLocation, PortForwardManagerImpl, ServerPoolLocation, SimpleLocation, SimulatedLocation, SshMachineLocation, WinRmMachineLocation
```
public abstract class AbstractLocation
extends AbstractBrooklynObject
implements LocationInternal, HasHostGeoInfo, Configurable
```
A basic implementation of the Location interface. This provides an implementation which works according to the requirements of the interface documentation, and is ready to be extended to make more specialized locations. Override configure(Map) to add special initialization logic.

See Also:
Serialized Form

Nested Class Summary
- Nested classes/interfaces inherited from interface brooklyn.basic.BrooklynObjectInternal
  BrooklynObjectInternal.ConfigurationSupportInternal
- Nested classes/interfaces inherited from interface brooklyn.basic.BrooklynObject
  BrooklynObject.TagSupport
- Nested classes/interfaces inherited from interface brooklyn.entity.trait.Configurable
  Configurable.ConfigurationSupport

Field Summary

Fields
Modifier and Type	Field and Description
`static org.slf4j.Logger`	`LOG` Deprecated. since 0.7.0 shouldn't be public
`static ConfigKey<Location>`	`PARENT_LOCATION`
`static ConfigKey<java.lang.Boolean>`	`TEMPORARY_LOCATION`

Fields inherited from interface brooklyn.location.basic.LocationInternal
FINAL_SPEC, NAMED_SPEC_NAME, ORIGINAL_SPEC

Constructor Summary

Constructors
Constructor and Description
`AbstractLocation()` Construct a new instance of an AbstractLocation.
`AbstractLocation(java.util.Map<?,?> properties)` Construct a new instance of an AbstractLocation.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`addChild(Location child)`
`<T> void`	`addExtension(java.lang.Class<T> extensionType, T extension)` Registers the given extension for the given type.
`BrooklynObjectInternal.ConfigurationSupportInternal`	`config()`
`AbstractLocation`	`configure(java.util.Map<?,?> properties)` Deprecated. since 0.7.0; only used for legacy brooklyn types where constructor is called directly; see overridden method for more info
`boolean`	`containsLocation(Location potentialDescendent)` Answers true if this location equals or is an ancestor of the given location.
`boolean`	`equals(java.lang.Object o)`
`java.util.Map<java.lang.String,java.lang.Object>`	`getAllConfig(boolean includeInherited)` Deprecated.
`ConfigBag`	`getAllConfigBag()` Deprecated.
`java.util.Collection<Location>`	`getChildren()` Get the 'children' of this location.
`<T> T`	`getConfig(ConfigKey.HasConfigKey<T> key)` Convenience method for `config().get(key)`
`<T> T`	`getConfig(ConfigKey<T> key)` Returns configuration set at this location or inherited or default.
`java.lang.String`	`getDisplayName()` A display name; recommended to be a concise single-line description.
`<T> T`	`getExtension(java.lang.Class<T> extensionType)` Returns an extension of the given type.
`HostGeoInfo`	`getHostGeoInfo()`
`ConfigBag`	`getLocalConfigBag()`
`Location`	`getParent()` Get the 'parent' of this location.
`ConfigBag`	`getRawLocalConfigBag()` Deprecated. since 0.7; use `getLocalConfigBag()`
`RebindSupport<LocationMemento>`	`getRebindSupport()` Users are strongly discouraged from calling or overriding this method.
`boolean`	`hasConfig(ConfigKey<?> key, boolean includeInherited)` Deprecated.
`boolean`	`hasExtension(java.lang.Class<?> extensionType)` Whether this location has support for the given extension type.
`int`	`hashCode()`
`boolean`	`isManaged()`
`void`	`onManagementStarted()`
`void`	`onManagementStopped()`
`boolean`	`removeChild(Location child)`
`<T> T`	`setConfig(ConfigKey<T> key, T value)` Deprecated.
`void`	`setDisplayName(java.lang.String newName)`
`void`	`setHostGeoInfo(HostGeoInfo hostGeoInfo)`
`void`	`setManagementContext(ManagementContextInternal managementContext)`
`void`	`setName(java.lang.String newName)` Deprecated. since 0.7.0; use `getDisplayName()`
`void`	`setParent(Location newParent)` Set the 'parent' of this location.
`void`	`setParent(Location newParent, boolean updateChildListParents)`
`java.util.Map<java.lang.String,java.lang.String>`	`toMetadataRecord()` Get a record of the metadata of this location.
`java.lang.String`	`toString()` Default String representation is simplified name of class, together with selected fields.
`java.lang.String`	`toVerboseString()`

Methods inherited from class brooklyn.basic.AbstractBrooklynObject
getCatalogItemId, getId, getManagementContext, getTagSupport, init, rebind, setCatalogItemId, tags

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

Methods inherited from interface brooklyn.location.basic.LocationInternal
getManagementContext

Methods inherited from interface brooklyn.basic.BrooklynObjectInternal
setCatalogItemId

Methods inherited from interface brooklyn.location.Location
getId

Methods inherited from interface brooklyn.basic.BrooklynObject
getCatalogItemId, getTagSupport, tags

- Field Detail
  - LOG
```
@Deprecated
public static final org.slf4j.Logger LOG
```
    Deprecated. since 0.7.0 shouldn't be public
  - PARENT_LOCATION
```
public static final ConfigKey<Location> PARENT_LOCATION
```
  - TEMPORARY_LOCATION
```
public static final ConfigKey<java.lang.Boolean> TEMPORARY_LOCATION
```
- Constructor Detail
  - AbstractLocation
```
public AbstractLocation()
```
    Construct a new instance of an AbstractLocation.
  - AbstractLocation
```
public AbstractLocation(java.util.Map<?,?> properties)
```
    Construct a new instance of an AbstractLocation. The properties map recognizes the following keys:
    - name - a name for the location
    - parentLocation - the parent Location
    Other common properties (retrieved via get/findLocationProperty) include:
    - latitude
    - longitude
    - displayName
    - iso3166 - list of iso3166-2 code strings
    - timeZone
    - abbreviatedName
- Method Detail
  - setManagementContext
```
public void setManagementContext(ManagementContextInternal managementContext)
```
    Overrides:
    
    setManagementContext in class AbstractBrooklynObject
  - configure
```
@Deprecated
public AbstractLocation configure(java.util.Map<?,?> properties)
```
    Deprecated. since 0.7.0; only used for legacy brooklyn types where constructor is called directly; see overridden method for more info
    
    Description copied from class: AbstractBrooklynObject
    
    Will set fields from flags, and put the remaining ones into the 'leftovers' map. For some types, you can find unused config via ConfigBag.getUnusedConfig().
    To be overridden by AbstractEntity, AbstractLoation, AbstractPolicy, AbstractEnricher, etc.
    But should not be overridden by specific entity types. If you do, the entity may break in subsequent releases. Also note that if you require fields to be initialized you must do that in this method. You must *not* rely on field initializers because they may not run until *after* this method (this method is invoked by the constructor in this class, so initializers in subclasses will not have run when this overridden method is invoked.)
  - isManaged
```
public boolean isManaged()
```
  - onManagementStarted
```
public void onManagementStarted()
```
  - onManagementStopped
```
public void onManagementStopped()
```
  - getDisplayName
```
public java.lang.String getDisplayName()
```
    Description copied from interface: BrooklynObject
    
    A display name; recommended to be a concise single-line description.
    
    Specified by:
    
    getDisplayName in interface BrooklynObject
    
    Specified by:
    
    getDisplayName in interface Location
    
    Returns:
    the name assigned to the location.
  - getParent
```
public Location getParent()
```
    Description copied from interface: Location
    
    Get the 'parent' of this location. Locations are organized into a tree hierarchy, and this method will return a reference to the parent of this location, or null if this location is the tree root.
    
    Specified by:
    
    getParent in interface Location
    
    Returns:
    a reference to the parent of this location, or null if this location is the tree root.
  - getChildren
```
public java.util.Collection<Location> getChildren()
```
    Description copied from interface: Location
    
    Get the 'children' of this location. Locations are organized into a tree hierarchy, and this method will return a collection containing the children of this location. This collection is an unmodifiable view of the data.
    
    Specified by:
    
    getChildren in interface Location
    
    Returns:
    a collection containing the children of this location.
  - setParent
```
public void setParent(Location newParent)
```
    Description copied from interface: Location
    
    Set the 'parent' of this location. If this location was previously a child of a different location, it is removed from the other location first. It is valid to pass in null to indicate that the location should be disconnected from its parent. Adds this location as a child of the new parent (see getChildLocations()).
    
    Specified by:
    
    setParent in interface Location
    
    Parameters:
    newParent - the new parent location object, or null to clear the parent reference.
  - setParent
```
public void setParent(Location newParent,
             boolean updateChildListParents)
```
  - config
```
public BrooklynObjectInternal.ConfigurationSupportInternal config()
```
    Specified by:
    
    config in interface BrooklynObjectInternal
    
    Specified by:
    
    config in interface Configurable
  - getConfig
```
public <T> T getConfig(ConfigKey.HasConfigKey<T> key)
```
    Description copied from interface: Location
    
    Convenience method for config().get(key)
    
    Specified by:
    
    getConfig in interface Location
    
    See Also:
    #getConfig(ConfigKey)}
  - getConfig
```
public <T> T getConfig(ConfigKey<T> key)
```
    Description copied from interface: Location
    
    Returns configuration set at this location or inherited or default. Convenience method for config().get(key)
    
    Specified by:
    
    getConfig in interface Location
  - hasConfig
```
@Deprecated
public boolean hasConfig(ConfigKey<?> key,
                           boolean includeInherited)
```
    Deprecated.
    
    Description copied from interface: Location
    
    True iff the indication config key is set, either inherited (second argument true) or locally-only (second argument false).
    
    Specified by:
    
    hasConfig in interface Location
  - getAllConfig
```
@Deprecated
public java.util.Map<java.lang.String,java.lang.Object> getAllConfig(boolean includeInherited)
```
    Deprecated.
    
    Description copied from interface: Location
    
    Returns all config set, either inherited (argument true) or locally-only (argument false).
    
    Specified by:
    
    getAllConfig in interface Location
  - getAllConfigBag
```
@Deprecated
public ConfigBag getAllConfigBag()
```
    Deprecated.
    
    Description copied from interface: LocationInternal
    
    Returns all config, including that inherited from parents. This method does not respect ConfigInheritance and so usage is discouraged.
    
    Specified by:
    
    getAllConfigBag in interface LocationInternal
  - getLocalConfigBag
```
public ConfigBag getLocalConfigBag()
```
    Specified by:
    
    getLocalConfigBag in interface LocationInternal
  - getRawLocalConfigBag
```
@Deprecated
public ConfigBag getRawLocalConfigBag()
```
    Deprecated. since 0.7; use getLocalConfigBag()
    
    Since:
    
    0.6
  - setConfig
```
@Deprecated
public <T> T setConfig(ConfigKey<T> key,
                         T value)
```
    Deprecated.
    
    Specified by:
    
    setConfig in interface Configurable
    
    Returns:
    the old value, or null if there was not one
  - setName
```
@Deprecated
public void setName(java.lang.String newName)
```
    Deprecated. since 0.7.0; use getDisplayName()
    
    Since:
    
    0.6.0 (?) - use getDisplayName
  - setDisplayName
```
public void setDisplayName(java.lang.String newName)
```
    Specified by:
    
    setDisplayName in class AbstractBrooklynObject
  - equals
```
public boolean equals(java.lang.Object o)
```
    Overrides:
    
    equals in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - containsLocation
```
public boolean containsLocation(Location potentialDescendent)
```
    Description copied from interface: Location
    
    Answers true if this location equals or is an ancestor of the given location.
    
    Specified by:
    
    containsLocation in interface Location
  - addChild
```
public void addChild(Location child)
```
  - removeChild
```
public boolean removeChild(Location child)
```
  - toString
```
public java.lang.String toString()
```
    Default String representation is simplified name of class, together with selected fields.
    
    Overrides:
    
    toString in class java.lang.Object
  - toVerboseString
```
public java.lang.String toVerboseString()
```
    Specified by:
    
    toVerboseString in interface Location
    
    Returns:
    meta-data about the location (usually a long line, or a small number of lines).
  - getHostGeoInfo
```
public HostGeoInfo getHostGeoInfo()
```
    Specified by:
    
    getHostGeoInfo in interface HasHostGeoInfo
  - setHostGeoInfo
```
public void setHostGeoInfo(HostGeoInfo hostGeoInfo)
```
  - getRebindSupport
```
public RebindSupport<LocationMemento> getRebindSupport()
```
    Description copied from interface: LocationInternal
    
    Users are strongly discouraged from calling or overriding this method. It is for internal calls only, relating to persisting/rebinding entities. This method may change (or be removed) in a future release without notice.
    
    Specified by:
    
    getRebindSupport in interface BrooklynObjectInternal
    
    Specified by:
    
    getRebindSupport in interface Rebindable
    
    Specified by:
    
    getRebindSupport in interface LocationInternal
  - hasExtension
```
public boolean hasExtension(java.lang.Class<?> extensionType)
```
    Description copied from interface: Location
    
    Whether this location has support for the given extension type. See additional comments in Location.getExtension(Class).
    
    Specified by:
    
    hasExtension in interface Location
  - getExtension
```
public <T> T getExtension(java.lang.Class<T> extensionType)
```
    Description copied from interface: Location
    
    Returns an extension of the given type. Note that the type must be an exact match for how the extension was registered (e.g. getExtension(Object.class) will not match anything, even though registered extension extend Object.
    This will not look at extensions of Location.getParent().
    
    Specified by:
    
    getExtension in interface Location
  - addExtension
```
public <T> void addExtension(java.lang.Class<T> extensionType,
                    T extension)
```
    Description copied from interface: LocationInternal
    
    Registers the given extension for the given type. If an extension already existed for this type, then this will override it.
    
    Specified by:
    
    addExtension in interface LocationInternal
  - toMetadataRecord
```
public java.util.Map<java.lang.String,java.lang.String> toMetadataRecord()
```
    Description copied from interface: LocationInternal
    
    Get a record of the metadata of this location.
    
    Metadata records are used to record an audit trail of events relating to location usage (for billing purposes, for example). Implementations (and subclasses) should override this method to return information useful for this purpose.
    
    Specified by:
    
    toMetadataRecord in interface LocationInternal
    
    Returns:

Class AbstractLocation

Nested Class Summary

Nested classes/interfaces inherited from interface brooklyn.basic.BrooklynObjectInternal

Nested classes/interfaces inherited from interface brooklyn.basic.BrooklynObject

Nested classes/interfaces inherited from interface brooklyn.entity.trait.Configurable

Field Summary

Fields inherited from interface brooklyn.location.basic.LocationInternal

Constructor Summary

Method Summary

Methods inherited from class brooklyn.basic.AbstractBrooklynObject

Methods inherited from class java.lang.Object

Methods inherited from interface brooklyn.location.basic.LocationInternal

Methods inherited from interface brooklyn.basic.BrooklynObjectInternal

Methods inherited from interface brooklyn.location.Location

Methods inherited from interface brooklyn.basic.BrooklynObject

Field Detail

LOG

PARENT_LOCATION

TEMPORARY_LOCATION

Constructor Detail

AbstractLocation

AbstractLocation

Method Detail

setManagementContext

configure

isManaged

onManagementStarted

onManagementStopped

getDisplayName

getParent

getChildren

setParent

setParent

config

getConfig

getConfig

hasConfig

getAllConfig

getAllConfigBag

getLocalConfigBag

getRawLocalConfigBag

setConfig

setName

setDisplayName

equals

hashCode

containsLocation

addChild

removeChild

toString

toVerboseString

getHostGeoInfo

setHostGeoInfo

getRebindSupport

hasExtension

getExtension

addExtension

toMetadataRecord