Class LongKeyIndexer

  • All Implemented Interfaces:
    java.io.Serializable

    public class LongKeyIndexer
    extends java.lang.Object
    implements java.io.Serializable
    This class converts arbitrary long keys into compacted int indexes suitable for use as indexes into an array or table. Whenever a new key is added, the smallest unused index is allocated and associated with that key. Basically hashes the keys into linked lists using the IntListIndexer class, where all values in a list have the same hashcode. Does most of the work in implementing a separate chaining version of a hashtable - the only thing missing is the values which are stored in the individual implementations of the various hashtables.
    See Also:
    Serialized Form
    • Constructor Summary

      Constructors 
      Constructor Description
      LongKeyIndexer()
      Constructs a LongKeyIndexer with a default capacity.
      LongKeyIndexer​(int capacity)
      Constructs a LongKeyIndexer with a given initial capacity.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void clear()
      Remove all keys.
      int get​(long key)
      Returns the index for the given key, or -1 if key is not in the table.
      int getCapacity()
      Returns the current size of the key table.
      long[] getKeys()
      Returns an array containing all the keys stored in this object.
      int getSize()
      Returns the number of keys stored in the table.
      int put​(long key)
      Returns an index that will always be associated to the given key as long as the key remains in the table.
      int remove​(long key)
      Removes the key from the table.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • LongKeyIndexer

        public LongKeyIndexer()
        Constructs a LongKeyIndexer with a default capacity.
      • LongKeyIndexer

        public LongKeyIndexer​(int capacity)
        Constructs a LongKeyIndexer with a given initial capacity.
        Parameters:
        capacity - the initial capacity.
    • Method Detail

      • put

        public int put​(long key)
        Returns an index that will always be associated to the given key as long as the key remains in the table. If the key already exists, then the index where that key is stored is returned. If the key is new, then a new index is allocated, the key is stored at that index, and the new index is returned.
        Parameters:
        key - the key to be stored.
        Returns:
        index for key, or -1 if there was no room to put the key.
        Throws:
        java.lang.IndexOutOfBoundsException - thrown if this object is at maximum capacity.
      • get

        public int get​(long key)
        Returns the index for the given key, or -1 if key is not in the table.
        Parameters:
        key - the key for which to find an index.
      • remove

        public int remove​(long key)
        Removes the key from the table.
        Parameters:
        key - the key to remove.
        Returns:
        index of the key if the key was found, -1 if key did not exist in the table
      • getSize

        public int getSize()
        Returns the number of keys stored in the table.
      • getCapacity

        public int getCapacity()
        Returns the current size of the key table.
      • clear

        public void clear()
        Remove all keys.
      • getKeys

        public long[] getKeys()
        Returns an array containing all the keys stored in this object.