com.browseengine.bobo.util.IntBoundedPriorityQueue Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of bobo-browse Show documentation
Show all versions of bobo-browse Show documentation
Bobo is a Faceted Search implementation written purely in Java, an extension of Apache Lucene
The newest version!
/**
*
*/
package com.browseengine.bobo.util;
import java.util.Comparator;
import java.util.Iterator;
import java.util.NoSuchElementException;
import java.util.PriorityQueue;
/**
* A priority queue for int that uses int[] heap for storage.
* Always have least element on top. When the queue is full, new elements are added
* if they are bigger than the least element to replace them.
* @author "Xiaoyang Gu"
*
*/
public class IntBoundedPriorityQueue extends PriorityQueue {
/**
*
*/
private static final long serialVersionUID = 1L;
private final int _capacity;
private final int[] _items;
private int _size = 0;
private final IntComparator _comp;
private final int _forbiddenValue;
/**
* @param capacity the maximum number of items the queue accepts
* @param comparator a comparator that is used to order the items.
*/
public IntBoundedPriorityQueue(IntComparator comparator, int capacity, int forbiddenValue) {
_capacity = capacity;
_comp = comparator;
_items = new int[capacity];// java.lang.reflect.Array.newInstance(, capacity);
_forbiddenValue = forbiddenValue;
}
/**
* {@inheritDoc} Retrieves, but does not remove, the head of this queue. This
* implementation returns the result of peek unless the queue is empty.
*
* @see java.util.Queue#element()
*/
@Override
public Integer element() throws NoSuchElementException {
if (_size == 0) throw new NoSuchElementException("empty queue");
return _items[0];
}
public int intElement() throws NoSuchElementException {
if (_size == 0) throw new NoSuchElementException("empty queue");
return _items[0];
}
/**
* Returns an iterator over the elements in this collection. There are no guarantees
* concerning the order in which the elements are returned (unless this collection is an
* instance of some class that provides a guarantee).
*
* @see java.util.AbstractCollection#iterator()
*/
@Override
public IntIterator iterator() {
return new IntIterator() {
private int i = 0;
@Override
public boolean hasNext() {
return i < _size;
}
@Override
public Integer next() throws NoSuchElementException {
if (i >= _size) throw new NoSuchElementException("last element reached in queue");
return _items[i++];
}
@Override
public int nextInt() throws NoSuchElementException {
if (i >= _size) throw new NoSuchElementException("last element reached in queue");
return _items[i++];
}
@Override
public void remove() {
throw new UnsupportedOperationException("not supported");
}
};
}
public interface IntIterator extends Iterator {
public int nextInt();
}
/**
* When the queue is full, the offered elements are added if they are bigger than the
* smallest one already in the queue.
*
* Inserts the specified element into this queue, if possible. When using queues that
* may impose insertion restrictions (for example capacity bounds), method offer is
* generally preferable to method Collection.add, which can fail to insert an element
* only by throwing an exception.
*
* @see java.util.Queue#offer(java.lang.Object)
*/
@Override
public boolean offer(Integer item) {
int itm = item;
return offer(itm);
}
/**
* When the queue is full, the offered elements are added if they are bigger than the
* smallest one already in the queue.
*
* Inserts the specified element into this queue, if possible. When using queues that
* may impose insertion restrictions (for example capacity bounds), method offer is
* generally preferable to method Collection.add, which can fail to insert an element
* only by throwing an exception.
*
* @see java.util.Queue#offer(java.lang.Object)
*/
public boolean offer(int item) {
if (_size < _capacity) {
_items[_size] = item;
percolateUp(_size);
_size++;
// System.out.println("adding to queue " + item + " \t "
// +Thread.currentThread().getClass()+Thread.currentThread().getId() );
return true;
} else {
if (_items[0] < item) {
_items[0] = item;
percolateDown();
return true;
} else return false;
}
}
/**
* Retrieves, but does not remove, the head of this queue, returning null if this queue
* is empty.
*
* @see java.util.Queue#peek()
*/
@Override
public Integer peek() {
if (_size == 0) return null;
return _items[0];
}
/**
* Retrieves, but does not remove, the head of this queue, returning the forbidden value
* if the queue is empty.
*/
public int peekInt() {
if (_size == 0) return _forbiddenValue;
return _items[0];
}
/**
* Retrieves and removes the head of this queue, or null if this queue is empty.
*
* @see java.util.Queue#poll()
*/
@Override
public Integer poll() {
if (_size == 0) return null;
int ret = _items[0];
_size--;
_items[0] = _items[_size];
_items[_size] = 0;
if (_size > 1) percolateDown();
return ret;
}
/**
* Retrieves and removes the head of this queue, or the forbidden value if this queue is empty.
*/
public int pollInt() {
if (_size == 0) return _forbiddenValue;
int ret = _items[0];
_size--;
_items[0] = _items[_size];
_items[_size] = 0;
if (_size > 1) percolateDown();
return ret;
}
/**
* Returns the number of elements in this collection.
*
* @see java.util.AbstractCollection#size()
*/
@Override
public int size() {
return _size;
}
private void percolateDown() {
int temp = _items[0];
int index = 0;
while (true) {
int left = (index << 1) + 1;
int right = left + 1;
if (right < _size) {
left = _comp.compare(_items[left], _items[right]) < 0 ? left : right;
} else if (left >= _size) {
_items[index] = temp;
break;
}
if (_comp.compare(_items[left], temp) < 0) {
_items[index] = _items[left];
index = left;
} else {
_items[index] = temp;
break;
}
}
}
private void percolateUp(int index) {
int i;
int temp = _items[index];
while ((i = ((index - 1) >> 1)) >= 0 && _comp.compare(temp, _items[i]) < 0) {
_items[index] = _items[i];
index = i;
}
_items[index] = temp;
}
public static abstract class IntComparator implements Comparator {
public int compare(int int1, int int2) {
return compare((Integer) int1, (Integer) int2);
}
}
}