Tree

java.lang.Object
- com.db4o.foundation.Tree<T>

All Implemented Interfaces:: DeepClone, ShallowClone, Visitable<T>

Direct Known Subclasses:: TreeInt, TreeObject

public abstract class Tree<T>
extends java.lang.Object
implements ShallowClone, DeepClone, Visitable<T>

Field Summary

Fields
Modifier and Type Field and Description

Tree<T> _preceding

int _size

Tree<T> _subsequent

Fields
Modifier and Type	Field and Description
`Tree<T>`	`_preceding`
`int`	`_size`
`Tree<T>`	`_subsequent`

Constructor Summary

Constructors
Constructor and Description

Tree()

Constructors
Constructor and Description
`Tree()`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`accept(Visitor4<T> visitor)`
`<V extends Tree<T>> V`	`add(V newNode)`
`<V extends Tree<T>> V`	`add(V newNode, int cmp)` On adding a node to a tree, if it already exists, and if Tree#duplicates() returns false, #isDuplicateOf() will be called.
`static <T,V extends Tree<T>> V`	`add(V oldTree, V newTree)`
`Tree`	`addedOrExisting()` On adding a node to a tree, if it already exists, and if Tree#duplicates() returns false, #onAttemptToAddDuplicate() will be called and the existing node will be stored in this._preceding.
`Tree`	`balance()`
`Tree`	`balanceCheckNulls()`
`void`	`calculateSize()`
`abstract int`	`compare(Tree a_to)` returns 0, if keys are equal uses this - other returns positive if this is greater than a_to returns negative if this is smaller than a_to
`java.lang.Object`	`deepClone(java.lang.Object a_param)` The parameter allows passing one new object so parent references can be corrected on children.
`static Tree`	`deepClone(Tree a_tree, java.lang.Object a_param)`
`boolean`	`duplicates()`
`Tree`	`filter(Predicate4 a_filter)`
`Tree<T>`	`find(Tree<T> template)`
`static <T> Tree<T>`	`find(Tree<T> inTree, Tree<T> template)`
`static Tree`	`findGreaterOrEqual(Tree a_in, Tree a_finder)`
`static Tree`	`findSmaller(Tree a_in, Tree a_node)`
`Tree<T>`	`first()`
`abstract T`	`key()`
`Tree`	`last()`
`static Tree`	`last(Tree tree)`
`int`	`nodes()`
`Tree`	`onAttemptToAddDuplicate(Tree oldNode)`
`int`	`ownSize()`
`Tree`	`remove()`
`void`	`removeChildren()`
`Tree`	`removeFirst()`
`static Tree`	`removeLike(Tree from, Tree a_find)`
`<V extends Tree<T>> V`	`removeLike(V a_find)`
`Tree`	`removeNode(Tree a_tree)`
`java.lang.Object`	`root()`
`Tree`	`rotateLeft()`
`Tree`	`rotateRight()`
`void`	`setSizeOwn()`
`void`	`setSizeOwnPlus(Tree tree)`
`void`	`setSizeOwnPlus(Tree tree1, Tree tree2)`
`void`	`setSizeOwnPreceding()`
`void`	`setSizeOwnPrecedingSubsequent()`
`void`	`setSizeOwnSubsequent()`
`java.lang.Object`	`shallowClone()`
`protected Tree`	`shallowCloneInternal(Tree tree)`
`int`	`size()`
`static int`	`size(Tree a_tree)`
`static void`	`traverse(Tree tree, Tree startingNode, CancellableVisitor4 visitor)` Traverses a tree with a starting point node.
`static void`	`traverse(Tree tree, Visitor4 visitor)`
`<V extends Tree<T>> void`	`traverse(Visitor4<V> visitor)`
`void`	`traverseFromLeaves(Visitor4 a_visitor)`
`boolean`	`wasAddedToTree()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

_preceding
```
public Tree<T> _preceding
```

_size
```
public int _size
```

_subsequent
```
public Tree<T> _subsequent
```

Constructor Detail
- Tree
```
public Tree()
```

Method Detail

add

public static final <T,V extends Tree<T>> V add(V oldTree,
                          V newTree)

add

public final <V extends Tree<T>> V add(V newNode)

add
```
public <V extends Tree<T>> V add(V newNode,
                        int cmp)
```
On adding a node to a tree, if it already exists, and if Tree#duplicates() returns false, #isDuplicateOf() will be called. The added node can then be asked for the node that prevails in the tree using #duplicateOrThis(). This mechanism allows doing find() and add() in one run.

addedOrExisting
```
public Tree addedOrExisting()
```
On adding a node to a tree, if it already exists, and if Tree#duplicates() returns false, #onAttemptToAddDuplicate() will be called and the existing node will be stored in this._preceding. This node node can then be asked for the node that prevails in the tree on adding, using the #addedOrExisting() method. This mechanism allows doing find() and add() in one run.

wasAddedToTree
```
public boolean wasAddedToTree()
```

balance
```
public final Tree balance()
```

balanceCheckNulls
```
public Tree balanceCheckNulls()
```

calculateSize
```
public void calculateSize()
```

compare
```
public abstract int compare(Tree a_to)
```
returns 0, if keys are equal uses this - other returns positive if this is greater than a_to returns negative if this is smaller than a_to

deepClone

public static Tree deepClone(Tree a_tree,
             java.lang.Object a_param)

deepClone
```
public java.lang.Object deepClone(java.lang.Object a_param)
```
Description copied from interface: DeepClone

The parameter allows passing one new object so parent references can be corrected on children.

Specified by:

deepClone in interface DeepClone

duplicates
```
public boolean duplicates()
```

filter

public final Tree filter(Predicate4 a_filter)

find

public static final <T> Tree<T> find(Tree<T> inTree,
               Tree<T> template)

find

public final Tree<T> find(Tree<T> template)

findGreaterOrEqual

public static final Tree findGreaterOrEqual(Tree a_in,
                      Tree a_finder)

findSmaller

public static final Tree findSmaller(Tree a_in,
               Tree a_node)

first
```
public final Tree<T> first()
```

last
```
public static Tree last(Tree tree)
```

last
```
public final Tree last()
```

onAttemptToAddDuplicate

public Tree onAttemptToAddDuplicate(Tree oldNode)

nodes
```
public int nodes()
```
Returns:
the number of nodes in this tree for balancing

ownSize
```
public int ownSize()
```

remove
```
public Tree remove()
```

removeChildren
```
public void removeChildren()
```

removeFirst
```
public Tree removeFirst()
```

removeLike

public static Tree removeLike(Tree from,
              Tree a_find)

removeLike

public final <V extends Tree<T>> V removeLike(V a_find)

removeNode

public final Tree removeNode(Tree a_tree)

rotateLeft
```
public final Tree rotateLeft()
```

rotateRight
```
public final Tree rotateRight()
```

setSizeOwn
```
public final void setSizeOwn()
```

setSizeOwnPrecedingSubsequent

public final void setSizeOwnPrecedingSubsequent()

setSizeOwnPreceding

public final void setSizeOwnPreceding()

setSizeOwnSubsequent

public final void setSizeOwnSubsequent()

setSizeOwnPlus

public final void setSizeOwnPlus(Tree tree)

setSizeOwnPlus

public final void setSizeOwnPlus(Tree tree1,
                  Tree tree2)

size
```
public static int size(Tree a_tree)
```

size
```
public int size()
```
Returns:
the number of objects represented.

traverse

public static final void traverse(Tree tree,
            Visitor4 visitor)

traverse

public static void traverse(Tree tree,
            Tree startingNode,
            CancellableVisitor4 visitor)

Traverses a tree with a starting point node. If there is no exact match for the starting node, the next higher will be taken.

traverse

public final <V extends Tree<T>> void traverse(Visitor4<V> visitor)

traverseFromLeaves

public final void traverseFromLeaves(Visitor4 a_visitor)

shallowCloneInternal

protected Tree shallowCloneInternal(Tree tree)

shallowClone
```
public java.lang.Object shallowClone()
```
Specified by:

shallowClone in interface ShallowClone

key
```
public abstract T key()
```

root
```
public java.lang.Object root()
```

accept
```
public void accept(Visitor4<T> visitor)
```
Specified by:

accept in interface Visitable<T>

Class Tree<T>

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

_preceding

_size

_subsequent

Constructor Detail

Tree

Method Detail

add

add

add

addedOrExisting

wasAddedToTree

balance

balanceCheckNulls

calculateSize

compare

deepClone

deepClone

duplicates

filter

find

find

findGreaterOrEqual

findSmaller

first

last

last

onAttemptToAddDuplicate

nodes

ownSize

remove

removeChildren

removeFirst

removeLike

removeLike

removeNode

rotateLeft

rotateRight

setSizeOwn

setSizeOwnPrecedingSubsequent

setSizeOwnPreceding

setSizeOwnSubsequent

setSizeOwnPlus

setSizeOwnPlus

size

size

traverse

traverse

traverse

traverseFromLeaves

shallowCloneInternal

shallowClone

key

root

accept