exchange.core2.collections.art

Class ArtNode48<V>

java.lang.Object

exchange.core2.collections.art.ArtNode48<V>

All Implemented Interfaces:

IArtNode<V>

public final class ArtNode48<V>
extends Object
implements IArtNode<V>

As the number of entries in a node increases, searching the key array becomes expensive. Therefore, nodes with more than 16 pointers do not store the keys explicitly. Instead, a 256-element array is used, which can be indexed with key bytes directly. If a node has between 17 and 48 child pointers, this array stores indexes into a second array which contains up to 48 pointers. This indirection saves space in comparison to 256 pointers of 8 bytes, because the indexes only require 6 bits (we use 1 byte for simplicity).

Constructor Summary

Constructors

Constructor and Description
ArtNode48(ObjectsPool objectsPool)

Method Summary

Modifier and Type	Method and Description
List<Map.Entry<Long,V>>	entries() For testing only
int	forEach(LongObjConsumer<V> consumer, int limit)
int	forEachDesc(LongObjConsumer<V> consumer, int limit)
V	getCeilingValue(long key, int level)
V	getFloorValue(long key, int level)
ObjectsPool	getObjectsPool()
V	getValue(long key, int level)
String	printDiagram(String prefix, int level) For testing only
IArtNode<V>	put(long key, int level, V value)
IArtNode<V>	remove(long key, int level)
int	size(int limit) Get number of elements Slow operation - O(n) complexity
String	toString()
void	validateInternalState(int level) For testing only

Methods inherited from class java.lang.Object

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

Constructor Detail

ArtNode48

public ArtNode48(ObjectsPool objectsPool)

Method Detail

getValue

public V getValue(long key,
                  int level)

Specified by:

getValue in interface IArtNode<V>

put

public IArtNode<V> put(long key,
                       int level,
                       V value)

Specified by:

put in interface IArtNode<V>

remove

public IArtNode<V> remove(long key,
                          int level)

Specified by:

remove in interface IArtNode<V>

getCeilingValue

public V getCeilingValue(long key,
                         int level)

Specified by:

getCeilingValue in interface IArtNode<V>

getFloorValue

public V getFloorValue(long key,
                       int level)

Specified by:

getFloorValue in interface IArtNode<V>

forEach

public int forEach(LongObjConsumer<V> consumer,
                   int limit)

Specified by:

forEach in interface IArtNode<V>

forEachDesc

public int forEachDesc(LongObjConsumer<V> consumer,
                       int limit)

Specified by:

forEachDesc in interface IArtNode<V>

size

public int size(int limit)

Description copied from interface: IArtNode

Get number of elements Slow operation - O(n) complexity

Specified by:

size in interface IArtNode<V>

Parameters:

limit - - can provide value to operation increase performance

Returns:

if returned value less than limit - it is precise size of the node

validateInternalState

public void validateInternalState(int level)

Description copied from interface: IArtNode

For testing only

Specified by:

validateInternalState in interface IArtNode<V>

Parameters:

level - level

entries

public List<Map.Entry<Long,V>> entries()

Description copied from interface: IArtNode

For testing only

Specified by:

entries in interface IArtNode<V>

Returns:

list of entries

printDiagram

public String printDiagram(String prefix,
                           int level)

Description copied from interface: IArtNode

For testing only

Specified by:

printDiagram in interface IArtNode<V>

Parameters:

prefix - prefix

level - level

Returns:

internal diagram part

getObjectsPool

public ObjectsPool getObjectsPool()

Specified by:

getObjectsPool in interface IArtNode<V>

toString

public String toString()

Overrides:

toString in class Object