JBoss Common Classes 2.2.17.GA

org.jboss.util.collection
Interface Queue<E>

Type Parameters:
E - the element type
All Superinterfaces:
Collection<E>, Iterable<E>
All Known Implementing Classes:
AbstractQueue, ListQueue

public interface Queue<E>
extends Collection<E>

An iterface used to implement a first-in, first-out container.

Version:
$Revision: 2787 $
Author:
Jason Dillon

Field Summary
static int UNLIMITED_MAXIMUM_SIZE
          Unlimited maximum queue size identifier.
 
Method Summary
 boolean add(E obj)
          Enqueue an object onto the queue.
 E getBack()
          Get the object at the back of the queue.
 E getFront()
          Get the object at the front of the queue.
 int getMaximumSize()
          Get the maximum size of the queue.
 boolean isEmpty()
          Check if the queue is empty.
 boolean isFull()
          Check if the queue is full.
 E remove()
          Dequeue an object from the queue.
 void setMaximumSize(int size)
          Set the maximum size of the queue.
 
Methods inherited from interface java.util.Collection
addAll, clear, contains, containsAll, equals, hashCode, iterator, remove, removeAll, retainAll, size, toArray, toArray
 

Field Detail

UNLIMITED_MAXIMUM_SIZE

static final int UNLIMITED_MAXIMUM_SIZE
Unlimited maximum queue size identifier.

See Also:
Constant Field Values
Method Detail

getMaximumSize

int getMaximumSize()
Get the maximum size of the queue.

Returns:
Maximum pool size or UNLIMITED_MAXIMUM_SIZE.

setMaximumSize

void setMaximumSize(int size)
                    throws IllegalArgumentException
Set the maximum size of the queue.

Parameters:
size - New maximim pool size or UNLIMITED_MAXIMUM_SIZE.
Throws:
IllegalArgumentException - Illegal size.

isFull

boolean isFull()
Check if the queue is full.

Returns:
True if the queue is full.

isEmpty

boolean isEmpty()
Check if the queue is empty.

Specified by:
isEmpty in interface Collection<E>
Returns:
True if the queue is empty.

add

boolean add(E obj)
            throws FullCollectionException
Enqueue an object onto the queue.

Specified by:
add in interface Collection<E>
Parameters:
obj - Object to enqueue.
Returns:
True if collection was modified.
Throws:
FullCollectionException - The queue is full.

remove

E remove()
         throws EmptyCollectionException
Dequeue an object from the queue.

Returns:
Dequeued object.
Throws:
EmptyCollectionException - The queue is empty.

getFront

E getFront()
           throws EmptyCollectionException
Get the object at the front of the queue.

Returns:
Object at the front of the queue.
Throws:
EmptyCollectionException - The queue is empty.

getBack

E getBack()
          throws EmptyCollectionException
Get the object at the back of the queue.

Returns:
Object at the back of the queue.
Throws:
EmptyCollectionException - The queue is empty.

JBoss Common Classes 2.2.17.GA

Copyright © 2011 JBoss, a division of Red Hat, Inc.. All Rights Reserved.