public interface Buffer extends Collection
The removal order can be based on insertion order (eg, a FIFO queue or a LIFO stack), on access order (eg, an LRU cache), on some arbitrary comparator (eg, a priority queue) or on any other well-defined ordering.
Note that the removal order is not necessarily the same as the iteration
order. A Buffer
implementation may have equivalent removal
and iteration orders, but this is not required.
This interface does not specify any behavior for
Object.equals(Object)
and Object.hashCode()
methods. It
is therefore possible for a Buffer
implementation to also
also implement List
, Set
or
Bag
.
Note: this class should be bytecode-identical to the version in commons collections. This is required to allow backwards compability with both previous versions of BeanUtils and also allow coexistance with both collections 2.1 and 3.0.
Modifier and Type | Method and Description |
---|---|
Object |
get()
Gets the next object from the buffer without removing it.
|
Object |
remove()
Gets and removes the next object from the buffer.
|
add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, parallelStream, remove, removeAll, removeIf, retainAll, size, spliterator, stream, toArray, toArray
Object remove()
BufferUnderflowException
- if the buffer is already emptyObject get()
BufferUnderflowException
- if the buffer is emptyCopyright © 2000-2021 The Apache Software Foundation. All Rights Reserved.