Java阻塞队列四组API介绍
Java阻塞队列四组API介绍
通过前面几篇文章的学习，我们已经知道了Java中的队列分为阻塞队列和非阻塞队列以及常用的七个阻塞队列。如下图：
本文来源：凯哥Java(kaigejava)讲解Java并发系列之阻塞队列教程。系列文章，欢迎大家从第一篇文章开始看起。
在查看以上七个队列的API的时候，我们可以很明显的看到以下四组API：
add()/remove()/remove
offer()/poll()/peek()
put/take()
offer(e,time,unit)/poll(time,unit).
分别对应的是，添加元素和移除元素以及检查队首元素。
这四组API各有什么不同呢？凯哥把这四组API看作是人的一生四个阶段，分别是：
少年时期，初生牛犊不怕虎,一言不合就开干，对应的是第一组API：会抛异常的API；
青年时期，吸取各方面的知识，为人处事会圆滑，对应的是第二组API：有返回值，不抛出异常的；
中年时期，三十而立，咬定青山不放松，对应的是第三组API：阻塞，一直等待；
老年时期，看透人生，顺其自然，对应的是第四组API：阻塞，当到了预定的超时时间，退出。
下面我们就来详细讲解这四组API
第一组API，会抛出异常的：一言不合就开干
添加元素：add(e):
当队列未满的时候，向队列中添加元素正常；当队列满的时候，再向队列中添加元素的话，会抛出throw new IllegalStateException("Queue full");异常。
代码演示及运行结果：
源码分析：
从源码中，我们可以看到，调用的是offer(e)方法，在下文中，我们也会讲解到的。如果offer方法返回true的话，就直接返回，否则就抛出：throw new IllegalStateException("Queue full");异常的。
删除元素：remove()
当队列不为空的时候，调用该方法，返回被移除的元素；当队列为空的时候在调用该方法，会抛出异常。
来看看源码：
源码中调用了poll方法，当获取到的对象不为空的时候，返回获取到的对象；如果为空的话，就抛出：throw new NoSuchElementException();异常。
判断当前队列的队首元素：element()
该方法是获取队首元素的。当队列不为空的时候，返回队列中当前队首元素；如果队列为空的时候，调用该方法会抛异常的。
我们来看看源码：
获取队首元素代码演示及运行结果如下图：
第一组API三个方法我们都讲解完了。Add/remove/element方法。最大的特点就是，队列为空或者是队列满了，继续操作队列的话，就会抛出异常。这个凯哥根据就像我们人的一生中少年时期一样，初生牛犊不怕虎，遇到什么不服的或者是不顺心的就暴躁了，碰不得，一碰就爆炸。一言不合就开干！
第二组：带有返回值的，不会抛出异常：为人处事会圆滑了
第二组api的不像第一组那么暴躁如雷了，不想就抛异常。第二组，不会抛出异常了。我们接着来看看：
添加元素：offer(e)
需要主要：这里的offer方法只有一个参数，这个和我们后面讲解的一组的区别
当队列未满的时候，向队列中添加元素，返回true;当队列已经满了，继续向队列中添加元素的话，不会抛出异常，会返回false.
源码分析：
从源码中，我们可以看到，offer(e)的方法中，有个count计数器，每次添加元素后，都会count++。当count的值等于队列的长度的时候，返回false.而不是抛出异常。我们来用代码演示.
Offer(e)添加元素代码演示及运行结果：
删除元素：poll()
注意：参数为空哦！
当队列不为空的时候，返回被移除的元素，当队列为空的时候，返回null.而不是抛出异常。
源码分析：
从源码中，我们将看到count这个计数器又起作用了。先判断count是否==0
如果不等于0，调用dequeue方法，count--，然后将获取到的元素返回；
如果count == 0的话，直接返回null.
源码如下图：
代码演示及运行结果：
获取队首元素：peek()
当队列不为空的时候，返回当前队列的队首元素；如果队列为空的时候，返回null，而不是抛出异常。
源码分析：
在源码中，我们可以看到调用了itemAt(takeIndex)方法。但是在这个方法后面有这么已经注释：null when queue is empty。源码如下图：
代码演示：
从运行的结果，我们可以看到，当移除最后一个元素：kaigejava的时候，获取到的队首元素已经为null了。因为队列为空了，所以，就算后面还有循环，获取到的队首元素依然是null，而不是抛出异常。运行结果如下图：
从第二组API中，我们可以看到，不像第一组那么极端了。当队列为空或者是队列满的时候，返回数据告知对象。这个就像我们人生由少年时代，进入了青年时代，经过学校的洗礼之后，为人处事学会了圆滑了。
接下来，我们就该进入人生第三个阶段：中年时代，我们一起来看看这个阶段的api又是什么样子的
第三组：阻塞，一直等待：三十而立，咬定青山不放松
第三组API，相对于第一组和第二组最大的区别就是：第三组会等待着，如果不被中断，就会等到天荒地老。
添加元素：put(e)
当队列满的时候，进入阻塞等待状态，一直等待，直到可以添加到队列中为止。
需要说明：在阻塞等待过程中，有可能会被中断，所以会抛出中断异常：throws InterruptedException。
我们先来看看源码：
在源码中，我们会看到while循环来判断count的值是否等于队列的长度，如果不等于，就enqueue.然后count++；如果count的值等于队列的长度的是，就调用notFull.await()方法，而notfull是condition对象。在之前的文章学习中，我们知道coditon.await()方法会进入阻塞状态。源码如下图：
代码演示及运行结果：
我们可以看到，当添加第四个元素的时候，队列进入了阻塞状态。如下图：
删除元素：take()
当队列不为空的时候，返回被移除的元素；当队列为空的时候，进入阻塞等待状态。
源码分析：
代码演示：
这一组队列，就像进入中年时期的我们一样，三十而立，要好好工作，努力工作。只要天不塌，地不陷，一直工作着。
第四组：带有等待超时的阻塞API
如果第三组API一直阻塞等待着，你受不了的话，并发大师还为我们准备了第四组API，带有超时时间的
添加元素：offer(e,time,unit)
参数说明：
e：将要被添加到队列中的元素
time：long类型的。预设定的需要等待的时间
unit：TimeUnit.超时时间的单位
来看看源码：
从源码中我们将会看到：
判断count的值是否等于队列的长度
如果不等于，调用enqueue方法，然后count++,返回true.
如果count==队列的长度的时候，判断设置的等待超时时间是否小于等于0
如果等待的时间大于0的话，进入notFull.awaitNanos方法中进行阻塞等待。
在前面文章中，我们详细讲解过condition.awaitNanos这个方法。这里就不再赘述了。
当等待的时间小于等于0的时候，就返回false.
源码如下图：
代码演示：
删除元素：poll(time,unit)
当队列为空的时候，进入阻塞等待，等到超时时间的时候，返回null.退出等待。
代码演示：
第四组API带有等待超时时间，就像是我们人的一生老年时期，看透一切了。一切都是顺其自然了，不再争强好胜了。
总结：
凯哥通过人的一生四个阶段来比喻这四组API是为了让大家更好记忆。接下来，我们来进行总结：
欢迎来聊！~
