Package org.apache.hadoop.ipc

Class CallQueueManager<E extends Schedulable>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractQueue<E>

org.apache.hadoop.ipc.CallQueueManager<E>

All Implemented Interfaces:

java.lang.Iterable<E>, java.util.Collection<E>, java.util.concurrent.BlockingQueue<E>, java.util.Queue<E>

public class CallQueueManager<E extends Schedulable>
extends java.util.AbstractQueue<E>
implements java.util.concurrent.BlockingQueue<E>

Abstracts queue operations for different blocking queues.

Field Summary

Fields

Modifier and Type	Field	Description
static org.slf4j.Logger	LOG

Constructor Summary

Constructors

Constructor	Description
CallQueueManager(java.lang.Class<? extends java.util.concurrent.BlockingQueue<E>> backingClass, java.lang.Class<? extends RpcScheduler> schedulerClass, boolean clientBackOffEnabled, int maxQueueSize, java.lang.String namespace, Configuration conf)

Method Summary

Modifier and Type	Method	Description
boolean	add(E e)
int	drainTo(java.util.Collection<? super E> c)
int	drainTo(java.util.Collection<? super E> c, int maxElements)
static int[]	getDefaultQueueCapacityWeights(int priorityLevels)	By default, queue capacity is the same for all priority levels.
boolean	isServerFailOverEnabled()
boolean	isServerFailOverEnabledByQueue()
java.util.Iterator<E>	iterator()
boolean	offer(E e)	Insert e into the backing queue.
boolean	offer(E e, long timeout, java.util.concurrent.TimeUnit unit)
E	peek()
E	poll()
E	poll(long timeout, java.util.concurrent.TimeUnit unit)
void	put(E e)	Insert e into the backing queue or block until we can.
int	remainingCapacity()
int	size()
void	swapQueue(java.lang.Class<? extends RpcScheduler> schedulerClass, java.lang.Class<? extends java.util.concurrent.BlockingQueue<E>> queueClassToUse, int maxSize, java.lang.String ns, Configuration conf)	Replaces active queue with the newly requested one and transfers all calls to the newQ before returning.
E	take()	Retrieve an E from the backing queue or block until we can.

Methods inherited from class java.util.AbstractQueue

addAll, clear, element, remove

Methods inherited from class java.util.AbstractCollection

contains, containsAll, isEmpty, remove, removeAll, retainAll, toArray, toArray, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.concurrent.BlockingQueue

contains, remove

Methods inherited from interface java.util.Collection

addAll, clear, containsAll, equals, hashCode, isEmpty, parallelStream, removeAll, removeIf, retainAll, spliterator, stream, toArray, toArray, toArray

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.Queue

element, remove

Field Detail

LOG

public static final org.slf4j.Logger LOG

Constructor Detail

CallQueueManager

public CallQueueManager(java.lang.Class<? extends java.util.concurrent.BlockingQueue<E>> backingClass,
                        java.lang.Class<? extends RpcScheduler> schedulerClass,
                        boolean clientBackOffEnabled,
                        int maxQueueSize,
                        java.lang.String namespace,
                        Configuration conf)

Method Detail

isServerFailOverEnabled

@VisibleForTesting
public boolean isServerFailOverEnabled()

isServerFailOverEnabledByQueue

@VisibleForTesting
public boolean isServerFailOverEnabledByQueue()

put

public void put(E e)
         throws java.lang.InterruptedException

Insert e into the backing queue or block until we can. If client backoff is enabled this method behaves like add which throws if the queue overflows. If we block and the queue changes on us, we will insert while the queue is drained.

Specified by:

put in interface java.util.concurrent.BlockingQueue<E extends Schedulable>

Throws:

java.lang.InterruptedException

add

public boolean add(E e)

Specified by:

add in interface java.util.concurrent.BlockingQueue<E extends Schedulable>

Specified by:

add in interface java.util.Collection<E extends Schedulable>

Specified by:

add in interface java.util.Queue<E extends Schedulable>

Overrides:

add in class java.util.AbstractQueue<E extends Schedulable>

offer

public boolean offer(E e)

Insert e into the backing queue. Return true if e is queued. Return false if the queue is full.

Specified by:

offer in interface java.util.concurrent.BlockingQueue<E extends Schedulable>

Specified by:

offer in interface java.util.Queue<E extends Schedulable>

offer

public boolean offer(E e,
                     long timeout,
                     java.util.concurrent.TimeUnit unit)
              throws java.lang.InterruptedException

Specified by:

offer in interface java.util.concurrent.BlockingQueue<E extends Schedulable>

Throws:

java.lang.InterruptedException

peek

public E peek()

Specified by:

peek in interface java.util.Queue<E extends Schedulable>

poll

public E poll()

Specified by:

poll in interface java.util.Queue<E extends Schedulable>

poll

public E poll(long timeout,
              java.util.concurrent.TimeUnit unit)
       throws java.lang.InterruptedException

Specified by:

poll in interface java.util.concurrent.BlockingQueue<E extends Schedulable>

Throws:

java.lang.InterruptedException

take

public E take()
       throws java.lang.InterruptedException

Retrieve an E from the backing queue or block until we can. Guaranteed to return an element from the current queue.

Specified by:

take in interface java.util.concurrent.BlockingQueue<E extends Schedulable>

Throws:

java.lang.InterruptedException

size

public int size()

Specified by:

size in interface java.util.Collection<E extends Schedulable>

Specified by:

size in class java.util.AbstractCollection<E extends Schedulable>

remainingCapacity

public int remainingCapacity()

Specified by:

remainingCapacity in interface java.util.concurrent.BlockingQueue<E extends Schedulable>

getDefaultQueueCapacityWeights

public static int[] getDefaultQueueCapacityWeights(int priorityLevels)

By default, queue capacity is the same for all priority levels.

Parameters:

priorityLevels - number of levels

Returns:

default weights

swapQueue

public void swapQueue(java.lang.Class<? extends RpcScheduler> schedulerClass,
                      java.lang.Class<? extends java.util.concurrent.BlockingQueue<E>> queueClassToUse,
                      int maxSize,
                      java.lang.String ns,
                      Configuration conf)

Replaces active queue with the newly requested one and transfers all calls to the newQ before returning.

Parameters:

schedulerClass - input schedulerClass.

queueClassToUse - input queueClassToUse.

maxSize - input maxSize.

ns - input ns.

conf - input configuration.

drainTo

public int drainTo(java.util.Collection<? super E> c)

Specified by:

drainTo in interface java.util.concurrent.BlockingQueue<E extends Schedulable>

drainTo

public int drainTo(java.util.Collection<? super E> c,
                   int maxElements)

Specified by:

drainTo in interface java.util.concurrent.BlockingQueue<E extends Schedulable>

iterator

public java.util.Iterator<E> iterator()

Specified by:

iterator in interface java.util.Collection<E extends Schedulable>

Specified by:

iterator in interface java.lang.Iterable<E extends Schedulable>

Specified by:

iterator in class java.util.AbstractCollection<E extends Schedulable>