public class HashTree extends Object implements Serializable, Map<Object,HashTree>, Cloneable
HashTree implements the Map interface for convenience reasons. The main difference between a Map and a HashTree is that the HashTree organizes the data into a recursive tree structure, and provides the means to manipulate that structure.
Of special interest is the traverse(HashTreeTraverser)
method, which
provides an expedient way to traverse any HashTree by implementing the
HashTreeTraverser
interface in order to perform some operation on the
tree, or to extract information from the tree.
HashTreeTraverser
,
SearchByClass
,
Serialized FormModifier | Constructor and Description |
---|---|
|
HashTree()
Creates an empty new HashTree.
|
|
HashTree(Collection<?> keys)
Creates a new HashTree and adds all the objects in the given collection
as top-level nodes in the tree.
|
protected |
HashTree(Map<Object,HashTree> _map)
Allow subclasses to provide their own Map.
|
|
HashTree(Object key)
Creates a new HashTree and adds the given object as a top-level node.
|
|
HashTree(Object[] keys)
Creates a new HashTree and adds all the objects in the given array as
top-level nodes in the tree.
|
Modifier and Type | Method and Description |
---|---|
void |
add(Collection<?> keys)
Adds a bunch of keys into the HashTree at the current level.
|
void |
add(Collection<?> treePath,
Collection<?> values)
Adds a series of nodes into the HashTree using the given path.
|
HashTree |
add(Collection<?> treePath,
Object value)
Adds a series of nodes into the HashTree using the given path.
|
void |
add(Collection<?> treePath,
Object[] values)
Adds a series of nodes into the HashTree using the given path.
|
void |
add(HashTree newTree)
Adds all the nodes and branches of the given tree to this tree.
|
HashTree |
add(Object key)
Adds an key into the HashTree at the current level.
|
void |
add(Object[] keys)
Adds all the given objects as nodes at the current level.
|
void |
add(Object[] treePath,
Collection<?> values)
Adds a series of nodes into the HashTree using the given path.
|
HashTree |
add(Object[] treePath,
Object value) |
void |
add(Object[] treePath,
Object[] values)
Adds a series of nodes into the HashTree using the given path.
|
void |
add(Object key,
Collection<?> values)
Adds a key as a node at the current level and then adds all the objects
in the second argument as nodes of the new node.
|
void |
add(Object key,
HashTree subTree)
Adds a key as a node at the current level and then adds the given
HashTree to that new node.
|
HashTree |
add(Object key,
Object value)
Adds a key and it's value in the HashTree.
|
void |
add(Object key,
Object[] values)
Adds a key and it's values in the HashTree.
|
protected HashTree |
addTreePath(Collection<?> treePath) |
void |
clear()
Clears the HashTree of all contents.
|
Object |
clone()
Create a clone of this HashTree.
|
protected void |
cloneTree(HashTree newTree) |
boolean |
containsKey(Object o)
If the HashTree contains the given object as a key at the top level, then
a true result is returned, otherwise false.
|
boolean |
containsValue(Object value)
Implemented as required by the Map interface, but is not very useful
here.
|
protected HashTree |
createNewTree()
Creates a new tree.
|
protected HashTree |
createNewTree(Collection<?> values)
Creates a new tree.
|
protected HashTree |
createNewTree(Object key)
Creates a new tree.
|
Set<Map.Entry<Object,HashTree>> |
entrySet()
Exists to satisfy the Map interface.
|
boolean |
equals(Object o)
Compares all objects in the tree and verifies that the two trees contain
the same objects at the same tree levels.
|
HashTree |
get(Object key)
Returns the HashTree object associated with the given key.
|
Object[] |
getArray()
Gets an array of all keys in the current HashTree node.
|
Object[] |
getArray(Collection<?> treePath)
Recurses down into the HashTree structure using each subsequent key in the
treePath argument, and returns an array of keys of the HashTree object at
the end of the recursion.
|
Object[] |
getArray(Object key)
Gets an array of all keys in the HashTree mapped to the given key of the
current HashTree object (in other words, one level down).
|
Object[] |
getArray(Object[] treePath)
Recurses down into the HashTree structure using each subsequent key in the
array of keys, and returns an array of keys of the HashTree object at the
end of the recursion.
|
HashTree |
getTree(Collection<?> treePath)
Gets the HashTree object mapped to the last key in the SortedSet by
recursing through the HashTree structure one key at a time.
|
HashTree |
getTree(Object key)
Gets the HashTree mapped to the given key.
|
HashTree |
getTree(Object[] treePath)
Gets the HashTree object mapped to the last key in the array by recursing
through the HashTree structure one key at a time.
|
protected HashTree |
getTreePath(Collection<?> treePath) |
int |
hashCode()
Returns a hashcode for this HashTree.
|
boolean |
isEmpty()
If the HashTree is empty, true is returned, false otherwise.
|
Set<Object> |
keySet()
Returns a Set of all the keys in the top-level of this HashTree.
|
Collection<Object> |
list()
Gets a Collection of all keys in the current HashTree node.
|
Collection<?> |
list(Collection<?> treePath)
Recurses down into the HashTree structure using each subsequent key in the
List of keys, and returns the Set of keys of the HashTree object at the
end of the recursion.
|
Collection<?> |
list(Object key)
Gets a Set of all keys in the HashTree mapped to the given key of the
current HashTree object (in other words, one level down.
|
Collection<?> |
list(Object[] treePath)
Recurses down into the HashTree structure using each subsequent key in the
array of keys, and returns the Set of keys of the HashTree object at the
end of the recursion.
|
HashTree |
put(Object key,
HashTree value)
This is the same as calling HashTree.add(key,value).
|
void |
putAll(Map<?,? extends HashTree> map)
The Map given must also be a HashTree, otherwise an
UnsupportedOperationException is thrown.
|
HashTree |
remove(Object key)
Removes the entire branch specified by the given key.
|
void |
replaceKey(Object currentKey,
Object newKey)
Finds the given current key, and replaces it with the given new key.
|
HashTree |
search(Object key)
Searches the HashTree structure for the given key.
|
void |
set(Collection<?> values)
Sets the nodes of the current tree to be the objects of the given
collection.
|
void |
set(Collection<?> treePath,
Collection<?> values)
Sets a series of keys into the HashTree.
|
void |
set(Collection<?> treePath,
Object[] values)
Sets a series of keys into the HashTree.
|
void |
set(Object[] treePath,
Collection<?> values)
Sets a series of keys into the HashTree.
|
void |
set(Object[] treePath,
Object[] values)
Sets a series of keys into the HashTree.
|
void |
set(Object key,
Collection<?> values)
Sets a key and its values in the HashTree.
|
void |
set(Object key,
HashTree t)
Sets a key into the current tree and assigns it a HashTree as its
subtree.
|
void |
set(Object key,
Object value)
Sets a key and it's value in the HashTree.
|
void |
set(Object key,
Object[] values)
Sets a key and its values in the HashTree.
|
int |
size()
Returns the number of top-level entries in the HashTree.
|
String |
toString()
Generate a printable representation of the tree.
|
void |
traverse(HashTreeTraverser visitor)
Allows any implementation of the HashTreeTraverser interface to easily
traverse (depth-first) all the nodes of the HashTree.
|
Collection<HashTree> |
values()
Returns a collection of all the sub-trees of the current tree.
|
finalize, getClass, notify, notifyAll, wait, wait, wait
compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll
public HashTree()
protected HashTree(Map<Object,HashTree> _map)
_map
- Map
to usepublic HashTree(Object key)
key
- name of the new top-level nodepublic HashTree(Collection<?> keys)
keys
- a collection of objects to be added to the created HashTree.public HashTree(Object[] keys)
keys
- array with names for the new top-level nodespublic void putAll(Map<?,? extends HashTree> map)
putAll
in interface Map<Object,HashTree>
add(HashTree)
,
Map.putAll(Map)
public Set<Map.Entry<Object,HashTree>> entrySet()
entrySet
in interface Map<Object,HashTree>
Map.entrySet()
public boolean containsValue(Object value)
containsValue
in interface Map<Object,HashTree>
value
- Object to be tested as a value.Map.containsValue(Object)
public HashTree put(Object key, HashTree value)
put
in interface Map<Object,HashTree>
key
- to usevalue
- to store against keyMap.put(Object, Object)
public void clear()
clear
in interface Map<Object,HashTree>
Map.clear()
public Collection<HashTree> values()
values
in interface Map<Object,HashTree>
Map.values()
public void add(Object key, HashTree subTree)
key
- key to create in this treesubTree
- sub tree to add to the node created for the first argument.public void add(HashTree newTree)
newTree
- the tree to be addedpublic boolean containsKey(Object o)
containsKey
in interface Map<Object,HashTree>
o
- Object to be tested as a key.Map.containsKey(Object)
public boolean isEmpty()
public void set(Object key, Object value)
key
- key to be set upvalue
- value to be set up as a key in the secondary nodepublic void set(Object key, HashTree t)
key
- key to be set upt
- HashTree that the key maps topublic void set(Object key, Object[] values)
key
- Key to be set upvalues
- Array of objects to be added as keys in the secondary nodepublic void set(Object key, Collection<?> values)
key
- key to be set upvalues
- Collection of objects to be added as keys in the secondary
nodepublic void set(Object[] treePath, Object[] values)
treePath
- array of keys to put into HashTreevalues
- array of values to be added as keys to bottom-most nodepublic void set(Object[] treePath, Collection<?> values)
treePath
- array of keys to put into HashTreevalues
- Collection of values to be added as keys to bottom-most nodepublic void set(Collection<?> treePath, Object[] values)
treePath
- collection of keys to put into HashTreevalues
- array of values to be added as keys to bottom-most nodepublic void set(Collection<?> values)
values
- Collection of objects to set as nodes.public void set(Collection<?> treePath, Collection<?> values)
treePath
- list of keys to put into HashTreevalues
- collection of values to be added as keys to bottom-most nodepublic HashTree add(Object key)
key
- key to be added to HashTreepublic void add(Object[] keys)
keys
- Array of Keys to be added to HashTree.public void add(Collection<?> keys)
keys
- Collection of Keys to be added to HashTree.public HashTree add(Object key, Object value)
key
- key to be addedvalue
- value to be added as a key in the secondary nodevalue
is the keypublic void add(Object key, Object[] values)
key
- key to be addedvalues
- array of objects to be added as keys in the secondary nodepublic void add(Object key, Collection<?> values)
key
- key to be addedvalues
- Collection of objects to be added as keys in the secondary
nodepublic void add(Object[] treePath, Object[] values)
treePath
- an array of objects representing a pathvalues
- array of values to be added as keys to bottom-most nodepublic void add(Object[] treePath, Collection<?> values)
treePath
- an array of objects representing a pathvalues
- collection of values to be added as keys to bottom-most nodepublic void add(Collection<?> treePath, Object[] values)
treePath
- a list of objects representing a pathvalues
- array of values to be added as keys to bottom-most nodepublic HashTree add(Collection<?> treePath, Object value)
treePath
- a list of objects representing a pathvalue
- Object to add as a node to bottom-most nodevalue
is the keypublic void add(Collection<?> treePath, Collection<?> values)
treePath
- a SortedSet of objects representing a pathvalues
- Collection of values to be added as keys to bottom-most nodeprotected HashTree addTreePath(Collection<?> treePath)
public HashTree getTree(Object key)
key
- Key used to find appropriate HashTree()key
public HashTree get(Object key)
getTree(Object)
.get
in interface Map<Object,HashTree>
Map.get(Object)
public HashTree getTree(Object[] treePath)
treePath
- array of keys.public Object clone()
protected void cloneTree(HashTree newTree)
protected HashTree createNewTree()
protected HashTree createNewTree(Object key)
key
- object to use as the key for the top levelHashTree
protected HashTree createNewTree(Collection<?> values)
public HashTree getTree(Collection<?> treePath)
treePath
- Collection of keyspublic Collection<Object> list()
public Collection<?> list(Object key)
key
- key used to find HashTree to get list ofpublic HashTree remove(Object key)
remove
in interface Map<Object,HashTree>
Map.remove(Object)
public Collection<?> list(Object[] treePath)
treePath
- Array of keys used to recurse into HashTree structurepublic Collection<?> list(Collection<?> treePath)
treePath
- List of keys used to recurse into HashTree structurepublic void replaceKey(Object currentKey, Object newKey)
currentKey
- name of the key to be replacednewKey
- name of the new keypublic Object[] getArray()
public Object[] getArray(Object key)
key
- key used to find HashTree to get list ofpublic Object[] getArray(Object[] treePath)
treePath
- array of keys used to recurse into HashTree structurepublic Object[] getArray(Collection<?> treePath)
treePath
- list of keys used to recurse into HashTree structureprotected HashTree getTreePath(Collection<?> treePath)
public int hashCode()
public boolean equals(Object o)
public Set<Object> keySet()
keySet
in interface Map<Object,HashTree>
Map.keySet()
public HashTree search(Object key)
key
- Key to search fornull
public int size()
size
in interface Map<Object,HashTree>
Map.size()
public void traverse(HashTreeTraverser visitor)
visitor
- the visitor that wants to traverse the treeHashTreeTraverser
Copyright © 1998-2019 Apache Software Foundation. All Rights Reserved.