org.hawkular.agent.monitor.inventory

Class ResourceManager<L>

java.lang.Object

org.hawkular.agent.monitor.inventory.ResourceManager<L>

Type Parameters:

L - the type of the protocol specific location, typically a subclass of NodeLocation

public final class ResourceManager<L>
extends Object

Holds the graph of resources. The graph itself is never exposed externally - ResourceManager rather provides methods to retrieve data from the graph and to change the data in the graph.

Concurrency:

• All data and collections returned from ResourceManager is immutable
• ResourceManager uses a ReadWriteLock internally so that all public read and write operations can be performed from concurrent threads

Author:

John Mazzitelli, Peter Palaga

Constructor Summary

Constructors

Constructor and Description
ResourceManager()

Method Summary

Modifier and Type	Method and Description
void	addResource(Resource<L> newResource) Adds the given resource to the resource hierarchy.
List<Resource<L>>	findResources(L query, LocationResolver<L> locationResolver) Find the resources in resourcesGraph matching the given query.
Set<Resource<L>>	getChildren(Resource<L> resource) Returns an immutable Set of the direct children of the given resource.
Resource<L>	getParent(Resource<L> resource) Returns the direct parent of the given resource.
Resource<L>	getResource(ID resourceId) Given a resource ID this will return the resource with that ID or null if there is no resource with that ID.
List<Resource<L>>	getResourcesBreadthFirst() Returns an immutable List of all Resources contained in resourcesGraph in breadth-first order.
Set<Resource<L>>	getRootResources() Returns an immutable Set of Resources that are at the top of the hierarchy (that is, they do not have a parent).
void	logTreeGraph(String logMsg, long duration)
List<Resource<L>>	removeResources(L query, LocationResolver<L> locationResolver) Remove the resources from resourcesGraph matching the given query including all direct and indirect descendants.
void	replaceResources(List<Resource<L>> newResources) Replaces the set of Resources currently available in resourcesGraph with the resources from the given newResources list.

Methods inherited from class java.lang.Object

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

Constructor Detail

ResourceManager

public ResourceManager()

Method Detail

addResource

public void addResource(Resource<L> newResource)
                 throws IllegalArgumentException

Adds the given resource to the resource hierarchy. If the resource is a child of a parent, that parent must already be known or an exception is thrown.

Parameters:

newResource - the new resource to be added

Throws:

IllegalArgumentException - if the new resource's parent does not yet exist in the hierarchy

findResources

public List<Resource<L>> findResources(L query,
                                       LocationResolver<L> locationResolver)

Find the resources in resourcesGraph matching the given query.

Parameters:

query - a location eventually containing wildcards

locationResolver - the LocationResolver to perform the matching of graph nodes against the given query

Returns:

an unmodifiable list of Resources that match the given query

getChildren

public Set<Resource<L>> getChildren(Resource<L> resource)

Returns an immutable Set of the direct children of the given resource.

Parameters:

resource - the resource whose children are to be returned

Returns:

a Set if direct children of the given resource

getParent

public Resource<L> getParent(Resource<L> resource)

Returns the direct parent of the given resource.

Parameters:

resource - the resource whose parent is to be returned

Returns:

the direct parent of the given resource, or null if this is a root resource without a parent

getResource

public Resource<L> getResource(ID resourceId)

Given a resource ID this will return the resource with that ID or null if there is no resource with that ID.

Parameters:

resourceId - the ID of the resource to retrieve

Returns:

the resource or null

getResourcesBreadthFirst

public List<Resource<L>> getResourcesBreadthFirst()

Returns an immutable List of all Resources contained in resourcesGraph in breadth-first order.

Returns:

the list of all Resources

getRootResources

public Set<Resource<L>> getRootResources()

Returns an immutable Set of Resources that are at the top of the hierarchy (that is, they do not have a parent).

Returns:

a Set of root Resources

logTreeGraph

public void logTreeGraph(String logMsg,
                         long duration)

removeResources

public List<Resource<L>> removeResources(L query,
                                         LocationResolver<L> locationResolver)

Remove the resources from resourcesGraph matching the given query including all direct and indirect descendants.

Parameters:

query - a location eventually containing wildcards

locationResolver - the LocationResolver to perform the matching of graph nodes against the given query

Returns:

an unmodifiable list of Resources that were removed by this method

replaceResources

public void replaceResources(List<Resource<L>> newResources)
                      throws IllegalArgumentException

Replaces the set of Resources currently available in resourcesGraph with the resources from the given newResources list. Note that this method eventually replaces the graph instance in resourcesGraph together with neighborIndex and resourceCache.

Parameters:

newResources - a List of resources to replace the set of Resources currently available in resourcesGraph. newResources must be in breadth first order

Throws:

IllegalArgumentException - if the parent of any of the added resources is not in the graph.