Byte2ObjectOrderedMap (Primitive-Collections 0.8.0 API)

Type Parameters:

V - the keyType of elements maintained by this Collection

All Superinterfaces:

Byte2ObjectMap<V>, ByteFunction<V>, java.util.Map<java.lang.Byte,V>

All Known Implementing Classes:

Byte2ObjectArrayMap, Byte2ObjectLinkedOpenCustomHashMap, Byte2ObjectLinkedOpenHashMap, Byte2ObjectMaps.SynchronizedOrderedMap, Byte2ObjectMaps.UnmodifyableOrderedMap, ImmutableByte2ObjectOpenHashMap
```
public interface Byte2ObjectOrderedMap<V>
extends Byte2ObjectMap<V>
```
A Special Map Interface giving Access to some really usefull functions The Idea behind this interface is to allow access to functions that give control to the Order of elements. Since Linked implementations as examples can be reordered outside of the Insertion Order. This interface provides basic access to such functions while also providing some Sorted/NaivgableMap implementations that still fit into here.

Nested Class Summary

Nested Classes
Modifier and Type	Interface and Description
`static interface`	`Byte2ObjectOrderedMap.FastOrderedSet<V>` Fast Ordered Entry Set that allows for a faster Entry Iterator by recycling the Entry Object and just exchanging 1 internal value

Nested classes/interfaces inherited from interface speiger.src.collections.bytes.maps.interfaces.Byte2ObjectMap
Byte2ObjectMap.BuilderCache<V>, Byte2ObjectMap.Entry<V>, Byte2ObjectMap.FastEntrySet<V>, Byte2ObjectMap.MapBuilder

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`ObjectOrderedSet<Byte2ObjectMap.Entry<V>>`	`byte2ObjectEntrySet()` Type Sensitive EntrySet to reduce boxing/unboxing and optionally Temp Object Allocation.
`Byte2ObjectOrderedMap<V>`	`copy()` A Function that does a shallow clone of the Map itself.
`byte`	`firstByteKey()` A method to get the first Key of a Map.
`V`	`firstValue()` A method to get the first Value of a Map.
`V`	`getAndMoveToFirst(byte key)` A Specific get method that allows to move teh given key/value int the first index.
`V`	`getAndMoveToLast(byte key)` A Specific get method that allows to move teh given key/value int the last index.
`ByteOrderedSet`	`keySet()`
`byte`	`lastByteKey()` A method to get the last Key of a Map.
`V`	`lastValue()` A method to get the last Value of a Map.
`boolean`	`moveToFirst(byte key)` A specific move method to move a given key/value to the first index.
`boolean`	`moveToLast(byte key)` A specific move method to move a given key/value to the last index.
`byte`	`pollFirstByteKey()` A method to get and remove the first Key of a Map.
`byte`	`pollLastByteKey()` A method to get and remove the last Key of a Map.
`V`	`putAndMoveToFirst(byte key, V value)` A customized put method that allows you to insert into the first index.
`V`	`putAndMoveToLast(byte key, V value)` A customized put method that allows you to insert into the last index.
`default Byte2ObjectOrderedMap<V>`	`synchronize()` Creates a Wrapped SortedMap that is Synchronized
`default Byte2ObjectOrderedMap<V>`	`synchronize(java.lang.Object mutex)` Creates a Wrapped SortedMap that is Synchronized
`default Byte2ObjectOrderedMap<V>`	`unmodifiable()` Creates a Wrapped SortedMap that is unmodifiable

Methods inherited from interface speiger.src.collections.bytes.maps.interfaces.Byte2ObjectMap
apply, builder, compute, compute, computeIfAbsent, computeIfAbsent, computeIfPresent, computeIfPresent, containsKey, containsKey, entrySet, forEach, forEach, get, get, getDefaultReturnValue, getOrDefault, getOrDefault, merge, merge, mergeAll, put, put, put, put, putAll, putAll, putAll, putAll, putAll, putAllIfAbsent, putIfAbsent, putIfAbsent, remove, remove, remove, remove, removeOrDefault, replace, replace, replace, replace, replaceAll, replaceObjects, replaceObjects, setDefaultReturnValue, supplyIfAbsent, values

Methods inherited from interface java.util.Map
clear, containsValue, equals, hashCode, isEmpty, putAll, size

- Method Detail
  - putAndMoveToFirst
```
V putAndMoveToFirst(byte key,
                    V value)
```
    A customized put method that allows you to insert into the first index.
    
    Parameters:
    
    key - the key that should be inserted
    
    value - the value that should be inserted
    
    Returns:
    
    the previous present or default return value
    
    See Also:
    
    Map.put(Object, Object)
  - putAndMoveToLast
```
V putAndMoveToLast(byte key,
                   V value)
```
    A customized put method that allows you to insert into the last index. (This may be nessesary depending on the implementation)
    
    Parameters:
    
    key - the key that should be inserted
    
    value - the value that should be inserted
    
    Returns:
    
    the previous present or default return value
    
    See Also:
    
    Map.put(Object, Object)
  - moveToFirst
```
boolean moveToFirst(byte key)
```
    A specific move method to move a given key/value to the first index.
    
    Parameters:
    
    key - that should be moved to the first index
    
    Returns:
    
    true if the value was moved.
    
    Note:
    
    returns false if the value was not present in the first place
  - moveToLast
```
boolean moveToLast(byte key)
```
    A specific move method to move a given key/value to the last index.
    
    Parameters:
    
    key - that should be moved to the first last
    
    Returns:
    
    true if the value was moved.
    
    Note:
    
    returns false if the value was not present in the first place
  - getAndMoveToFirst
```
V getAndMoveToFirst(byte key)
```
    A Specific get method that allows to move teh given key/value int the first index.
    
    Parameters:
    
    key - that is searched for
    
    Returns:
    
    the given value for the requested key or default return value
  - getAndMoveToLast
```
V getAndMoveToLast(byte key)
```
    A Specific get method that allows to move teh given key/value int the last index.
    
    Parameters:
    
    key - that is searched for
    
    Returns:
    
    the given value for the requested key or default return value
  - firstByteKey
```
byte firstByteKey()
```
    A method to get the first Key of a Map.
    
    Returns:
    
    the first key in the map
  - pollFirstByteKey
```
byte pollFirstByteKey()
```
    A method to get and remove the first Key of a Map.
    
    Returns:
    
    the first key in the map
  - lastByteKey
```
byte lastByteKey()
```
    A method to get the last Key of a Map.
    
    Returns:
    
    the last key in the map
  - pollLastByteKey
```
byte pollLastByteKey()
```
    A method to get and remove the last Key of a Map.
    
    Returns:
    
    the last key in the map
  - firstValue
```
V firstValue()
```
    A method to get the first Value of a Map.
    
    Returns:
    
    the first key in the map
  - lastValue
```
V lastValue()
```
    A method to get the last Value of a Map.
    
    Returns:
    
    the last key in the map
  - copy
```
Byte2ObjectOrderedMap<V> copy()
```
    Description copied from interface: Byte2ObjectMap
    
    A Function that does a shallow clone of the Map itself. This function is more optimized then a copy constructor since the Map does not have to be unsorted/resorted. It can be compared to Cloneable but with less exception risk
    
    Specified by:
    
    copy in interface Byte2ObjectMap<V>
    
    Returns:
    
    a Shallow Copy of the Map
  - keySet
```
ByteOrderedSet keySet()
```
    Specified by:
    
    keySet in interface Byte2ObjectMap<V>
    
    Specified by:
    
    keySet in interface java.util.Map<java.lang.Byte,V>
  - byte2ObjectEntrySet
```
ObjectOrderedSet<Byte2ObjectMap.Entry<V>> byte2ObjectEntrySet()
```
    Description copied from interface: Byte2ObjectMap
    
    Type Sensitive EntrySet to reduce boxing/unboxing and optionally Temp Object Allocation.
    
    Specified by:
    
    byte2ObjectEntrySet in interface Byte2ObjectMap<V>
    
    Returns:
    
    a EntrySet of the collection
  - synchronize
```
default Byte2ObjectOrderedMap<V> synchronize()
```
    Creates a Wrapped SortedMap that is Synchronized
    
    Specified by:
    
    synchronize in interface Byte2ObjectMap<V>
    
    Returns:
    
    a new SortedMap that is synchronized
    
    See Also:
    
    Byte2ObjectMaps.synchronize(speiger.src.collections.bytes.maps.interfaces.Byte2ObjectMap<V>)
  - synchronize
```
default Byte2ObjectOrderedMap<V> synchronize(java.lang.Object mutex)
```
    Creates a Wrapped SortedMap that is Synchronized
    
    Specified by:
    
    synchronize in interface Byte2ObjectMap<V>
    
    Parameters:
    
    mutex - is the controller of the synchronization block
    
    Returns:
    
    a new SortedMap Wrapper that is synchronized
    
    See Also:
    
    Byte2ObjectMaps.synchronize(speiger.src.collections.bytes.maps.interfaces.Byte2ObjectMap<V>)
  - unmodifiable
```
default Byte2ObjectOrderedMap<V> unmodifiable()
```
    Creates a Wrapped SortedMap that is unmodifiable
    
    Specified by:
    
    unmodifiable in interface Byte2ObjectMap<V>
    
    Returns:
    
    a new SortedMap Wrapper that is unmodifiable
    
    See Also:
    
    Byte2ObjectMaps.unmodifiable(speiger.src.collections.bytes.maps.interfaces.Byte2ObjectMap<V>)

Interface Byte2ObjectOrderedMap<V>

Nested Class Summary

Nested classes/interfaces inherited from interface speiger.src.collections.bytes.maps.interfaces.Byte2ObjectMap

Method Summary

Methods inherited from interface speiger.src.collections.bytes.maps.interfaces.Byte2ObjectMap

Methods inherited from interface java.util.Map

Method Detail

putAndMoveToFirst

putAndMoveToLast

moveToFirst

moveToLast

getAndMoveToFirst

getAndMoveToLast

firstByteKey

pollFirstByteKey

lastByteKey

pollLastByteKey

firstValue

lastValue

copy

keySet

byte2ObjectEntrySet

synchronize

synchronize

unmodifiable