org.hawkular.agent.monitor.inventory

Class ResourceManager<T extends Resource<?,?,?,?,?>>

java.lang.Object

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

Type Parameters:

T - the kind of resource (DMR, JMX, etc)

public class ResourceManager<T extends Resource<?,?,?,?,?>>
extends Object

Manages an inventory of resources.

Author:

John Mazzitelli

Constructor Summary

Constructors

Constructor and Description
ResourceManager()

Method Summary

Modifier and Type	Method and Description
void	addResource(T newResource) Adds the given resource to the resource hierarchy.
Set<T>	getAllResources() Returns an unordered set of all resources currently being managed.
org.jgrapht.traverse.BreadthFirstIterator<T,org.jgrapht.graph.DefaultEdge>	getBreadthFirstIterator() Returns an iterator that let's you walk the tree of resources breadth-first.
Set<T>	getChildren(T resource) Returns the direct children of the given resource.
org.jgrapht.traverse.DepthFirstIterator<T,org.jgrapht.graph.DefaultEdge>	getDepthFirstIterator() Returns an iterator that let's you walk the tree of resources depth-first.
T	getParent(T resource) Returns the direct parent of the given resource.
T	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.
org.jgrapht.graph.ListenableDirectedGraph<T,org.jgrapht.graph.DefaultEdge>	getResourcesGraph()
Set<T>	getRootResources() Returns resources that are at the top of the hierarchy (that is, they do not have a parent).

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

getResourcesGraph

public org.jgrapht.graph.ListenableDirectedGraph<T,org.jgrapht.graph.DefaultEdge> getResourcesGraph()

Returns:

the internal graph of the resources being managed. Use with caution, changes to this graph are backed by this manager.

getBreadthFirstIterator

public org.jgrapht.traverse.BreadthFirstIterator<T,org.jgrapht.graph.DefaultEdge> getBreadthFirstIterator()

Returns an iterator that let's you walk the tree of resources breadth-first. Do NOT modify the resource hierarchy while iterating.

Returns:

an iterator that iterates the resource hierarchy breadth-first

getDepthFirstIterator

public org.jgrapht.traverse.DepthFirstIterator<T,org.jgrapht.graph.DefaultEdge> getDepthFirstIterator()

Returns an iterator that let's you walk the tree of resources depth-first. Do NOT modify the resource hierarchy while iterating.

Returns:

an iterator that iterates the resource hierarchy depth-first

getRootResources

public Set<T> getRootResources()

Returns resources that are at the top of the hierarchy (that is, they do not have a parent).

Returns:

root resources

getResource

public T 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

getChildren

public Set<T> getChildren(T resource)

Returns the direct children of the given resource.

Parameters:

resource - the resource whose children are to be returned

Returns:

the direct children of the given resource

getParent

public T getParent(T 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

getAllResources

public Set<T> getAllResources()

Returns an unordered set of all resources currently being managed.

Returns:

all resources

addResource

public void addResource(T 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