org.hawkular.agent.monitor.protocol.platform

Class PlatformLocationResolver

java.lang.Object

org.hawkular.agent.monitor.protocol.platform.PlatformLocationResolver

All Implemented Interfaces:

LocationResolver<PlatformNodeLocation>

public class PlatformLocationResolver
extends Object
implements LocationResolver<PlatformNodeLocation>

Author:

Peter Palaga

See Also:

LocationResolver

Constructor Summary

Constructors

Constructor and Description
PlatformLocationResolver()

Method Summary

Modifier and Type	Method and Description
PlatformNodeLocation	absolutize(PlatformNodeLocation base, PlatformNodeLocation location) Resolves the given location relative to the given base and returns the resolved location.
String	applyTemplate(String nameTemplate, PlatformNodeLocation location, String endpointName)
String	findWildcardMatch(PlatformNodeLocation multiTargetLocation, PlatformNodeLocation singleLocation) Given a multi-target location (e.g.
boolean	isMultiTarget(PlatformNodeLocation location) Returns true if the location could refer to more than one target.
boolean	isParent(PlatformNodeLocation parent, PlatformNodeLocation child) Returns true if the child is anywhere under the parent.
boolean	matches(PlatformNodeLocation query, PlatformNodeLocation location)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.hawkular.agent.monitor.protocol.LocationResolver

absolutize

Constructor Detail

PlatformLocationResolver

public PlatformLocationResolver()

Method Detail

findWildcardMatch

public String findWildcardMatch(PlatformNodeLocation multiTargetLocation,
                                PlatformNodeLocation singleLocation)
                         throws ProtocolException

Description copied from interface: LocationResolver

Given a multi-target location (e.g. a location with a wildcard) and a single location, this returns that portion of the single location that matches the multi-target wildcard.

Specified by:

findWildcardMatch in interface LocationResolver<PlatformNodeLocation>

Parameters:

multiTargetLocation - a query that was used to find the given singleLocation

singleLocation - a single absolute location that has the multiTargetLocation wildcard resolved

Returns:

the portion of the single location that matches the multi-target location wildcard

Throws:

ProtocolException - if the single location doesn't have any matching portion

isMultiTarget

public boolean isMultiTarget(PlatformNodeLocation location)

Description copied from interface: LocationResolver

Returns true if the location could refer to more than one target. For example, this typically will return true if the location has a wildcard in it. Note that just because this returns true does not mean there are multiple targets; there could be 0 or 1 or more. It depends on what the wildcard matches.

Specified by:

isMultiTarget in interface LocationResolver<PlatformNodeLocation>

Parameters:

location - the location to test

Returns:

true if location can refer to multiple targets, false if it refers to a single location

absolutize

public PlatformNodeLocation absolutize(PlatformNodeLocation base,
                                       PlatformNodeLocation location)

Description copied from interface: LocationResolver

Resolves the given location relative to the given base and returns the resolved location. Note that this method can eventually return location or base if the resolution would yield a Location equivalent to any of the two.

Specified by:

absolutize in interface LocationResolver<PlatformNodeLocation>

Parameters:

base - the base location to resolve location against

location - the location to resolve

Returns:

possibly a new resolved absolute location

isParent

public boolean isParent(PlatformNodeLocation parent,
                        PlatformNodeLocation child)

Description copied from interface: LocationResolver

Returns true if the child is anywhere under the parent. That means if the child is a direct descendant, is a grandchild, great-grandchild, etc, this will return true.

Specified by:

isParent in interface LocationResolver<PlatformNodeLocation>

Parameters:

parent - parent resource

child - child resource

Returns:

true if child is a descendant of the parent

matches

public boolean matches(PlatformNodeLocation query,
                       PlatformNodeLocation location)

Specified by:

matches in interface LocationResolver<PlatformNodeLocation>

applyTemplate

public String applyTemplate(String nameTemplate,
                            PlatformNodeLocation location,
                            String endpointName)

Specified by:

applyTemplate in interface LocationResolver<PlatformNodeLocation>