ch.bind.philib.concurrent

Class SingleFlight

java.lang.Object

ch.bind.philib.concurrent.SingleFlight

public class SingleFlight
extends Object

SingleFlight implements call deduplication for equal keys.

Constructor Summary

Constructors

Constructor and Description
SingleFlight()

Method Summary

Methods

Modifier and Type	Method and Description
<V> V	execute(Object key, Callable<V> callable) Execute a Callable if no other calls for the same key are currently running.

Methods inherited from class java.lang.Object

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

Constructor Detail

SingleFlight

public SingleFlight()

Method Detail

execute

public <V> V execute(Object key,
            Callable<V> callable)
          throws Exception

Execute a Callable if no other calls for the same key are currently running. Concurrent calls for the same key result in one caller invoking the Callable and sharing the result with the other callers.

The result of an invocation is not cached, only concurrent calls share the same result.

Parameters:

key - A unique identification of the method call. The key must be uniquely identifiable by it's Object.hashCode() and Object.equals(Object) methods.

callable - The Callable where the result can be obtained from.

Returns:

The result of invoking the Callable.

Throws:

Exception - The Exception which was thrown by the Callable. Alternatively a InterruptedException can be thrown if the executing Thread was interrupted while waiting for the result.