net.volcanite.util

Class DiscardOverflowsQueue

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractQueue<E>

java.util.concurrent.LinkedBlockingQueue<Runnable>

net.volcanite.util.DiscardOverflowsQueue

All Implemented Interfaces:

Serializable, Iterable<Runnable>, Collection<Runnable>, BlockingQueue<Runnable>, Queue<Runnable>

public final class DiscardOverflowsQueue
extends LinkedBlockingQueue<Runnable>

A bounded asymmetrically blocking queue that discards new elements if the max capacity is reached instead of blocking client threads trying to add new elements. Threads attempting to read from the queue are still blocked if the queue is empty.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_MAX_CAPACITY Default maximum capacity for DiscardOverflowsQueue if no capacity is specified (currently 15_000_000).

Constructor Summary

Constructors

Constructor and Description
DiscardOverflowsQueue() Create a new DiscardOverflowsQueue of max capacity DEFAULT_MAX_CAPACITY.
DiscardOverflowsQueue(int capacity) Create a new DiscardOverflowsQueue of max capacity capacity.

Method Summary

Modifier and Type	Method and Description
boolean	add(Runnable o) Non-blocking add.
boolean	offer(Runnable o) Non-blocking offer.
void	put(Runnable o) Non-blocking put.

Methods inherited from class java.util.concurrent.LinkedBlockingQueue

clear, contains, drainTo, drainTo, iterator, offer, peek, poll, poll, remainingCapacity, remove, size, spliterator, take, toArray, toArray, toString

Methods inherited from class java.util.AbstractQueue

addAll, element, remove

Methods inherited from class java.util.AbstractCollection

containsAll, isEmpty, removeAll, retainAll

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Queue

element, remove

Methods inherited from interface java.util.Collection

addAll, containsAll, equals, hashCode, isEmpty, parallelStream, removeAll, removeIf, retainAll, stream

Methods inherited from interface java.lang.Iterable

forEach

Field Detail

DEFAULT_MAX_CAPACITY

public static final int DEFAULT_MAX_CAPACITY

Default maximum capacity for DiscardOverflowsQueue if no capacity is specified (currently 15_000_000).

See Also:

Constant Field Values

Constructor Detail

DiscardOverflowsQueue

public DiscardOverflowsQueue()

Create a new DiscardOverflowsQueue of max capacity DEFAULT_MAX_CAPACITY.

DiscardOverflowsQueue

public DiscardOverflowsQueue(int capacity)

Create a new DiscardOverflowsQueue of max capacity capacity.

Parameters:

capacity - max capacity.

Method Detail

put

public void put(Runnable o)
         throws InterruptedException

Non-blocking put. New elements are discarded if the queue is currently full.

Specified by:

put in interface BlockingQueue<Runnable>

Overrides:

put in class LinkedBlockingQueue<Runnable>

Throws:

InterruptedException

add

public boolean add(Runnable o)

Non-blocking add. New elements are discarded if the queue is currently full.

Specified by:

add in interface Collection<Runnable>

Specified by:

add in interface BlockingQueue<Runnable>

Specified by:

add in interface Queue<Runnable>

Overrides:

add in class AbstractQueue<Runnable>

offer

public boolean offer(Runnable o)

Non-blocking offer. New elements are discarded if the queue is currently full.

Specified by:

offer in interface BlockingQueue<Runnable>

Specified by:

offer in interface Queue<Runnable>

Overrides:

offer in class LinkedBlockingQueue<Runnable>