Package org.jcsp.util

Class OverFlowingBuffer<T>

    • Constructor Detail

      • OverFlowingBuffer

        public OverFlowingBuffer​(int size)
        Construct a new OverFlowingBuffer with the specified size.
        Parameters:
        size - the number of Objects the OverFlowingBuffer can store.
        Throws:
        BufferSizeError - if size is zero or negative. Note: no action should be taken to try/catch this exception - application code generating it is in error and needs correcting.
    • Method Detail

      • get

        public T get()
        Returns the oldest Object from the OverFlowingBuffer and removes it.

        Pre-condition: getState must not currently return EMPTY.

        Specified by:
        get in interface ChannelDataStore<T>
        Returns:
        the oldest Object from the OverFlowingBuffer
      • startGet

        public T startGet()
        Returns the oldest object from the buffer but does not remove it. Pre-condition: getState must not currently return EMPTY.
        Specified by:
        startGet in interface ChannelDataStore<T>
        Returns:
        the oldest Object from the Buffer
        See Also:
        ChannelDataStore.endGet()
      • put

        public void put​(T value)
        Puts a new Object into the OverFlowingBuffer.

        If OverFlowingBuffer is full, the item is discarded.

        Specified by:
        put in interface ChannelDataStore<T>
        Parameters:
        value - the Object to put into the OverFlowingBuffer
      • getState

        public int getState()
        Returns the current state of the OverFlowingBuffer.
        Specified by:
        getState in interface ChannelDataStore<T>
        Returns:
        the current state of the OverFlowingBuffer (EMPTY or NONEMPTYFULL)
      • clone

        public Object clone()
        Returns a new (and EMPTY) OverFlowingBuffer with the same creation parameters as this one.

        Note: Only the size and structure of the OverFlowingBuffer is cloned, not any stored data.

        Specified by:
        clone in interface ChannelDataStore<T>
        Overrides:
        clone in class Object
        Returns:
        the cloned instance of this OverFlowingBuffer.