com.firefly.utils.concurrent

类 CompletableCallback

java.lang.Object

com.firefly.utils.concurrent.CompletableCallback

所有已实现的接口:

Callback

public abstract class CompletableCallback
extends Object
implements Callback

A callback to be used by driver code that needs to know whether the callback has been succeeded or failed (that is, completed) just after the asynchronous operation or not, typically because further processing depends on the callback being completed. The driver code competes with the asynchronous operation to complete the callback.

If the callback is already completed, the driver code continues the processing, otherwise it suspends it. If it is suspended, the callback will be completed some time later, and resume() or abort(Throwable) will be called to allow the application to resume the processing.

Typical usage:

 CompletableCallback callback = new CompletableCallback()
 {
     @Override
     public void resume()
     {
         // continue processing
     }

     @Override
     public void abort(Throwable failure)
     {
         // abort processing
     }
 }
 asyncOperation(callback);
 boolean completed = callback.tryComplete();
 if (completed)
     // suspend processing, async operation not done yet
 else
     // continue processing, async operation already done
 

嵌套类概要

从接口继承的嵌套类/接口 com.firefly.utils.concurrent.Callback

Callback.Completable, Callback.Nested, Callback.NonBlocking

字段概要

从接口继承的字段 com.firefly.utils.concurrent.Callback

NOOP

构造器概要

构造器

构造器和说明
CompletableCallback()

方法概要

限定符和类型	方法和说明
abstract void	abort(Throwable failure) Callback method invoked when this callback is failed.
void	failed(Throwable x) Callback invoked when the operation fails.
abstract void	resume() Callback method invoked when this callback is succeeded after a first call to tryComplete().
void	succeeded() Callback invoked when the operation completes.
boolean	tryComplete() Tries to complete this callback; driver code should call this method once after the asynchronous operation to detect whether the asynchronous operation has already completed or not.

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

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

从接口继承的方法 com.firefly.utils.concurrent.Callback

from, from, isNonBlocking

构造器详细资料

CompletableCallback

public CompletableCallback()

方法详细资料

succeeded

public void succeeded()

从接口复制的说明: Callback

Callback invoked when the operation completes.

指定者:

succeeded 在接口中 Callback

另请参阅:

Callback.failed(Throwable)

failed

public void failed(Throwable x)

从接口复制的说明: Callback

Callback invoked when the operation fails.

指定者:

failed 在接口中 Callback

参数:

x - the reason for the operation failure

resume

public abstract void resume()

Callback method invoked when this callback is succeeded after a first call to tryComplete().

abort

public abstract void abort(Throwable failure)

Callback method invoked when this callback is failed.

参数:

failure - the throwable reprsenting the callback failure

tryComplete

public boolean tryComplete()

Tries to complete this callback; driver code should call this method once after the asynchronous operation to detect whether the asynchronous operation has already completed or not.

返回:

whether the attempt to complete was successful.