com.aspc.remote.memory

Interface HashLongMap<T>

Type Parameters:

T - the type of object stored

All Superinterfaces:

java.lang.Cloneable, InterfaceSizeOf

All Known Implementing Classes:

HashLongMapCompare, HashLongMapV6, HashLongMapV7, HashLongMapV8

public interface HashLongMap<T>
extends InterfaceSizeOf, java.lang.Cloneable

This is a hacked version of HashMap for longs only keys. It prevents us from having to create objects for keys.
THREAD MODE: SINGLE-THREADED MEMORY USAGE: 144 bytes per Object

Since:

29 March 2002

Author:

Nigel Leck

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	HashLongMap.State the state of the multiple rows

Method Summary

Modifier and Type	Method and Description
long[]	briefKeyArray() create an array of the first 200 odd keys
void	clear() Removes all mappings from this map.
java.lang.Object	clone() clone the memory handler group.
boolean	containsKey(long key) Returns true if this map contains a mapping for the specified key.
boolean	containsValue(java.lang.Object value) Returns true if this map maps one or more keys to the specified value.
T	get(long key) Returns the value to which this map maps the specified key.
long[]	getKeyArray() create an array of the keys
long[][]	getKeyData() create an array of arrays for the keys.
long[]	getSortedKeyArray() create an array of the keys SORTED array.
boolean	isEmpty() Returns true if this map contains no key-value mappings.
boolean	isInitialized() is this hash map initialized.
boolean	isKeyArraySorted() Is the key array sorted ?
T	put(long key, T orginal) Associates the specified value with the specified key in this map.
void	putMultiRows(long[] rows, T value, HashLongMap.State stateOfRows) put multiple rows.
T	remove(long key) Removes the mapping for this key from this map if present.
int	size() Returns the number of key-value mappings in this map.
long	sizeOf() calculate the estimated size in bytes

Method Detail

size

@Nonnegative
 @CheckReturnValue
int size()

Returns the number of key-value mappings in this map.

Returns:

the number of key-value mappings in this map.

isEmpty

@CheckReturnValue
boolean isEmpty()

Returns true if this map contains no key-value mappings.

Returns:

true if this map contains no key-value mappings.

clone

@CheckReturnValue
 @Nonnull
java.lang.Object clone()
                                            throws java.lang.CloneNotSupportedException

clone the memory handler group.

Returns:

the new group.

Throws:

java.lang.CloneNotSupportedException - doesn't happen.

containsValue

@CheckReturnValue
boolean containsValue(@Nonnull
                                        java.lang.Object value)

Returns true if this map maps one or more keys to the specified value.

Parameters:

value - value whose presence in this map is to be tested.

Returns:

true if this map maps one or more keys to the specified value.

briefKeyArray

@CheckReturnValue
 @Nonnull
long[] briefKeyArray()

create an array of the first 200 odd keys

Returns:

the array

getKeyArray

@CheckReturnValue
 @Nonnull
long[] getKeyArray()

create an array of the keys

Returns:

the array

getKeyData

@CheckReturnValue
 @Nonnull
long[][] getKeyData()

create an array of arrays for the keys.

Returns:

the data array.

isKeyArraySorted

@CheckReturnValue
boolean isKeyArraySorted()

Is the key array sorted ?

Returns:

true if sorted

getSortedKeyArray

@CheckReturnValue
 @Nonnull
long[] getSortedKeyArray()

create an array of the keys SORTED array.

Returns:

the array

containsKey

@CheckReturnValue
boolean containsKey(long key)

Returns true if this map contains a mapping for the specified key.

Parameters:

key - key whose presence in this Map is to be tested.

Returns:

true if this map contains a mapping for the specified key.

get

@CheckReturnValue
 @Nullable
T get(long key)

Returns the value to which this map maps the specified key. Returns null if the map contains no mapping for this key. A return value of null does not necessarily indicate that the map contains no mapping for the key; it's also possible that the map explicitly maps the key to null. The containsKey operation may be used to distinguish these two cases.

Parameters:

key - key whose associated value is to be returned.

Returns:

the value to which this map maps the specified key.

put

@Nullable
T put(long key,
                T orginal)

Associates the specified value with the specified key in this map. If the map previously contained a mapping for this key, the old value is replaced.

Parameters:

orginal - The object to place into the table.

key - key with which the specified value is to be associated.

Returns:

previous value associated with specified key, or null if there was no mapping for key. A null return can also indicate that the HashMap previously associated null with the specified key.

putMultiRows

void putMultiRows(@Nonnull
                  long[] rows,
                  @Nullable
                  T value,
                  @Nonnull
                  HashLongMap.State stateOfRows)

put multiple rows.

Parameters:

rows - the rows

value - the value

stateOfRows - are these rows known to be sorted ? MAYBE null if you don't know

remove

@Nullable
T remove(long key)

Removes the mapping for this key from this map if present.

Parameters:

key - key whose mapping is to be removed from the map.

Returns:

previous value associated with specified key, or null if there was no mapping for key. A null return can also indicate that the map previously associated null with the specified key.

clear

void clear()

Removes all mappings from this map.

sizeOf

@CheckReturnValue
long sizeOf()

calculate the estimated size in bytes

Specified by:

sizeOf in interface InterfaceSizeOf

Returns:

the estimated size

isInitialized

@CheckReturnValue
boolean isInitialized()

is this hash map initialized.

Returns:

true if initialized.