Await
Related Doc:
package util
Returns after all actions have completed.
Returns after all actions have completed. The timeout given is passed to each awaitable in turn, meaning max await time will be awaitables.size * timeout.
Await.all(Seq, Duration)
Returns after all actions have completed.
Returns after all actions have completed. The timeout given is passed to each awaitable in turn, meaning max await time will be awaitables.size * timeout.
If any of the Awaitables are not ready within timeout, a
com.twitter.util.TimeoutException will be thrown.
Returns after all actions have completed.
Returns after all actions have completed. The timeout given is passed to each awaitable in turn, meaning max await time will be awaitables.size * timeout.
Is this Awaitable ready? In other words: would calling Awaitable.ready block?
Returns the awaitable object itself when the action has completed.
Returns the awaitable object itself when the action has completed.
Completion of this method merely indicates action completion, regardless
of whether it was successful or not. In order to determine whether the action was
successful, the awaitable must be queried separately. Prefer using
result() when you wish failures to be thrown as exceptions.
If the Awaitable is not ready within timeout, a
com.twitter.util.TimeoutException will be thrown.
Returns the awaitable object itself when the action has completed.
Returns the awaitable object itself when the action has completed.
Completion of this method merely indicates action completion, regardless
of whether it was successful or not. In order to determine whether the action was
successful, the awaitable must be queried separately. Prefer using
result() when you wish failures to be thrown as exceptions.
Waits until the action has completed.
Waits until the action has completed. If the action was successful, returns the result of the action. If the action failed, the corresponding exception representing the failure is thrown.
If you want the results as a com.twitter.util.Try,
use Await.result(future.liftToTry).
If the Awaitable is not ready within timeout, a
com.twitter.util.TimeoutException will be thrown.
Waits until the action has completed.
Waits until the action has completed. If the action was successful, returns the result of the action. If the action failed, the corresponding exception representing the failure is thrown.
If you want the results as a com.twitter.util.Try,
use Await.result(future.liftToTry).
Synchronously await the result of some action by blocking the current thread.
The two main uses of
Awaitare (a) you have synchronous code that needs to wait on some action performed by asynchronous code, or (b) you have synchronous code that needs to wait on some action performed on a thread pool or otherwise a different thread.A common type of
Awaitableis the com.twitter.util.Future.In the context of an event loop (such as when you are on a Finagle thread), never synchronously wait for completion - favoring asynchronous methods such as combinators or callbacks registered on a Future.