Java BlockingQueue offer()方法及示例
BlockingQueue接口有两种类型的offer()方法:
注 : BlockingQueue 的 offer() 方法已从Java中的 Queue 类继承。
offer(E e, long timeout, TimeUnit unit)
BlockingQueue 的 offer(E e, long timeout, TimeUnit unit) 方法在队列未满时将作为参数传递给方法的元素插入该BlockingQueue的尾部。如果BlockingQueue满了,它将等待指定的时间来获得可用空间。指定的等待时间和时间单位将作为参数提供给offer()方法。因此,它将等待到那个时间,让BlockingQueue删除一些元素,这样这个方法就可以向BlockingQueue添加元素。
语法:
参数: 该方法接受三个参数:
- e – 要插入BlockingQueue中的元素。
- timeout – 如果队列已满,提供方法将等待插入新元素的时间。
- unit – Timeout参数的时间单位。
返回值: 如果插入元素成功,该方法返回 true 。否则,如果在空间可用之前,指定的等待时间已过,则返回 false 。
异常: 该方法抛出以下异常:
- NullPointerException – 如果指定的元素为空。
- InterruptedException – 如果在等待时被打断。
下面的程序说明了BlockingQueue类的offer(E e, long timeout, TimeUnit unit)方法:
程序1:
输出
程序2 :
输出
offer(E e)
BlockingQueue 的 offer(E e) 方法在队列有空间即队列未满的情况下,将作为参数传递的元素e插入该BlockingQueue的尾部。如果队列是满的,那么应用offer()方法就没有效果,因为BlockingQueue会阻止元素的插入。offer()方法在向BlockingQueue添加的操作成功时返回true,如果这个队列是满的则返回false。这个方法比add()方法更好,因为add方法在队列已满时抛出错误,但offer()方法在这种情况下返回false。
语法:
参数: 该方法需要一个强制参数 e ,它是要插入到LinkedBlockingQueue中的元素。
返回值: 如果元素插入成功,该方法返回 true 。
异常: 如果指定的元素是空的,该方法会抛出 NullPointerException。
以下程序说明了BlockingQueue类的offer()方法
程序1:
输出
程序2 :
输出
程序3: 显示由offer()方法抛出的异常
输出
参考资料:
- https://docs.oracle.com/javase/7/docs/api/java/util/concurrent/BlockingQueue.html#offer(E)
- https://docs.oracle.com/javase/7/docs/api/java/util/concurrent/BlockingQueue.html#offer(E, %20long, %20java.util.concurrent.TimeUnit)