org.safs.jvmagent

Class ComponentTracker

java.lang.Object

org.safs.jvmagent.ComponentTracker

public class ComponentTracker
extends java.lang.Object

This class is used to process component hierarchies into IDs and ArrayLists that do not pin down or hold references to actual component objects. Instead, we capture and store hierarchies of Integer hashCodes making component lookup fast, but not dangerous.

Author:

Carl Nagle

Constructor Summary

Constructors

Constructor and Description
ComponentTracker() Constructor for ComponentTracker.

Method Summary

Modifier and Type	Method and Description
java.awt.Component	getChildComponent(LocalAgentFactory lagents, java.awt.Component[] parent, ComponentItem child) Attempt to locate the real Component from the parent array using the child ComponentItem information.
ComponentItem	getComponentItem(java.lang.Integer key) Get a ComponentItem based on the stored Integer hashcode key or null if not found or invalid key.
java.util.ArrayList	getComponentItems(LocalAgentFactory lagents, java.awt.Component parent, java.util.ArrayList parentpath) Retrieve an ArrayList of ComponentItems representing the parent's children.
protected java.awt.Component	getMatchedComponent(java.awt.Component[] components, int hashcode) Retrieve the component in the array that has the matching hashcode.
void	putComponentItem(ComponentItem compItem) Add a ComponentItem to those being tracked.

Methods inherited from class java.lang.Object

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

Constructor Detail

ComponentTracker

public ComponentTracker()

Constructor for ComponentTracker.

Method Detail

putComponentItem

public void putComponentItem(ComponentItem compItem)

Add a ComponentItem to those being tracked.

getComponentItem

public ComponentItem getComponentItem(java.lang.Integer key)

Get a ComponentItem based on the stored Integer hashcode key or null if not found or invalid key.

getComponentItems

public java.util.ArrayList getComponentItems(LocalAgentFactory lagents,
                                             java.awt.Component parent,
                                             java.util.ArrayList parentpath)

Retrieve an ArrayList of ComponentItems representing the parent's children.

Parameters:

Component - parent from which to get child ComponentItems.

ArrayList - Integer hashCode hierarchy of the parent component. This is the same as the CompParents ArrayList within a ComponentItem. A TopLevel Window should have an ArrayList of just one Integer hashCode: itself.

Returns:

ArrayList of ComponentItems representing the parent's children. Zero-length ArrayList if the parent is not a Container or has no children.

getMatchedComponent

protected java.awt.Component getMatchedComponent(java.awt.Component[] components,
                                                 int hashcode)

Retrieve the component in the array that has the matching hashcode.

Parameters:

components - array to search for hashcode.

hashcode - to find in component array.

Returns:

Component matching hashcode or null.

getChildComponent

public java.awt.Component getChildComponent(LocalAgentFactory lagents,
                                            java.awt.Component[] parent,
                                            ComponentItem child)

Attempt to locate the real Component from the parent array using the child ComponentItem information. This is done by identifying Integer hashCode matches found in the child ComponentItem as we walk the parent trees.

Parameters:

Component[] - parent array (typically) of top level windows.

ComponentItem - child reference holding ArrayList of Integer hashCodes identifying the hierarchy to the target Component.

Returns:

Component matched or null if no match found.