Class FifoDeliveryQueue

  • All Implemented Interfaces:

    public final class FifoDeliveryQueue
    extends java.lang.Object
    implements DeliveryQueue
    Simple first in / first out Delivery Queue.
    • Constructor Detail

      • FifoDeliveryQueue

        public FifoDeliveryQueue​(int queueDepth)
        Creates a new first in / first out message queue with the given queue depth
        queueDepth - The Queue depth to configure for this FIFO Message Queue.
    • Method Detail

      • enqueue

        public void enqueue​(ClientDelivery envelope)
        Description copied from interface: DeliveryQueue
        Adds the given Delivery to the end of the Delivery queue.
        Specified by:
        enqueue in interface DeliveryQueue
        envelope - The in-bound Delivery to enqueue.
      • dequeue

        public ClientDelivery dequeue​(long timeout)
                               throws java.lang.InterruptedException
        Description copied from interface: DeliveryQueue
        Used to get an Delivery. The amount of time this method blocks is based on the timeout value that is supplied to it.
        • If the timeout value is less than zero the dequeue operation blocks until a Delivery is enqueued or the queue is stopped.
        • If the timeout value is zero the dequeue operation will not block and will either return the next Delivery on the Queue or null to indicate the queue is empty.
        • If the timeout value is greater than zero then the method will either return the next Delivery in the queue or block until the timeout (in milliseconds) has expired or until a new Delivery is placed onto the queue.
        Specified by:
        dequeue in interface DeliveryQueue
        timeout - The amount of time to wait for an entry to be added before returning null.
        null if we timeout or if the Receiver is closed.
        java.lang.InterruptedException - if the wait is interrupted.
      • start

        public void start()
        Description copied from interface: DeliveryQueue
        Starts the Delivery Queue. An non-started Queue will always return null for any of the Queue methods.
        Specified by:
        start in interface DeliveryQueue
      • stop

        public void stop()
        Description copied from interface: DeliveryQueue
        Stops the Delivery Queue. Deliveries cannot be read from the Queue when it is in the stopped state and any waiters will be woken.
        Specified by:
        stop in interface DeliveryQueue
      • close

        public void close()
        Description copied from interface: DeliveryQueue
        Closes the Delivery Queue. No Delivery can be added or removed from the Queue once it has entered the closed state.
        Specified by:
        close in interface DeliveryQueue
      • isRunning

        public boolean isRunning()
        Specified by:
        isRunning in interface DeliveryQueue
        true if the Queue is not in the stopped or closed state.
      • isClosed

        public boolean isClosed()
        Specified by:
        isClosed in interface DeliveryQueue
        true if the Queue has been closed.
      • isEmpty

        public boolean isEmpty()
        Specified by:
        isEmpty in interface DeliveryQueue
        true if there are no deliveries in the queue.
      • size

        public int size()
        Description copied from interface: DeliveryQueue
        Returns the number of deliveries currently in the Queue. This value is only meaningful at the time of the call as the size of the Queue changes rapidly as deliveries arrive and are consumed.
        Specified by:
        size in interface DeliveryQueue
        the current number of Delivery objects in the Queue.
      • toString

        public java.lang.String toString()
        toString in class java.lang.Object