Package com.google.common.collect
Class ForwardingDeque<E extends @Nullable Object>
- java.lang.Object
-
- com.google.common.collect.ForwardingObject
-
- com.google.common.collect.ForwardingCollection<E>
-
- com.google.common.collect.ForwardingQueue<E>
-
- com.google.common.collect.ForwardingDeque<E>
-
- All Implemented Interfaces:
Iterable<E>
,Collection<E>
,Deque<E>
,Queue<E>
- Direct Known Subclasses:
ForwardingBlockingDeque
,ForwardingBlockingDeque
@GwtIncompatible public abstract class ForwardingDeque<E extends @Nullable Object> extends ForwardingQueue<E> implements Deque<E>
A deque which forwards all its method calls to another deque. Subclasses should override one or more methods to modify the behavior of the backing deque as desired per the decorator pattern.Warning: The methods of
ForwardingDeque
forward indiscriminately to the methods of the delegate. For example, overridingForwardingCollection.add(E)
alone will not change the behavior ofForwardingQueue.offer(E)
which can lead to unexpected behavior. In this case, you should overrideoffer
as well.default
method warning: This class does not forward calls todefault
methods. Instead, it inherits their default implementations. When those implementations invoke methods, they invoke methods on theForwardingDeque
.- Since:
- 12.0
- Author:
- Kurt Alfred Kluever
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
ForwardingDeque()
Constructor for use by subclasses.
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description void
addFirst(E e)
void
addLast(E e)
protected abstract Deque<E>
delegate()
Returns the backing delegate instance that methods are forwarded to.Iterator<E>
descendingIterator()
E
getFirst()
E
getLast()
boolean
offerFirst(E e)
boolean
offerLast(E e)
@Nullable E
peekFirst()
@Nullable E
peekLast()
@Nullable E
pollFirst()
@Nullable E
pollLast()
E
pop()
void
push(E e)
E
removeFirst()
boolean
removeFirstOccurrence(@Nullable Object o)
E
removeLast()
boolean
removeLastOccurrence(@Nullable Object o)
-
Methods inherited from class com.google.common.collect.ForwardingQueue
element, offer, peek, poll, remove, standardOffer, standardPeek, standardPoll
-
Methods inherited from class com.google.common.collect.ForwardingCollection
add, addAll, clear, contains, containsAll, isEmpty, iterator, remove, removeAll, retainAll, size, standardAddAll, standardClear, standardContains, standardContainsAll, standardIsEmpty, standardRemove, standardRemoveAll, standardRetainAll, standardToArray, standardToArray, standardToString, toArray, toArray
-
Methods inherited from class com.google.common.collect.ForwardingObject
toString
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface java.util.Collection
clear, containsAll, equals, hashCode, isEmpty, parallelStream, removeAll, removeIf, retainAll, spliterator, stream, toArray, toArray, toArray
-
-
-
-
Constructor Detail
-
ForwardingDeque
protected ForwardingDeque()
Constructor for use by subclasses.
-
-
Method Detail
-
delegate
protected abstract Deque<E> delegate()
Description copied from class:ForwardingObject
Returns the backing delegate instance that methods are forwarded to. Abstract subclasses generally override this method with an abstract method that has a more specific return type, such asForwardingSet.delegate()
. Concrete subclasses override this method to supply the instance being decorated.- Specified by:
delegate
in classForwardingQueue<E extends @Nullable Object>
-
descendingIterator
public Iterator<E> descendingIterator()
- Specified by:
descendingIterator
in interfaceDeque<E extends @Nullable Object>
-
offerFirst
@CanIgnoreReturnValue public boolean offerFirst(E e)
- Specified by:
offerFirst
in interfaceDeque<E extends @Nullable Object>
-
offerLast
@CanIgnoreReturnValue public boolean offerLast(E e)
-
pollFirst
@CanIgnoreReturnValue public @Nullable E pollFirst()
-
pollLast
@CanIgnoreReturnValue public @Nullable E pollLast()
-
pop
@CanIgnoreReturnValue public E pop()
-
removeFirst
@CanIgnoreReturnValue public E removeFirst()
- Specified by:
removeFirst
in interfaceDeque<E extends @Nullable Object>
-
removeLast
@CanIgnoreReturnValue public E removeLast()
- Specified by:
removeLast
in interfaceDeque<E extends @Nullable Object>
-
removeFirstOccurrence
@CanIgnoreReturnValue public boolean removeFirstOccurrence(@Nullable Object o)
- Specified by:
removeFirstOccurrence
in interfaceDeque<E extends @Nullable Object>
-
removeLastOccurrence
@CanIgnoreReturnValue public boolean removeLastOccurrence(@Nullable Object o)
- Specified by:
removeLastOccurrence
in interfaceDeque<E extends @Nullable Object>
-
-