Package com.google.common.util.concurrent

Class Uninterruptibles

java.lang.Object

com.google.common.util.concurrent.Uninterruptibles

@GwtCompatible(emulated=true)
public final class Uninterruptibles
extends java.lang.Object

Utilities for treating interruptible operations as uninterruptible. In all cases, if a thread is interrupted during such a call, the call continues to block until the result is available or the timeout elapses, and only then re-interrupts the thread.

Since:

10.0

Constructor Summary

Constructors

Modifier	Constructor	Description
private	Uninterruptibles()

Method Summary

Modifier and Type	Method	Description
static void	awaitUninterruptibly(java.util.concurrent.CountDownLatch latch)	Invokes latch.await() uninterruptibly.
static boolean	awaitUninterruptibly(java.util.concurrent.CountDownLatch latch, long timeout, java.util.concurrent.TimeUnit unit)	Invokes latch.await(timeout, unit) uninterruptibly.
static boolean	awaitUninterruptibly(java.util.concurrent.CountDownLatch latch, java.time.Duration timeout)	Invokes latch.await(timeout, unit) uninterruptibly.
static boolean	awaitUninterruptibly(java.util.concurrent.locks.Condition condition, long timeout, java.util.concurrent.TimeUnit unit)	Invokes condition.await(timeout, unit) uninterruptibly.
static boolean	awaitUninterruptibly(java.util.concurrent.locks.Condition condition, java.time.Duration timeout)	Invokes condition.await(timeout, unit) uninterruptibly.
static <V> V	getUninterruptibly(java.util.concurrent.Future<V> future)	Invokes future.get() uninterruptibly.
static <V> V	getUninterruptibly(java.util.concurrent.Future<V> future, long timeout, java.util.concurrent.TimeUnit unit)	Invokes future.get(timeout, unit) uninterruptibly.
static <V> V	getUninterruptibly(java.util.concurrent.Future<V> future, java.time.Duration timeout)	Invokes future.get(timeout, unit) uninterruptibly.
static void	joinUninterruptibly(java.lang.Thread toJoin)	Invokes toJoin.join() uninterruptibly.
static void	joinUninterruptibly(java.lang.Thread toJoin, long timeout, java.util.concurrent.TimeUnit unit)	Invokes unit.timedJoin(toJoin, timeout) uninterruptibly.
static void	joinUninterruptibly(java.lang.Thread toJoin, java.time.Duration timeout)	Invokes unit.timedJoin(toJoin, timeout) uninterruptibly.
static <E> void	putUninterruptibly(java.util.concurrent.BlockingQueue<E> queue, E element)	Invokes queue.put(element) uninterruptibly.
static void	sleepUninterruptibly(long sleepFor, java.util.concurrent.TimeUnit unit)	Invokes unit.sleep(sleepFor) uninterruptibly.
static void	sleepUninterruptibly(java.time.Duration sleepFor)	Invokes unit.sleep(sleepFor) uninterruptibly.
static <E> E	takeUninterruptibly(java.util.concurrent.BlockingQueue<E> queue)	Invokes queue.take() uninterruptibly.
static boolean	tryAcquireUninterruptibly(java.util.concurrent.Semaphore semaphore, int permits, long timeout, java.util.concurrent.TimeUnit unit)	Invokes semaphore.tryAcquire(permits, timeout, unit) uninterruptibly.
static boolean	tryAcquireUninterruptibly(java.util.concurrent.Semaphore semaphore, int permits, java.time.Duration timeout)	Invokes semaphore.tryAcquire(permits, timeout, unit) uninterruptibly.
static boolean	tryAcquireUninterruptibly(java.util.concurrent.Semaphore semaphore, long timeout, java.util.concurrent.TimeUnit unit)	Invokes semaphore.tryAcquire(1, timeout, unit) uninterruptibly.
static boolean	tryAcquireUninterruptibly(java.util.concurrent.Semaphore semaphore, java.time.Duration timeout)	Invokes semaphore.tryAcquire(1, timeout, unit) uninterruptibly.

Methods inherited from class java.lang.Object

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

Constructor Detail

Uninterruptibles

private Uninterruptibles()

Method Detail

awaitUninterruptibly

@GwtIncompatible
public static void awaitUninterruptibly(java.util.concurrent.CountDownLatch latch)

Invokes latch.await() uninterruptibly.

awaitUninterruptibly

@GwtIncompatible
@Beta
public static boolean awaitUninterruptibly(java.util.concurrent.CountDownLatch latch,
                                           java.time.Duration timeout)

Invokes latch.await(timeout, unit) uninterruptibly.

Since:

28.0

awaitUninterruptibly

@GwtIncompatible
public static boolean awaitUninterruptibly(java.util.concurrent.CountDownLatch latch,
                                           long timeout,
                                           java.util.concurrent.TimeUnit unit)

Invokes latch.await(timeout, unit) uninterruptibly.

awaitUninterruptibly

@GwtIncompatible
@Beta
public static boolean awaitUninterruptibly(java.util.concurrent.locks.Condition condition,
                                           java.time.Duration timeout)

Invokes condition.await(timeout, unit) uninterruptibly.

Since:

28.0

awaitUninterruptibly

@GwtIncompatible
public static boolean awaitUninterruptibly(java.util.concurrent.locks.Condition condition,
                                           long timeout,
                                           java.util.concurrent.TimeUnit unit)

Invokes condition.await(timeout, unit) uninterruptibly.

Since:

23.6

joinUninterruptibly

@GwtIncompatible
public static void joinUninterruptibly(java.lang.Thread toJoin)

Invokes toJoin.join() uninterruptibly.

joinUninterruptibly

@GwtIncompatible
@Beta
public static void joinUninterruptibly(java.lang.Thread toJoin,
                                       java.time.Duration timeout)

Invokes unit.timedJoin(toJoin, timeout) uninterruptibly.

Since:

28.0

joinUninterruptibly

@GwtIncompatible
public static void joinUninterruptibly(java.lang.Thread toJoin,
                                       long timeout,
                                       java.util.concurrent.TimeUnit unit)

Invokes unit.timedJoin(toJoin, timeout) uninterruptibly.

getUninterruptibly

public static <V> V getUninterruptibly(java.util.concurrent.Future<V> future)
                                throws java.util.concurrent.ExecutionException

Invokes future.get() uninterruptibly.

Similar methods:

• To retrieve a result from a Future that is already done, use Futures.getDone.
• To treat InterruptedException uniformly with other exceptions, use Futures.getChecked.
• To get uninterruptibility and remove checked exceptions, use Futures.getUnchecked(java.util.concurrent.Future<V>).

Throws:

java.util.concurrent.ExecutionException - if the computation threw an exception

java.util.concurrent.CancellationException - if the computation was cancelled

getUninterruptibly

@GwtIncompatible
@Beta
public static <V> V getUninterruptibly(java.util.concurrent.Future<V> future,
                                       java.time.Duration timeout)
                                throws java.util.concurrent.ExecutionException,
                                       java.util.concurrent.TimeoutException

Invokes future.get(timeout, unit) uninterruptibly.

Similar methods:

• To retrieve a result from a Future that is already done, use Futures.getDone.
• To treat InterruptedException uniformly with other exceptions, use Futures.getChecked.
• To get uninterruptibility and remove checked exceptions, use Futures.getUnchecked(java.util.concurrent.Future<V>).

Throws:

java.util.concurrent.ExecutionException - if the computation threw an exception

java.util.concurrent.CancellationException - if the computation was cancelled

java.util.concurrent.TimeoutException - if the wait timed out

Since:

28.0

getUninterruptibly

@GwtIncompatible
public static <V> V getUninterruptibly(java.util.concurrent.Future<V> future,
                                       long timeout,
                                       java.util.concurrent.TimeUnit unit)
                                throws java.util.concurrent.ExecutionException,
                                       java.util.concurrent.TimeoutException

Invokes future.get(timeout, unit) uninterruptibly.

Similar methods:

• To retrieve a result from a Future that is already done, use Futures.getDone.
• To treat InterruptedException uniformly with other exceptions, use Futures.getChecked.
• To get uninterruptibility and remove checked exceptions, use Futures.getUnchecked(java.util.concurrent.Future<V>).

Throws:

java.util.concurrent.ExecutionException - if the computation threw an exception

java.util.concurrent.CancellationException - if the computation was cancelled

java.util.concurrent.TimeoutException - if the wait timed out

takeUninterruptibly

@GwtIncompatible
public static <E> E takeUninterruptibly(java.util.concurrent.BlockingQueue<E> queue)

Invokes queue.take() uninterruptibly.

putUninterruptibly

@GwtIncompatible
public static <E> void putUninterruptibly(java.util.concurrent.BlockingQueue<E> queue,
                                          E element)

Invokes queue.put(element) uninterruptibly.

Throws:

java.lang.ClassCastException - if the class of the specified element prevents it from being added to the given queue

java.lang.IllegalArgumentException - if some property of the specified element prevents it from being added to the given queue

sleepUninterruptibly

@GwtIncompatible
@Beta
public static void sleepUninterruptibly(java.time.Duration sleepFor)

Invokes unit.sleep(sleepFor) uninterruptibly.

Since:

28.0

sleepUninterruptibly

@GwtIncompatible
public static void sleepUninterruptibly(long sleepFor,
                                        java.util.concurrent.TimeUnit unit)

Invokes unit.sleep(sleepFor) uninterruptibly.

tryAcquireUninterruptibly

@GwtIncompatible
@Beta
public static boolean tryAcquireUninterruptibly(java.util.concurrent.Semaphore semaphore,
                                                java.time.Duration timeout)

Invokes semaphore.tryAcquire(1, timeout, unit) uninterruptibly.

Since:

28.0

tryAcquireUninterruptibly

@GwtIncompatible
public static boolean tryAcquireUninterruptibly(java.util.concurrent.Semaphore semaphore,
                                                long timeout,
                                                java.util.concurrent.TimeUnit unit)

Invokes semaphore.tryAcquire(1, timeout, unit) uninterruptibly.

Since:

18.0

tryAcquireUninterruptibly

@GwtIncompatible
@Beta
public static boolean tryAcquireUninterruptibly(java.util.concurrent.Semaphore semaphore,
                                                int permits,
                                                java.time.Duration timeout)

Invokes semaphore.tryAcquire(permits, timeout, unit) uninterruptibly.

Since:

28.0

tryAcquireUninterruptibly

@GwtIncompatible
public static boolean tryAcquireUninterruptibly(java.util.concurrent.Semaphore semaphore,
                                                int permits,
                                                long timeout,
                                                java.util.concurrent.TimeUnit unit)

Invokes semaphore.tryAcquire(permits, timeout, unit) uninterruptibly.

Since:

18.0