Package org.codehaus.groovy.util

Class ManagedConcurrentLinkedQueue<T>

java.lang.Object
org.codehaus.groovy.util.ManagedConcurrentLinkedQueue<T>
Type Parameters:
T - the type of values to store
All Implemented Interfaces:
Iterable<T>
public class ManagedConcurrentLinkedQueue<T> extends Object implements Iterable<T>
A queue that stores values wrapped in a Reference, the type of which is determined by the provided ReferenceBundle. References stored in this queue will be removed when reference processing occurs.

This queue is backed by a ConcurrentLinkedQueue and is thread safe. The iterator will only return non-null values (reachable) and is based on the "weakly consistent" iterator of the underlying ConcurrentLinkedQueue.

  • Constructor Summary

    Constructors
    Constructor
    Description
    ManagedConcurrentLinkedQueue(ReferenceBundle bundle)
    Creates an empty ManagedConcurrentLinkedQueue that will use the provided ReferenceBundle to store values as the given Reference type.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    add(T value)
    Adds the specified value to the queue.
    boolean
    isEmpty()
    Returns true if this queue contains no elements.
    Iterator<T>
    iterator()
    Returns an iterator over all non-null values in this queue.
    T[]
    toArray(T[] tArray)
    Returns an array containing all values from this queue in the sequence they were added.
    List<T>
    values()
    Returns a list containing all values from this queue in the sequence they were added.

    Methods inherited from class java.lang.Object

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

    Methods inherited from interface java.lang.Iterable

    forEach, spliterator

  • Constructor Details

    • ManagedConcurrentLinkedQueue

      public ManagedConcurrentLinkedQueue(ReferenceBundle bundle)
      Creates an empty ManagedConcurrentLinkedQueue that will use the provided ReferenceBundle to store values as the given Reference type.
      Parameters:
      bundle - used to create the appropriate Reference type for the values stored

  • Method Details

    • add

      public void add(T value)
      Adds the specified value to the queue.
      Parameters:
      value - the value to add

    • isEmpty

      public boolean isEmpty()
      Returns true if this queue contains no elements.

      This method does not check the elements to verify they contain non-null reference values.

    • toArray

      public T[] toArray(T[] tArray)
      Returns an array containing all values from this queue in the sequence they were added.
      Parameters:
      tArray - the array to populate if big enough, else a new array with the same runtime type
      Returns:
      an array containing all non-null values in this queue

    • values

      public List<T> values()
      Returns a list containing all values from this queue in the sequence they were added.

    • iterator

      public Iterator<T> iterator()
      Returns an iterator over all non-null values in this queue. The values should be returned in the order they were added.
      Specified by:
      iterator in interface Iterable<T>