com.netflix.servo.util

Class TimeLimiter

java.lang.Object

com.netflix.servo.util.TimeLimiter

public final class TimeLimiter
extends java.lang.Object

Invoke a callable aborting after a certain timout.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TimeLimiter.UncheckedTimeoutException Unchecked version of TimeoutException.

Constructor Summary

Constructors

Constructor and Description
TimeLimiter(java.util.concurrent.ExecutorService executor) Create a new TimeLimiter that will use the provided executor to invoke the Callable.

Method Summary

Modifier and Type	Method and Description
<T> T	callWithTimeout(java.util.concurrent.Callable<T> callable, long duration, java.util.concurrent.TimeUnit unit) Invokes a specified Callable, timing out after the specified time limit.

Methods inherited from class java.lang.Object

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

Constructor Detail

TimeLimiter

public TimeLimiter(java.util.concurrent.ExecutorService executor)

Create a new TimeLimiter that will use the provided executor to invoke the Callable.

Parameters:

executor - ExecutorService used to invoke the callable

Method Detail

callWithTimeout

public <T> T callWithTimeout(java.util.concurrent.Callable<T> callable,
                             long duration,
                             java.util.concurrent.TimeUnit unit)
                      throws java.lang.Exception

Invokes a specified Callable, timing out after the specified time limit. If the target method call finished before the limit is reached, the return value or exception is propagated to the caller exactly as-is. If, on the other hand, the time limit is reached, we attempt to abort the call to the Callable and throw an exception.

Throws:

java.lang.Exception