/* * 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. * @author mkizub * @param type of values stored in this hash table. */ public final class L2ObjectHashSet extends L2ObjectSet { 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[] _collisions; private int _count; private static int getPrime(int min) { for (int element : PRIMES) { if (element >= min) { return element; } } throw new OutOfMemoryError(); } @SuppressWarnings("unchecked") public L2ObjectHashSet() { int size = PRIMES[0]; _table = (T[]) new L2Object[size]; _collisions = new int[(size + 31) >> 5]; 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]; _collisions = new int[(size + 31) >> 5]; _count = 0; if (DEBUG) { check(); } } private void check() { if (DEBUG) { int cnt = 0; assert _collisions.length == ((_table.length + 31) >> 5); for (T obj : _table) { if (obj != null) { cnt++; } } assert cnt == _count; } } @Override public synchronized void put(T obj) { if (obj == null) { return; } if (contains(obj)) { return; } 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 ((_collisions[pos >> 5] & (1 << (pos & 31))) == 0) { // found an empty slot without previous collisions, // but use previously found slot _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) && ((_collisions[pos >> 5] & (1 << (pos & 31))) == 0)) { _table[slot] = obj; _count++; if (TRACE) { System.err.println("ht: put obj id=" + hashcode + " at slot=" + slot); } if (DEBUG) { check(); } return; } } // set collision bit _collisions[pos >> 5] |= 1 << (pos & 31); // calculate next slot seed += incr; } while (++ntry < _table.length); if (DEBUG) { check(); } throw new IllegalStateException(); } @Override public synchronized void remove(T obj) { if (obj == null) { return; } if (!contains(obj)) { return; } 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 _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) && ((_collisions[pos >> 5] & (1 << (pos & 31))) == 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 boolean contains(T obj) { final int size = _table.length; if (size <= 11) { // for small tables linear check is fast for (int i = 0; i < size; i++) { if (_table[i] == obj) { return true; } } return false; } int hashcode = obj.getObjectId(); assert hashcode > 0; int seed = hashcode; int incr = 1 + (((seed >> 5) + 1) % (size - 1)); int ntry = 0; do { int pos = (seed % size) & 0x7FFFFFFF; if (_table[pos] == obj) { return true; } // check for collision (if we previously deleted element) if ((_table[pos] == null) && ((_collisions[pos >> 5] & (1 << (pos & 31))) == 0)) { return false; } // calculate next slot seed += incr; } while (++ntry < size); return false; } @SuppressWarnings("unchecked") private/* already synchronized in put() */void expand() { int newSize = getPrime(_table.length + 1); L2Object[] newTable = new L2Object[newSize]; int[] newCollisions = new int[(newSize + 31) >> 5]; // 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 = 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) { // found an empty slot without previous collisions, // but use previously found slot 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 newCollisions[pos >> 5] |= 1 << (pos & 31); // calculate next slot seed += incr; } while (++ntry < newSize); throw new IllegalStateException(); } _table = (T[]) newTable; _collisions = newCollisions; 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(); } L2ObjectHashSet.this.remove(_lastRet); } } }