com.alipay.sofa.registry.concurrent

类 SingleFlight

java.lang.Object

com.alipay.sofa.registry.concurrent.SingleFlight

public class SingleFlight
extends Object

SingleFlight implements call deduplication for equal keys.

Example:

 public Result expensiveOperation(final Parameters parameters) throws Exception {
     return singleFlight.execute(parameters, new Callable<Result>() {
         @Override
         public Result call() {
             return expensiveOperationImpl(parameters);
         }
     });
 }

 private Result expensiveOperationImpl(Parameters parameters) {
     // the real implementation
 }
 

构造器概要

构造器

构造器和说明
SingleFlight()

方法概要

限定符和类型	方法和说明
<V> V	execute(Object key, Callable<V> callable) Execute a Callable if no other calls for the same key are currently running.

从类继承的方法 java.lang.Object

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

构造器详细资料

SingleFlight

public SingleFlight()

方法详细资料

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.

参数:

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.

key - Object

callable - Callable

返回:

The result of invoking the Callable.

抛出:

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.