org.exoplatform.services.jcr.rmi.api.observation
Class Queue

java.lang.Object
  org.exoplatform.services.jcr.rmi.api.observation.Queue

public class Queue
extends java.lang.Object

The Queue class is a very simple queue assuming that there is at least one consumer and potentially multiple producers. This class poses no restrictions on the size of the queue.

Constructor Summary

Queue()
Creates an instance of this queue.

Method Summary

java.lang.Object	get(long timeout) Returns the first element from the queue.
void	put(java.lang.Object object) Appends the given object to the end of the queue.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Queue

public Queue()

Creates an instance of this queue.

Method Detail

put

public void put(java.lang.Object object)

Appends the given object to the end of the queue.

After appending the element, the queue is notified such that threads waiting to retrieve an element from the queue are woken up.

Parameters:

object - the object to be added

get

public java.lang.Object get(long timeout)
                     throws java.lang.InterruptedException

Returns the first element from the queue. If the queue is currently empty the method waits at most the given number of milliseconds.

Parameters:

timeout - The maximum number of milliseconds to wait for an entry in the queue if the queue is empty. If zero, the method waits forever for an element.

Returns:

The first element of the queue or null if the method timed out waiting for an entry.

Throws:

java.lang.InterruptedException - Is thrown if the current thread is interrupted while waiting for the queue to get at least one entry.