/* * This program is free software: you can redistribute it and/or modify it under * the terms of the GNU General Public License as published by the Free Software * Foundation, either version 3 of the License, or (at your option) any later * version. * * This program is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more * details. * * You should have received a copy of the GNU General Public License along with * this program. If not, see . */ package com.l2jserver.gameserver.util; import java.util.Iterator; import java.util.NoSuchElementException; import com.l2jserver.gameserver.model.L2Object; /** * This class is a highly optimized hash table, where keys are integers.
* The main goal of this class is to allow concurrent read/iterate and write access to this table, plus minimal used memory.
* This class uses plain array as the table of values, and keys are used to get position in the table.
* If the position is already busy, we iterate to the next position, until we find the needed element or null.
* To iterate over the table (read access) we may simply iterate through table array.
* In case we remove an element from the table, we check - if the next position is null, we reset table's slot to null, otherwise we assign it to a dummy value. * @param type of values stored in this hash table. * @author mkizub */ public final class L2ObjectHashMap extends L2ObjectMap { private static final boolean TRACE = false; private static final boolean DEBUG = false; private static final int[] PRIMES = { 5, 7, 11, 17, 23, 29, 37, 47, 59, 71, 89, 107, 131, 163, 197, 239, 293, 353, 431, 521, 631, 761, 919, 1103, 1327, 1597, 1931, 2333, 2801, 3371, 4049, 4861, 5839, 7013, 8419, 10103, 12143, 14591, 17519, 21023, 25229, 30293, 36353, 43627, 52361, 62851, 75431, 90523, 108631, 130363, 156437, 187751, 225307, 270371, 324449, 389357, 467237, 560689, 672827, 807403, 968897, 1162687, 1395263, 1674319, 2009191, 2411033, 2893249, 3471899, 4166287, 4999559, 5999471, 7199369 }; private T[] _table; private int[] _keys; private int _count; private static int getPrime(int min) { for (int element : PRIMES) { if (element >= min) { return element; } } throw new OutOfMemoryError(); } @SuppressWarnings("unchecked") public L2ObjectHashMap() { int size = PRIMES[0]; _table = (T[])new L2Object[size]; _keys = new int[size]; if (DEBUG) { check(); } } @Override public int size() { return _count; } @Override public boolean isEmpty() { return _count == 0; } @Override @SuppressWarnings("unchecked") public synchronized void clear() { int size = PRIMES[0]; _table = (T[])new L2Object[size]; _keys = new int[size]; _count = 0; if (DEBUG) { check(); } } private void check() { if (DEBUG) { int cnt = 0; for (int i=0; i < _table.length; i++) { L2Object obj = _table[i]; if (obj == null) { assert (_keys[i] == 0) || (_keys[i] == 0x80000000); } else { cnt++; assert obj.getObjectId() == (_keys[i] & 0x7FFFFFFF); } } assert cnt == _count; } } @Override public synchronized void put(T obj) { if (_count >= (_table.length/2)) { expand(); } final int hashcode = obj.getObjectId(); assert hashcode > 0; int seed = hashcode; int incr = 1 + (((seed >> 5) + 1) % (_table.length - 1)); int ntry = 0; int slot = -1; // keep last found slot do { int pos = (seed % _table.length) & 0x7FFFFFFF; if (_table[pos] == null) { if (slot < 0) { slot = pos; } if (_keys[pos] >= 0) { // found an empty slot without previous collisions, // but use previously found slot _keys[slot] = hashcode; _table[slot] = obj; _count++; if (TRACE) { System.err.println("ht: put obj id="+hashcode+" at slot="+slot); } if (DEBUG) { check(); } return; } } else { // check if we are adding the same object if (_table[pos] == obj) { return; } // this should never happen assert obj.getObjectId() != _table[pos].getObjectId(); // if there was no collisions at this slot, and we found a free // slot previously - use found slot if ((slot >= 0) && (_keys[pos] > 0)) { _keys[slot] |= hashcode; // preserve collision bit _table[slot] = obj; _count++; if (TRACE) { System.err.println("ht: put obj id="+hashcode+" at slot="+slot); } if (DEBUG) { check(); } return; } } // set collision bit _keys[pos] |= 0x80000000; // calculate next slot seed += incr; } while (++ntry < _table.length); if (DEBUG) { check(); } throw new IllegalStateException(); } @Override public synchronized void remove(T obj) { int hashcode = obj.getObjectId(); assert hashcode > 0; int seed = hashcode; int incr = 1 + (((seed >> 5) + 1) % (_table.length - 1)); int ntry = 0; do { int pos = (seed % _table.length) & 0x7FFFFFFF; if (_table[pos] == obj) { // found the object _keys[pos] &= 0x80000000; // preserve collision bit _table[pos] = null; _count--; if (TRACE) { System.err.println("ht: remove obj id="+hashcode+" from slot="+pos); } if (DEBUG) { check(); } return; } // check for collision (if we previously deleted element) if ((_table[pos] == null) && (_keys[pos] >= 0)) { if (DEBUG) { check(); } return; //throw new IllegalArgumentException(); } // calculate next slot seed += incr; } while (++ntry < _table.length); if (DEBUG) { check(); } throw new IllegalStateException(); } @Override public T get(int id) { final int size = _table.length; if (id <= 0) { return null; } if (size <= 11) { // for small tables linear check is fast for (int i=0; i < size; i++) { if ((_keys[i]&0x7FFFFFFF) == id) { return _table[i]; } } return null; } int seed = id; int incr = 1 + (((seed >> 5) + 1) % (size - 1)); int ntry = 0; do { int pos = (seed % size) & 0x7FFFFFFF; if ((_keys[pos]&0x7FFFFFFF) == id) { return _table[pos]; } // check for collision (if we previously deleted element) if ((_table[pos] == null) && (_keys[pos] >= 0)) { return null; } // calculate next slot seed += incr; } while (++ntry < size); return null; } @Override public boolean contains(T obj) { return get(obj.getObjectId()) != null; } @SuppressWarnings("unchecked") private /*already synchronized in put()*/ void expand() { int newSize = getPrime(_table.length+1); L2Object[] newTable = new L2Object[newSize]; int[] newKeys = new int[newSize]; // over all old entries next_entry: for (int i=0; i < _table.length; i++) { L2Object obj = _table[i]; if (obj == null) { continue; } final int hashcode = _keys[i] & 0x7FFFFFFF; assert hashcode == obj.getObjectId(); int seed = hashcode; int incr = 1 + (((seed >> 5) + 1) % (newSize - 1)); int ntry = 0; do { int pos = (seed % newSize) & 0x7FFFFFFF; if (newTable[pos] == null) { assert (newKeys[pos] == 0) && (hashcode != 0); // found an empty slot without previous collisions, // but use previously found slot newKeys[pos] = hashcode; newTable[pos] = obj; if (TRACE) { System.err.println("ht: move obj id="+hashcode+" from slot="+i+" to slot="+pos); } continue next_entry; } // set collision bit newKeys[pos] |= 0x80000000; // calculate next slot seed += incr; } while (++ntry < newSize); throw new IllegalStateException(); } _table = (T[])newTable; _keys = newKeys; if (DEBUG) { check(); } } @Override public Iterator iterator() { return new Itr(_table); } class Itr implements Iterator { private final T[] _array; private int _nextIdx; private T _nextObj; private T _lastRet; Itr(T[] pArray) { this._array = pArray; for (; _nextIdx < _array.length; _nextIdx++) { _nextObj = _array[_nextIdx]; if (_nextObj != null) { return; } } } @Override public boolean hasNext() { return _nextObj != null; } @Override public T next() { if (_nextObj == null) { throw new NoSuchElementException(); } _lastRet = _nextObj; for (_nextIdx++; _nextIdx < _array.length; _nextIdx++) { _nextObj = _array[_nextIdx]; if (_nextObj != null) { break; } } if (_nextIdx >= _array.length) { _nextObj = null; } return _lastRet; } @Override public void remove() { if (_lastRet == null) { throw new IllegalStateException(); } L2ObjectHashMap.this.remove(_lastRet); } } }