一、简介
DelayQueue是JUC提供的一种无界延迟队列，它实现了BlockingQueue<E>阻塞队列接口，底层基于已有的PriorityBlockingQueue实现，类声明如下：
public class DelayQueue<E extends Delayed>
extends AbstractQueue<E>
implements BlockingQueue<E>可见，DelayQueue队列中的元素必须继承自Delayed接口，Delayed接口继承自Comparable接口.
public interface Delayed extends Comparable<Delayed>在Delayed接口中有一个方法Delayed用来获取队列中元素的剩余过期时间。
long getDelay(TimeUnit unit) ： 在给定的时间单元中，返回与此对象关联的剩余延迟.DelayQueue是延迟元素的无界阻塞队列，在该队列中，一个元素只能在过期时被获取。队列的头是延迟元素，其延迟在过去过期最远。如果元素没有过期，就没有head, poll将返回null。当元素的getDelay(timeunit, nanosecond)方法返回一个小于或等于零的值时，就会发生过期，此队列不允许空元素。
二、常用API
【a】构造方法：DelayQueue提供了两个构造方法：
| 创建一个最初为空的新DelayQueue |
| DelayQueue(Collection<? extends E> c) 创建一个DelayQueue，该队列最初包含给定的延迟实例集合的元素 |
【b】常用方法：
| 返回值类型
扫描二维码关注公众号，回复：
9613600 查看本文章
|
方法描述 |
| boolean |
将指定的元素插入此延迟队列 |
| void |
clear() 自动删除此延迟队列中的所有元素 |
| int |
drainTo(Collection<? super E> c) 从该队列中删除所有可用元素，并将它们添加到给定集合中 |
| int |
drainTo(Collection<? super E> c, int maxElements) 从该队列中最多删除给定数量的可用元素，并将它们添加到给定集合中 |
| iterator() 返回此队列中所有元素(过期和未过期)的迭代器。 |
|
| boolean |
将指定的元素插入此延迟队列 |
| boolean |
offer(E e, long timeout, TimeUnit unit) 将指定的元素插入此延迟队列 |
| peek() 检索但不删除此队列的头，或在此队列为空时返回null |
|
| poll() 检索并删除此队列的头，如果此队列没有具有过期延迟的元素，则返回null |
|
| poll(long timeout, TimeUnit unit) 检索并删除此队列的头，如有必要，将一直等待，直到此队列中具有过期延迟的元素可用，或指定的等待时间过期 |
|
| void |
将指定的元素插入此延迟队列 |
| int |
总是返回整数。MAX_VALUE，因为延迟队列没有容量限制 |
| boolean |
从此队列中删除指定元素的单个实例(如果存在)，无论它是否已过期 |
| int |
size() 返回此集合中的元素数 |
| take() 检索并删除此队列的头，如有必要，将一直等待，直到此队列上有一个具有过期延迟的元素可用为止。 |
|
| Object[] |
toArray() 返回一个包含此队列中所有元素的数组 |
| <T> T[] |
toArray(T[] a) 返回一个包含此队列中所有元素的数组;返回数组的运行时类型是指定数组的运行时类型 |
三、示例
下面通过一个简单的示例说明如何使用延迟队列DelayQueue：
public class T04_DelayQueue {
public static void main(String[] args) {
DelayQueue<DelayData> delayQueue = new DelayQueue<>();
//生产者线程
new Thread(() -> {
for (int i = 0; i < 5; i++) {
long currentTime = System.nanoTime();
//返回指定原点(包括)和指定边界(排除)之间的伪随机长值
long validTime = ThreadLocalRandom.current().nextLong(1000000000L, 7000000000L);
DelayData delayData = new DelayData(currentTime + validTime);
delayQueue.put(delayData);
System.out.println(Thread.currentThread().getName() + ": put ->" + delayData);
//模拟延时
try {
TimeUnit.SECONDS.sleep(1);
} catch (InterruptedException e) {
e.printStackTrace();
}
}
}, "生产者").start();
//消费者线程
new Thread(() -> {
for (int i = 0; i < 5; i++) {
try {
System.out.println(Thread.currentThread().getName() + ": take -> " + delayQueue.take());
Thread.yield();
} catch (InterruptedException e) {
e.printStackTrace();
}
}
}, "消费者").start();
}
}
/**
* 队列元素必须实现Delayed接口,重写getDelay和compareTo方法
*/
class DelayData implements Delayed {
/**
* 数据过期时间
*/
private long delayTime;
public DelayData(long delayTime) {
this.delayTime = delayTime;
}
/**
* 返回剩余有效时间
*
* @param unit 时间单位 纳秒
*/
@Override
public long getDelay(TimeUnit unit) {
return unit.convert(this.delayTime - System.nanoTime(), TimeUnit.NANOSECONDS);
}
@Override
public int compareTo(Delayed o) {
if (o == this) {
return 0;
}
if (o instanceof DelayData) {
DelayData x = (DelayData) o;
// 优先比较失效时间
long diff = this.delayTime - x.delayTime;
return diff < 0 ? -1 : diff > 0 ? 1 : 0;
}
long diff = this.getDelay(TimeUnit.NANOSECONDS) - o.getDelay(TimeUnit.NANOSECONDS);
return (diff < 0) ? -1 : (diff > 0) ? 1 : 0;
}
@Override
public String toString() {
return "DelayData{" +
"delayTime=" + delayTime +
'}';
}
}运行结果：
生产者: put ->DelayData{delayTime=178412709161927}
生产者: put ->DelayData{delayTime=178418135952860}
消费者: take -> DelayData{delayTime=178412709161927}
生产者: put ->DelayData{delayTime=178417873829764}
生产者: put ->DelayData{delayTime=178415526587641}
生产者: put ->DelayData{delayTime=178417839279680}
消费者: take -> DelayData{delayTime=178415526587641}
消费者: take -> DelayData{delayTime=178417839279680}
消费者: take -> DelayData{delayTime=178417873829764}
消费者: take -> DelayData{delayTime=178418135952860}从运行结果可以看出，消费者每次获取到的元素都是有效期最小的，且都是已经失效了的。
四、源码阅读
（1）重要属性说明
//可重入锁,保障线程安全
private final transient ReentrantLock lock = new ReentrantLock();
//优先级队列，用于存储元素，并按优先顺序
private final PriorityQueue<E> q = new PriorityQueue<E>();
/**
* 指定为等待队列头部的元素的线程.
*/
private Thread leader = null;
/**
* 用于实现阻塞的Condition对象
* 当一个新的元素在队列的最前面可用时，或者一个新线程需要成为leader时，就会发出条件信号
*/
private final Condition available = lock.newCondition();为了最小化不必要的时间等待，DelayQueue并不会让所有出队线程都无限等待，而是用leader保存了第一个尝试出队的线程，该线程的等待时间是队首元素的剩余有效期。这样，一旦leader线程被唤醒（此时队首元素也失效了），就可以出队成功，然后唤醒一个其它在available条件队列上等待的线程。之后，会重复上一步，新唤醒的线程可能取代成为新的leader线程。这样，就避免了无效的等待，提升了性能。
（2）常用方法说明
【a】offer(E e)、put(E e)、offer(E e, long timeout, TimeUnit unit)、add(E e)
/**
* 将指定的元素插入此延迟队列
*/
public boolean add(E e) {
return offer(e);
}
/**
* 将指定的元素插入此延迟队列
*/
public boolean offer(E e) {
final ReentrantLock lock = this.lock;
lock.lock();
try {
//底层调用优先级队列PriorityQueue的offer方法
q.offer(e);
//如果准备入队的元素在队首, 则唤醒一个出队线程
if (q.peek() == e) {
leader = null;
available.signal();
}
return true;
} finally {
lock.unlock();
}
}
/**
* 将指定的元素插入此延迟队列。因为队列是无界的，所以这个方法永远不会阻塞
*/
public void put(E e) {
offer(e);
}
/**
* 将指定的元素插入此延迟队列。因为队列是无界的，所以这个方法永远不会阻塞
*/
public boolean offer(E e, long timeout, TimeUnit unit) {
return offer(e);
}【b】take()
/**
* 检索并删除此队列的头，如有必要，将一直等待，直到此队列上有一个具有过期延迟的元素可用为止.
*/
public E take() throws InterruptedException {
final ReentrantLock lock = this.lock;
lock.lockInterruptibly();
try {
for (;;) {
//调用PriorityQueue的peek()方法获取队首元素
E first = q.peek();
if (first == null)
//如果队首元素为空,则阻塞当前线程
available.await();
else {
//队首元素不为空,则获取对应的过期时间，单位为纳秒.
long delay = first.getDelay(NANOSECONDS);
//如果过期时间 <= 0,执行出队操作
if (delay <= 0)
return q.poll();
//释放first的引用，避免内存泄漏
first = null;
if (leader != null)
//领导者线程为空,则无限阻塞当前线程
available.await();
else {
//设置领导者线程为新的leader线程
Thread thisThread = Thread.currentThread();
leader = thisThread;
try {
//限时等待当前线程
available.awaitNanos(delay);
} finally {
if (leader == thisThread)
leader = null;
}
}
}
}
} finally {
// 不存在leader线程但队列中存在元素, 说明没有其他线程在等待, 则唤醒一个其它出队线程
if (leader == null && q.peek() != null)
available.signal();
lock.unlock();
}
}【c】poll()、poll(long timeout, TimeUnit unit)
/**
* 检索并删除此队列的头，如果此队列没有具有过期延迟的元素，则返回null
*/
public E poll() {
final ReentrantLock lock = this.lock;
lock.lock();
try {
//调用优先级队列的peek方法出队
E first = q.peek();
//如果队首元素为空或者未过期，则返回null
if (first == null || first.getDelay(NANOSECONDS) > 0)
return null;
else
return q.poll();
} finally {
lock.unlock();
}
}
/**
* 检索并删除此队列的头，如有必要，将等待直到此队列上有一个具有过期延迟的元素可用，或指定的等待时间过期
*/
public E poll(long timeout, TimeUnit unit) throws InterruptedException {
long nanos = unit.toNanos(timeout);
final ReentrantLock lock = this.lock;
lock.lockInterruptibly();
try {
for (;;) {
E first = q.peek();
//队首元素为空
if (first == null) {
if (nanos <= 0)
return null;
else
nanos = available.awaitNanos(nanos);
} else { //队首元素不为空
//获取队首元素的过期时间
long delay = first.getDelay(NANOSECONDS);
//已过期，执行出队操作
if (delay <= 0)
return q.poll();
if (nanos <= 0)
return null;
//置空队首元素
first = null; // don't retain ref while waiting
if (nanos < delay || leader != null)
//限时阻塞等待
nanos = available.awaitNanos(nanos);
else {
//设置领导者线程为新的leader线程
Thread thisThread = Thread.currentThread();
leader = thisThread;
try {
long timeLeft = available.awaitNanos(delay);
nanos -= delay - timeLeft;
} finally {
if (leader == thisThread)
leader = null;
}
}
}
}
} finally {
// 不存在leader线程但队列中存在元素, 说明没有其他线程在等待, 则唤醒一个其它出队线程
if (leader == null && q.peek() != null)
available.signal();
lock.unlock();
}
}五、总结
DelayQueue是阻塞队列中非常有用的一种队列，经常被用于缓存或定时任务等的设计。以上就是关于DelayQueue延时队列的一些介绍和使用总结，如果不对之处，还请大家不吝指正。
